Elbuz відбирає товари у вивантаження за умовами шаблону в кожному прогоні, а кнопка «Перевірити» на конкретному товарі показує, пройде він у файл чи ні.
Коли це знадобиться:
- Товар є в каталозі, а у файлі його немає — пробний прогін назве, що його відсікає: фільтр, категорія, наявність чи правила.
- На майданчик має їхати тільки частина каталогу — категорії, бренди, постачальники й умови по полях зберігаються в шаблоні.
- Файл вийшов порожнім — журнал окремим рядком скаже, якщо винен обраний магазин без товарів.
- Кілька магазинів з одного каталогу — поле «ID магазину» лишає у файлі тільки товари цього магазину.
З чого почати: картка шаблону → вкладка «Обмеження вивантаження (фільтр)».
Що вміє відбір товарів
- Умови шаблону — категорії, виробники, контрагенти й «Додатковий фільтр» зберігаються в шаблоні й діють у кожному прогоні.
- Одинадцять умов — таблиця в тому порядку, у якому умови відсікають товар.
- Перевірка на товарі — кнопка «Перевірити» показує фрагмент файла або причину відмови.
- Порожній файл — три налаштування, через які у файл не йде нічого.
- Що не відсіює — ціна, фото й опис товар із файла не прибирають.
Де це і хто має доступ
- Меню
- Довідники → Операції → Вивантаження даних → картка шаблону
- Інші входи
- кнопка-колба «Перевірити» в шапці картки шаблону
- Право доступу
- вікно «Детальне налаштування шаблону вивантаження»; воно ж діє на «Перевірити»
- Підготувати
- прапор «Вивантажувати у файл (на сайт)» у товарів і категорій
Де задається відбір товарів
Умови відбору живуть у картці шаблону, на вкладці «Обмеження вивантаження (фільтр)». Панель «Встановити фільтр за:» дає чотири інструменти.
- «категоріям» — вибір категорій, які беруть участь саме в цьому вивантаженні. Кнопка показує лічильник обраного, а меню під нею пропонує два режими вибору: «категорії у вигляді дерева» і «категорії у вигляді списку».
- «виробникам» — обмежити вивантаження конкретними брендами.
- «контрагентам» — обмежити постачальниками, від яких прийшли товари.
- «Додатковий фільтр» — конструктор умов по полях сітки товарів: ціна, статус наявності, залишок, дата, будь-яке поле каталогу й атрибути товарів. Під конструктором програма переказує зібрані умови людською мовою, а кнопки «Скинути» і «Зберегти» — там же.
1
Кнопка «категоріям» з лічильником вибраного2
Конструктор «Додатковий фільтр»3
Рядок з переказом умов людською мовою- Кнопка «категоріям» показує, скільки категорій обрано для вивантаження — тут 152.
- Конструктор «Додатковий фільтр» містить три вже заповнені умови: активність, наявність фото і статус наявності.
- Унизу програма переказує умови звичайною мовою: «Активність = так ТА Фото (прапор наявності) = так ТА Статус наявності = В наличии».
Фільтр шаблону — не те саме, що відбір у каталозі. Відбір у каталозі показує рядки тут і зараз; умови шаблону зберігаються і діють при кожному прогоні, у тому числі нічному. Саме тому цифра «Всього» в каталозі й цифра у зведенні шаблону можуть відрізнятися в рази: шаблон додає до ваших умов ще й обовʼязковий прапор вивантаження та обовʼязкову вивантажувану категорію.
У шаблоні «Прайс-лист (XLSX, CSV)» вкладок фільтра дві — «Товари базового каталогу» і «Товари з прайс-листів». Друга відбирає рядки прайсів постачальників і працює тільки в цьому типі; вона розібрана в окремій статті про прайс-лист для клієнта.
Чому товар не поїхав у файл
Це найчастіше питання теми. Відповідь майже завжди в одному з одинадцяти місць: програма збирає товари одним запитом, і кожна умова відсікає частину каталогу. Достатньо однієї, щоб товар зник із файла — мовчки, без повідомлення.
Умови перелічені в тому порядку, у якому вони накладаються. Перші чотири діють у файлових форматах і у фідах завжди. Решта працює тільки тоді, коли ви щось задали самі: обрали категорії, написали фільтр, зняли галочку, обрали магазин, склад або мову.
У вивантаженні на власний сайт через Elbuz Tunnel набір умов свій — там, наприклад, вимкнена категорія товар із вивантаження не прибирає, а гасить його на сайті (відбір у тунелі).
| № | Умова | Де вмикається і як перевірити |
|---|---|---|
| 1 | У товара знято прапор «Вивантажувати у файл (на сайт)» | Однойменна колонка в сітці каталогу: галочка правиться прямо в комірці. У картці товару той самий перемикач підписано інакше — «Вивантаження у файл, на сайт» |
| 2 | У товара немає опису мовою вивантаження | Мова задається полем «ID мови» у секції «Обмеження вивантаження» картки шаблону. Порожнє поле означає основну мову каталогу — ту, що позначена мовою за замовчуванням у налаштуваннях, а не ту, якою ви бачите інтерфейс. Якщо каталог веде дві мови, задавайте мову вивантаження явно: інакше на майданчик поїдуть тексти мовою за замовчуванням |
| 3 | Товар не лежить у жодній категорії | Картка товару. Товар «поза деревом» не потрапляє в жодне вивантаження |
| 4 | Усі категорії товара вимкнені або в них знято «Прапор: вивантажувати» | Сітка категорій, колонки «Активність» і «Прапор: вивантажувати»; у картці категорії той самий перемикач підписано «Вивантажувати у файл, на сайт». Товар, що лежить у кількох категоріях, поїде, якщо хоч одна з них активна й вивантажується |
| 5 | У шаблоні обрано категорії, і категорії товара серед них немає | Вкладка «Обмеження вивантаження (фільтр)», кнопка «категоріям» — лічильник біля неї показує, скільки обрано |
| 6 | Товар не проходить умови «Додаткового фільтра» | Та сама вкладка. У нового шаблону там уже стоїть «Активність = так» |
| 7 | Знято галочку «Опції» — товари-опції відкидаються | Секція «Що вивантажувати». Правило діє у YML-фідах; у Google-фіді товари-опції їдуть незалежно від галочки |
| 8 | Увімкнено «Вивантажувати лише нові дані», і товар уже вивантажувався | Секція «Що вивантажувати». Прапор «уже вивантажено» один на товар, а не на шаблон, — див. врізку нижче |
| 9 | У шаблоні обрано «ID магазину», а товар до цього магазину не віднесено | Секція «Обмеження вивантаження»; у формі прямих зʼєднань за API поле підписано просто «Магазин». Найтихіша причина порожнього файла — див. врізку нижче |
| 10 | Увімкнено «Лише в наявності в цьому магазині», а по магазину нема ні залишку, ні статусу «В наявності» | Галочка поруч із «ID магазину». Залишки за магазинами зберігаються окремо від товара, звичайним фільтром їх не відібрати |
| 11 | Обрано «ID складу», а товара там немає або залишок нульовий | Секція «Обмеження вивантаження» |
У демо-акаунті до цього додається жорсткий ліміт: у файл потрапляють перші 100 товарів, і в журналі про це пишеться окремим рядком.
Ще дві причини, які в таблицю не вкладаються, бо стосуються не окремого товару:
- у секції «Що вивантажувати» знято галочку «Товари» — тоді вибірки товарів не буде взагалі, і у файл піде лише шапка з категоріями;
- у фіді prom.ua головний товар сімʼї з опціями не їде — замість нього їдуть самі опції. Так зроблено під вимоги майданчика.
У прайс-листі XLSX/CSV і в прямих зʼєднаннях за API є ще одна умова, якої немає у фідах: категорія повинна мати назву мовою вивантаження. Категорія без перекладу вирізає з файла всі свої товари. У XML- і Google-фідах така категорія просто їде без назви.
А з пунктом 2 у прямих зʼєднаннях за API навпаки: товар без опису потрібною мовою не відкидається — він поїде на майданчик із порожньою назвою. Поля «ID мови» у формах API і prom.ua немає взагалі, там завжди береться основна мова каталогу.
Як перевірити конкретний товар
Не перебирайте одинадцять пунктів руками — запитайте програму. У шапці картки шаблону є кнопка-колба «Перевірити» з підказкою «Пробне вивантаження одного товару: показати результат і знайдені помилки». Впишіть «ID товару» — і отримаєте або готовий фрагмент файла саме для цього товара, або пряму відповідь: «Товар #123 не потрапив у вивантаження: він не проходить умови цього шаблону (фільтр, категорія, наявність, правила).»
Поле ID можна лишити порожнім, тоді візьметься перший товар, що підходить під умови. Якщо не підійшов жодний, програма скаже про це окремо. Пробний прогін нічого не надсилає й не переписує ваш робочий файл. Він доступний для XML-фідів, Google-фідів, прайс-листа XLSX/CSV, prom.ua, 1С і прямих зʼєднань за API; для Elbuz Tunnel відповідь буде «Для цього формату шаблону перевірка поки недоступна».
Для одного товару швидше спитати AI. У картці товару натисніть «✦ AI» → «Як товар піде у вивантаження»: консультант прожене шаблон на цьому товарі й покаже порожні або нульові поля разом із причиною.
Для цілої категорії є підказка «Як категорія йде у вивантаження» в картці категорії: вона показує, з якими категоріями маркетплейсів категорію зіставлено і в які шаблони вона потрапляє. Докладно — у статті про AI-консультанта.
Чому файл порожній, хоча товари в каталозі є
Обрано магазин, а склад магазину порожній. Тоді у файл не потрапляє нічого, і зовні це виглядає як зламане вивантаження. Програма пише в журнал окремий червоний рядок: «Магазин «‹назва›» обрано в налаштуваннях, але до нього не віднесено жодного товару — вивантажувати нічого. Склад магазину задається в картці товару (блок «Магазини») або при створенні категорій усередині гілки магазину.»
Склад заповнений тільки в магазинів, заведених руками, — в основного магазину його зазвичай немає взагалі. Якщо ви не поділяєте каталог між магазинами, лишіть поле «ID магазину» порожнім: тоді вивантажується весь каталог. Зведення магазин шаблону враховує, тож у діалозі перед запуском буде 0 товарів.
Обраний у шаблоні магазин видалили. Тоді шаблон не перемикається сам на весь каталог: журнал пише червоний рядок «Магазин (ID ‹N›), обраний у налаштуваннях шаблону, видалено — вивантажувати нічого. Оберіть магазин у шаблоні або зніміть вибір, щоб вивантажувати весь каталог.» Далі все залежить від типу шаблону:
- XML- і Google-фід та прайс-лист XLSX/CSV нічого не вивантажують і закінчуються рядком «Вивантаження даних НЕ завершено: файл не сформовано», а на посиланні лишається минулий файл;
- прайс-лист у режимі «Вивантажувати рядки з категоріями, нижче товари + угруповання» і шаблони prom.ua та 1С відпрацьовують до кінця й кладуть на посилання файл без жодного товару;
- вивантаження на власний сайт через Elbuz Tunnel і прямі зʼєднання за API в такому разі не виконуються взагалі.
Щоб шаблон знову працював, оберіть у ньому інший магазин або зніміть вибір.
«Вивантажувати лише нові дані» у двох шаблонах одразу. Наприкінці прогону з цією галочкою програма позначає як уже вивантажені ті товари, що потрапили у файл цього прогону. Позначка одна на товар, а галочка — своя в кожного шаблону. Тому товари, які забрав перший шаблон, до другого шаблону з такою самою галочкою вже не потраплять.
Якщо другому не лишилося жодного товару, файл не формується: на посиланні лишається минулий файл, а журнал закінчується рядком «Вивантаження даних НЕ завершено: файл не сформовано». У Google-фіді ця галочка не діє зовсім. Тримайте її не більше ніж в одному шаблоні.
Що на відбір не впливає
Ціна, фото, характеристики, опис і штрихкод відбір не звужують. Товар без ціни й без фото поїде у файл так само, як повний, — програма порахує його окремо і покаже цифру в зведенні, але не відкине. Відхилить його вже майданчик, і дізнаєтеся ви про це від майданчика.
Статус наявності сам собою теж не відбирає: «немає в наявності» їде у файл, якщо ви не заборонили це умовами шаблону. Яку кількість і яку активність побачить приймач, вирішує таблиця «Налаштування наявності товару».
Сценарії
Окремий магазин — лише свої товари
Що налаштувати: у секції «Обмеження вивантаження» картки шаблону оберіть «ID магазину». Якщо потрібні тільки товари, які цей магазин може продати зараз, увімкніть «Лише в наявності в цьому магазині».
Що вийде: у файл підуть товари, віднесені до цього магазину. З галочкою — ще й лише ті, у яких по магазину статус наявності означає «в наявності» або залишок більший за нуль. Журнал напише «Відбір за магазином «‹назва›»: до нього віднесено ‹N› товарів із ‹M› у каталозі».
Чого не станеться: порожній магазин сам по собі прогін не зупинить. Зведення перед запуском покаже нуль, а стоп-правило «вивантажувати нічого» за замовчуванням лише попереджає. Що тоді буде з файлом, залежить від типу шаблону — див. чому файл порожній.
Каталог веде дві мови, а майданчику потрібна одна
Що налаштувати: у секції «Обмеження вивантаження» картки шаблону впишіть у поле «ID мови» потрібну мову.
Що вийде: у файл поїдуть назви й описи цією мовою. Товари без опису нею у файл не потраплять — у таблиці умов це пункт 2. Чого не станеться: у формах прямих зʼєднань за API і prom.ua поля «ID мови» немає, там завжди береться основна мова каталогу.
У YML-фід мають іти тільки звичайні товари, без варіантів
Що налаштувати: у секції «Що вивантажувати» зніміть галочку «Опції».
Що вийде: товари-опції у фід не підуть, і зведення перед запуском їх теж не рахуватиме. Чого не станеться: у Google-фіді галочка не діє — товари-опції туди їдуть завжди.
Що робити, коли товару немає у файлі
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Під умови цього шаблону не підійшов жоден товар — вивантажувати нічого» | Пробний прогін не знайшов жодного товару під умови шаблону | Пройдіть таблицю умов згори вниз — найчастіше це прапор товару, категорія або обраний магазин (чому товар не поїхав) |
| «Товар #123 не потрапив у вивантаження: він не проходить умови цього шаблону (фільтр, категорія, наявність, правила).» | Ви вказали ID товару в перевірці, і його відсікає одна з умов | Перевірте цей товар по пунктах 1–11: прапор, опис мовою вивантаження, категорія, фільтр (чому товар не поїхав) |
| «Магазин «‹назва›» обрано в налаштуваннях, але до нього не віднесено жодного товару — вивантажувати нічого.» | У полі «ID магазину» обрано магазин, склад якого не заповнено | Приберіть вибір магазину або наповніть склад магазину в картках товарів (про пастку з магазином) |
Часті запитання
Товар є в каталозі, а у файлі його немає. Де шукати?
Відкрийте картку шаблону, натисніть «Перевірити» і впишіть ID товару. Програма покаже фрагмент файла або відповість, що товар не проходить умови шаблону. Далі перевіряйте по таблиці умов: прапор товару, опис мовою вивантаження, категорія, фільтр.
Файл вийшов порожній, помилок у журналі немає. З чого почати?
Перевірте три речі: чи не обрано в «ID магазину» магазин із порожнім складом, чи не стоїть «Вивантажувати лише нові дані» ще в одному шаблоні і чи не відсікає все «Додатковий фільтр» (чому файл порожній).
Чи поїде у файл вимкнений товар?
Ні, поки в «Додатковому фільтрі» стоїть «Активність = так» — у нового шаблону ця умова є одразу. Приберете її — поїдуть і вимкнені товари. В Elbuz Tunnel цієї умови немає: вимкнений товар їде на сайт і гасне там.
Чому в каталозі під тим самим фільтром товарів більше, ніж у зведенні шаблону?
Шаблон додає до ваших умов обовʼязковий прапор вивантаження товару й обовʼязкову вивантажувану категорію. Відбір у каталозі їх не враховує, тому цифри можуть відрізнятися в рази.
Товар лежить у кількох категоріях, і одна з них вимкнена. Він поїде?
Так, якщо хоч одна з його категорій активна й має «Прапор: вивантажувати». Не поїде лише товар, у якого всі категорії вимкнені або не вивантажуються.
Чи можна відібрати товари за залишком у конкретному магазині?
Так: оберіть «ID магазину» й увімкніть «Лише в наявності в цьому магазині». Звичайним фільтром цього не зробити — залишки за магазинами зберігаються окремо від товару.
Суміжні теми
- Якщо потрібна загальна картина вивантаження — Як налаштувати вивантаження товарів.
- Якщо товар у файлі, але ціна чи опис не ті — Яка ціна й опис підуть у вивантаження.
- Якщо треба побачити кількість товарів ще до запуску — Як перевірити вивантаження перед запуском.
- Якщо відбираєте товари за магазином — Магазини: як наповнюється склад магазину.