Вивантаження товарів на маркетплейс, сайт і у файл

28 хв

Розмова з підтримкою — замість читати: навіщо це потрібно, що налаштувати і що ви отримаєте.

Вивантаження товарів на маркетплейс, у прайс-файл для клієнта або на власний сайт налаштовується один раз — шаблоном. Шаблон відповідає на три питання: куди відправляти, у якому форматі і які саме товари взяти з вашого каталогу. Далі його запускають кнопкою або за розкладом, і на приймач їде свіжий набір товарів із цінами та наявністю.

Нижче — увесь шлях від створення шаблону до готового файла і головне питання цієї теми: чому конкретний товар у файл не потрапив.

Вікно
«Вивантаження даних»
Право доступу
доступ до вікна; у формах Elbuz і прямих зʼєднань за API окремі блоки блокують галочки «Що вивантажувати»
Підготувати
заповнений базовий каталог: у товарів прапор «Вивантажувати у файл (на сайт)», у категорій — «Прапор: вивантажувати»

Маршрут задачі

  1. Створити шаблон і обрати тип приймачаВивантаження даних
  2. Задати умови відбору товарівКартка шаблону, вкладка «Обмеження вивантаження (фільтр)»
  3. Перевірити пороги стоп-правилСтоп-правила вивантаження
  4. Звірити цифри у зведенні й запуститиСписок шаблонів, діалог «Що буде вивантажено»
  5. Подивитися результатЖурнал прогону, далі «Історія запусків»

Де це у програмі

Меню
Довідники → Операції → Вивантаження даних
Робочий стіл
ярлик «Вивантаження»
Картка шаблону
виділити рядок списку → кнопка-олівець у тулбарі; або кнопка-олівець, що зʼявляється на рядку при наведенні. Заголовок вікна — «Додаткове налаштування ‹назва шаблону›»
Стоп-правила
бургер-меню списку → «Стоп-правила вивантаження»

У меню сусіднім пунктом стоїть «Завантаження даних» — це протилежний напрямок: звідти дані приходять із майданчиків до вас. Вивантаження відправляє ваш каталог назовні. Пункти схожі за назвою і лежать поруч, тому переплутати їх легко.

Заголовок самого вікна довший за пункт меню — «Вивантаження категорій, товарів, виробників». Це те саме вікно; далі в статті ми називаємо його так, як воно підписане в меню.

Режим «Зупинитививантаження»Режим «Попереджати»або в межах порогаБазовий каталог: товари зпрапором «Вивантажуватиу файл (на сайт)»Категорії з прапором«Прапор: вивантажувати»Умови відбору шаблону:категорії, виробники,контрагенти, «Додатковийфільтр»Передпольотне зведення:скільки товарів піде і зякою наявністюСтоп-правила: розбіжністьіз минулим прогономбільша за поріг?Прогін зупинено, старийфайл лишається на місціФормування за шаблоном:поля, формули, курсвалютФайл у теці вашогоакаунтаПосилання на файлколонка «Файл» у спискуFTP-сервер, якщозаповнено«Налаштування FTP»Лист із вкладеннямлише у типі «Прайс-лист(XLSX, CSV)»Пряме зʼєднання: данійдуть в API майданчикабез файлаМайданчик забирає фід запосиланням за власнимрозкладом
Шлях товару з базового каталогу у файл і далі на приймач

Що таке шаблон вивантаження

— це один канал збуту. Rozetka, Google Merchant, прайс для оптового клієнта і власний сайт — це чотири шаблони, у кожного свої умови відбору, свій формат і свій розклад. По нашому парку акаунтів у середнього магазину таких каналів шість.

Список шаблонів — це і є вміст вікна. Над сіткою — смуга з пʼятьма числами:

  • «Шаблонів» — скільки їх усього;
  • «Активних» — скільки увімкнено;
  • «Виконується» — скільки вивантажується просто зараз;
  • «Останнє вивантаження» — коли востаннє відпрацював будь-який шаблон;
  • «Давно не вивантажувались» — активні шаблони, які не запускалися понад сім днів. Це найкорисніше число смуги: воно ловить канал, який тихо відвалився.

У сітці на кожен шаблон один рядок. Колонка «Стан» показує пілюлю «Активний», «Вимкнений» або «Виконується», і клік по ній перемикає стан. Колонка «Файл» — посилання на останній сформований файл і кнопка «Копіювати посилання»: саме це посилання ви даєте майданчику. Колонка «Останнє вивантаження» показує «сьогодні», «вчора», «%d дн. тому» або «ще не вивантажувався», а поруч — скільки тривав прогін і скільки важив файл. Колонка «Примітка» редагується прямо в сітці — туди пишуть, для кого цей канал. Колонка «Порядок обробки» задає порядок у списку й порядок масового прогону.

Вікно «Вивантаження»: перелік шаблонів експорту зі статистикою та станом кожного шаблону
1Давно не вивантажувались
2Колонка «Стан»
3Колонка «Файл»
4Колонка «Останнє»
5Кнопка «Додати»
  1. Число показує, скільки шаблонів давно не вивантажувалися.
  2. Пілюля стану показує, чи увімкнений шаблон вивантаження.
  3. Посилання у колонці «Файл» веде на останній згенерований файл.
  4. Колонка «Останнє» показує, коли і за скільки часу пройшло останнє вивантаження.
  5. Кнопка «Додати» відкриває меню вибору типу нового шаблону.

Дата в колонці «Останнє вивантаження» — це справді про вивантаження: вона змінюється тільки прогоном, а збереження налаштувань її не чіпає.

Файл їде на майданчик цілком. Помилка в умовах відбору або в тому, яке поле взято за ціну, вивозить на площадку весь асортимент — а повертається це штрафом майданчика або продажем нижче собівартості. Тому перед першою відправкою:

  • Натисніть «Перевірити» в картці шаблону. Пробний прогін шукає товар тими самими умовами, що й справжній, показує готовий фрагмент файла і нічого нікуди не надсилає — ні на майданчик, ні в робочий файл. Це єдина перевірка, яка бачить усі умови відбору (як перевірити товар).
  • Перевірте чип «Без ціни» у зведенні. Товар із нульовою ціною поїде у файл — вивантаження його не відкидає (про ціну).
  • Запускайте перший прогін зі списку шаблонів, а не з картки. Тільки зі списку відкривається зведення; кнопка «Вивантажити» в шапці картки відправляє одразу (про запуск).
  • Не покладайтеся на головне число зведення як на факт. Воно показує стелю відбору: магазину, складу, мови опису й галочки «Вивантажувати лише нові дані» зведення не враховує (межі зведення).
  • Після першого прогону відкрийте журнал і сам файл. У журналі XML-фіда є рядок «Вивантаження товарів ‹N› із ‹M›» — це вже факт, а не прогноз (про журнал).

Якщо жодного шаблону ще немає, вікно показує напис «Шаблонів вивантаження поки немає» і пояснення: «Створіть перший шаблон — і товари будуть автоматично вивантажуватись на маркетплейси, у прайс-листи та рекламні кабінети.»

Який тип приймача обрати

Кнопка «Додати» відкриває меню типів, згруповане за форматом доставки даних. Груп шість:

Група в менюЩо це
«Файл прайс-листа»Прайс-лист (XLSX, CSV) і prom.ua у форматі XLS — таблиця з обраними колонками
«XML-фід (YML)»Загальний YML і фіди майданчиків: Rozetka, Prom, Hotline, Epicentr, Kaspi.kz, Kasta та інші
«Google-фід (XML)»Google Merchant, Facebook, TikTok
«Пряме зʼєднання через API»Хорошоп, Shopify, Wix, eBay, Amazon, Allegro, eMAG, WooCommerce, Kaufland, OLX, Etsy, TikTok Shop, Rozetka
«1С (CommerceML2)»Обмін із 1С
«Elbuz»Свій сайт через модуль Elbuz Tunnel
Розкрите меню типів приймачів при додаванні шаблону
1Група «XML-фід (YML)»
2Група «Пряме з'єднання через API»
3Пункт із логотипом майданчика
  1. Група «XML-фід (YML)» об'єднує майданчики з фідом у форматі YML.
  2. Група «Пряме з'єднання через API» — інтеграції без проміжного файлу.
  3. Кожен пункт меню показує логотип сервісу, наприклад Google Merchant (XML).

Один і той самий майданчик буває у двох групах, і це не помилка. Rozetka лежить у «XML-фід (YML)», а пряме зʼєднання з кабінетом продавця Rozetka — у «Пряме зʼєднання через API». Різниця принципова: фід створює картки товарів, і майданчик забирає його сам за посиланням; пряме зʼєднання оновлює ціни та залишки вже заведених карток і робить це відразу, без файла. Те саме з TikTok: фід у групі Google і TikTok Shop у групі API.

Типи, вимкнені в класифікаторі, у меню не показуються — завести на них новий шаблон не можна, навіть якщо старий шаблон такого типу в акаунті лишився.

Що програма робить одразу після створення

Верхня частина вікна «Додаткове налаштування Google (укр)»
1Пілюля стану «Вимкнений»
2Кнопка-колба «Перевірити»
3Кнопка «Вивантажити»
4Секція «Що вивантажувати»
5Вкладка «Обмеження вивантаження (фільтр)»
  1. Пілюля стану показує, увімкнений шаблон чи ні — зараз «Вимкнений».
  2. Кнопка-колба «Перевірити» запускає пробне вивантаження одного товару без відправки файлу.
  3. Кнопка «Вивантажити» запускає реальне вивантаження за цим шаблоном.
  4. Секція «Що вивантажувати» — галочки Фото / Атрибути / Опції, форма зберігається автоматично.
  5. Вкладка «Обмеження вивантаження (фільтр)» веде до налаштування відбору товарів.

Новий шаблон зʼявляється в сітці готовим до налаштування, і кілька речей у ньому вже задано:

  • у колонці «Шаблон» стоїть назва виду «‹Тип› #‹номер›» — її варто одразу замінити на людську, бо саме її ви бачитимете в списку, у зведенні й у журналі;
  • імʼя файла підставлено за замовчуванням для цього типу;
  • у «Додатковому фільтрі» вже стоїть умова «Активність = так» — тобто тільки активні товари. Вимкнений товар у файл не піде, доки ви цю умову не приберете;
  • заповнено таблицю «Налаштування наявності товару»: статусам «в наявності» проставлено кількість 1000, «під замовлення» — 500, решті — 0, і всі позначені як активні на приймачі. Це те, що майданчик побачить у полі кількості, і це редагується кнопкою в секції «Повʼязані налаштування».

Де задається відбір товарів

Умови відбору живуть у картці шаблону, на вкладці «Обмеження вивантаження (фільтр)». Панель «Встановити фільтр за:» дає чотири інструменти.

  • «категоріям» — вибір категорій, які беруть участь саме в цьому вивантаженні. Кнопка показує лічильник обраного, а меню під нею пропонує два режими вибору: «категорії у вигляді дерева» і «категорії у вигляді списку».
  • «виробникам» — обмежити вивантаження конкретними брендами.
  • «контрагентам» — обмежити постачальниками, від яких прийшли товари.
  • «Додатковий фільтр» — конструктор умов по полях сітки товарів: ціна, статус наявності, залишок, дата, будь-яке поле каталогу й атрибути товарів. Під конструктором програма переказує зібрані умови людською мовою, а кнопки «Скинути» і «Зберегти» — там же.
Вкладка «Обмеження вивантаження (фільтр)» шаблону Google (укр)
1Кнопка «категоріям» з лічильником вибраного
2Конструктор «Додатковий фільтр»
3Рядок з переказом умов людською мовою
  1. Кнопка «категоріям» показує, скільки категорій обрано для вивантаження — тут 152.
  2. Конструктор «Додатковий фільтр» містить три вже заповнені умови: активність, наявність фото і статус наявності.
  3. Унизу програма переказує умови звичайною мовою: «Активність = так ТА Фото (прапор наявності) = так ТА Статус наявності = В наличии».

Фільтр шаблону — не те саме, що відбір у каталозі. Відбір у каталозі показує рядки тут і зараз; умови шаблону зберігаються і діють при кожному прогоні, у тому числі нічному. Саме тому цифра «Всього» в каталозі й цифра у зведенні шаблону можуть відрізнятися в рази: шаблон додає до ваших умов ще й обовʼязковий прапор вивантаження та обовʼязкову вивантажувану категорію.

У шаблоні «Прайс-лист (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 головний товар сімʼї з опціями не їде — замість нього їдуть самі опції. Так зроблено під вимоги майданчика.

Найшвидший спосіб перевірити конкретний товар

Не перебирайте одинадцять пунктів руками — запитайте програму. У шапці картки шаблону є кнопка-колба «Перевірити» з підказкою «Пробне вивантаження одного товару: показати результат і знайдені помилки». Впишіть «ID товару» — і отримаєте або готовий фрагмент файла саме для цього товара, або пряму відповідь: «Товар #123 не потрапив у вивантаження: він не проходить умови цього шаблону (фільтр, категорія, наявність, правила).»

Поле ID можна лишити порожнім, тоді візьметься перший товар, що підходить під умови. Якщо не підійшов жодний, програма скаже про це окремо. Пробний прогін нічого не надсилає й не переписує ваш робочий файл. Він доступний для XML-фідів, Google-фідів, прайс-листа XLSX/CSV, prom.ua, 1С і прямих зʼєднань за API; для Elbuz Tunnel відповідь буде «Для цього формату шаблону перевірка поки недоступна».

Обрано магазин, а склад магазину порожній. Тоді у файл не потрапляє нічого, і зовні це виглядає як зламане вивантаження. Програма пише в журнал окремий червоний рядок: «Магазин «‹назва›» обрано в налаштуваннях, але до нього не віднесено жодного товару — вивантажувати нічого. Склад магазину задається в картці товару (блок «Магазини») або при створенні категорій усередині гілки магазину.» Склад заповнений тільки в магазинів, заведених руками, — в основного магазину його зазвичай немає взагалі. Якщо ви не поділяєте каталог між магазинами, лишіть поле «ID магазину» порожнім: тоді вивантажується весь каталог. Зведення цієї пастки не показує — у діалозі буде повне число товарів.

«Вивантажувати лише нові дані» у двох шаблонах одразу. Наприкінці успішного прогону з цією галочкою програма позначає весь каталог як уже вивантажений. Позначка одна на товар, а галочка — своя в кожного шаблону. Тому перший шаблон, який відпрацює, гасить позначку всім товарам, а другий не сформує нічого: у XML-фіді на посиланні лишиться минулий файл, у Google-фіді файл перезапишеться порожнім. Прогін однаково завершиться штатним «Вивантаження даних завершено», без жодної скарги, і дата вивантаження в списку оновиться. Тримайте цю галочку не більше ніж в одному шаблоні.

У прайс-листі XLSX/CSV і в прямих зʼєднаннях за API є ще одна умова, якої немає у фідах: категорія повинна мати назву мовою вивантаження. Категорія без перекладу вирізає з файла всі свої товари. У XML- і Google-фідах така категорія просто їде без назви.

А з пунктом 2 у прямих зʼєднаннях за API навпаки: товар без опису потрібною мовою не відкидається — він поїде на майданчик із порожньою назвою. Поля «ID мови» у формах API і prom.ua немає взагалі, там завжди береться основна мова каталогу.

Що на відбір не впливає

Ціна, фото, характеристики, опис і штрихкод відбір не звужують. Товар без ціни й без фото поїде у файл так само, як повний, — програма порахує його окремо і покаже цифру в зведенні, але не відкине. Відхилить його вже майданчик, і дізнаєтеся ви про це від майданчика.

Статус наявності сам собою теж не відбирає: «немає в наявності» їде у файл, якщо ви не заборонили це умовами шаблону. Яку кількість і яку активність побачить приймач, вирішує таблиця «Налаштування наявності товару».

Ціна у вивантаженні

Націнки на етапі вивантаження немає. У жодному з форматів немає ні відсотка, ні коефіцієнта, ні правил: у файл іде значення поля рівно таким, як воно лежить у базовому каталозі. Націнка застосовується раніше, коли каталог оновлюється з прайсів постачальників, — це правила ціноутворення для прайс-листа.

Що з ціною можна зробити тут:

  1. Вибрати, яке поле є ціною. У шаблоні доступні всі цінові поля товару: «Ціна», «Ціна РРЦ», «Ціна собівартість», «Стара ціна», «Ціна акція», а поруч із ними «Валюта», «Фіксована ціна» і «Динаміка ціни». Для оптового прайса зазвичай беруть одне поле, для маркетплейса — інше.
  2. Написати формулу. У XML-шаблоні формула береться у подвійні квадратні дужки: [[IF({Товар БК: Ціна РРЦ}>0, {Товар БК: Ціна РРЦ}, {Товар БК: Ціна})]] — «якщо заповнена, бери її, інакше звичайну ціну». У прайс-листі XLSX/CSV те саме робить колонка «Формула» у списку обраних полів.
  3. Перерахувати за курсом. {CURRENCY_RATE_USD} підставляє поточний курс із довідника валют — і в шапку шаблону, і всередину формули. Курс підставляється заокругленим до двох знаків: для валют із дрібним курсом (гривня до долара, тенге) це помітно спотворює перерахунок.

Числа заокруглюються самі: поля з типом «ціна» — до двох знаків, числові поля — до чотирьох, вага — до двох. На результат формули це не поширюється: він іде у файл таким, як його порахувала база, тому заокруглення пишіть усередині самої формули.

Код валюти у файл завжди йде один — основної валюти акаунта. Ціни в каталозі зберігаються в ній же, тому «складання різних валют» у вивантаженні статися не може.

Помилка у формулі поводиться по-різному, і другий випадок небезпечніший. Якщо формула не пройшла перевірку на безпеку, прогін іде далі, а обчислювані поля у файлі виходять порожніми. Якщо ж у формулі синтаксична помилка — забули кому в IF, не закрили дужку, — ламається весь запит до бази: файл не формується взагалі, на посиланні лишається минулий файл, а в журналі однаково зʼявляється «Вивантаження даних завершено» і в списку оновлюється дата вивантаження. Для каналу, який майданчик забирає сам за розкладом, це виглядає як «ціни не змінювалися тиждень». Тому будь-яку правку формули проганяйте кнопкою «Перевірити»: там видно і текст помилки, і фрагмент файла. Дата прогону змінилася, а файл лишився старим — шукайте помилку у формулі.

Передпольотне зведення: що буде вивантажено

Коли вивантаження запускають зі списку шаблонів, прогін починається не одразу: спершу відкривається діалог «Що буде вивантажено» за умовами цього шаблону.

Угорі — одне велике число і підпис «товарів піде у вивантаження», поруч дельта до минулого прогону. Під ним смуга складу з трьох кнопок: «В наявності», «Немає в наявності», «Під замовлення» — теж із дельтою.

Зведення рахує товари за прапором вивантаження, умовами «Додаткового фільтра» й обраними категоріями. Решти обмежень шаблону воно не бачить: ні мови опису, ні магазину, ні складу, ні галочки «Вивантажувати лише нові дані», ні демо-ліміту. Тому число діалогу — це стеля відбору, а не факт: у файлі товарів може виявитися менше, а якщо в шаблоні обрано магазин із порожнім складом — жодного, і зведення все одно покаже повне число. Скільки пішло насправді, видно вже в журналі прогону.

Діалог «Що буде вивантажено: Google (укр)»
1Число товарів, що підуть у вивантаження
2Легенда складу за наявністю
3Секція «Умови відбору»
4Посилання «Налаштувати пороги»
  1. Велике число «21 471 товарів піде у вивантаження» — стільки товарів потрапить у файл цього прогону.
  2. Легенда показує розподіл за наявністю: «В наявності», «Немає в наявності», «Під замовлення».
  3. Секція «Умови відбору» переказує фільтр шаблону та кількість обраних категорій (152).
  4. Посилання «Налаштувати пороги» веде до стоп-правил вивантаження просто з діалогу зведення.

Секція «Якість карток» — це те, через що майданчик ріже товари: чипи «Без ціни», «Без фото», «Без характеристик», «Без опису». Чип «Без штрихкоду» зʼявляється тільки там, де штрихкод обовʼязковий: у Google-фіді, prom.ua і фідах Rozetka, Epicentr, Ceneo, Allegro. Чип «Товари-опції» — коли такі товари у відборі є.

Секція «Якість карток» у діалозі зведення для шаблону «хр-ки»
1Чип «Без ціни» з числом
2Чип «Без фото»
3Стрілка переходу в каталог
  1. Чип «Без ціни 3 941» — кількість товарів шаблону без ціни в базі.
  2. Чип «Без фото 305» — товари без фотографії, які підуть у вивантаження як є.
  3. Кожен чип клікабельний: стрілка в кутку відкриває саме ці товари в каталозі.

Секція «Умови відбору» переказує фільтр шаблону людською мовою і додає рядок «Відбір за категоріями: обрано ‹N›». Через місяць після налаштування це єдиний спосіб згадати, що саме ви колись задали. Довгий список згортається кнопкою «Показати всі умови».

Унизу — фолд «Минулі вивантаження» з таблицею до десяти останніх прогонів і графіком наявності. По ньому видно, разовий це збій каталогу чи наявність тане не перший день. У підвалі діалогу — дата минулого прогону, вага файла і скільки він тривав, а праворуч посилання «Налаштувати пороги».

Кожна кнопка складу й кожен чип якості клікабельні — вони відкривають каталог, звужений до цих товарів. Програма кладе в панель фільтрів каталогу тимчасовий чип «Вивантаження: ‹назва шаблону›»; у підказці чипа написано, що саме враховано: «фільтр шаблону та категорії, що беруть участь у вивантаженні». Тобто список у каталозі збігається з цифрою зведення, і межі в нього ті самі. Чип один на всі шаблони і перезаписується щоразу, коли ви відкриваєте діалог. Якщо у фільтрі шаблону є умови за характеристиками товару, чип не створюється зовсім — тоді в каталозі ви побачите ширший список.

Діалог можна вимкнути на весь акаунт — перемикач «Показувати зведення перед запуском вивантаження» у вікні «Стоп-правила вивантаження». Це спільне налаштування для всіх користувачів акаунта, і воно вимикає тільки вікно підтвердження: саме зведення й стоп-правила продовжать працювати, а результат піде в журнал операції. За замовчуванням діалог увімкнено.

Зведення рахується не завжди. Якщо у фільтрі шаблону є поля, яких немає у швидкій вибірці, діалог скаже: «Передпольотне зведення не розраховано: фільтр шаблону використовує поля, недоступні для швидкого підрахунку.» — і запропонує «Вивантажити» або «Скасувати». Саме вивантаження такий фільтр відпрацює нормально: у нього більше звʼязків між таблицями, ніж у швидкого підрахунку.

У пункту «Вивантажити всі шаблони» діалог свій: там не перерахунок, а список активних шаблонів із цифрами їхніх останніх прогонів. Пояснення в діалозі каже прямо: «Буде вивантажено всі активні шаблони. Цифри нижче — з останнього прогону кожного шаблону: так видно, який із них вивантажувався порожнім або втратив наявність.»

Стоп-правила: коли програма зупинить вивантаження

Перед кожним прогоном програма порівнює нові цифри з минулим успішним прогоном цього ж шаблону. Якщо розбіжність виходить за поріг, вона попередить у журналі та у вікні запуску, а в режимі «Зупинити вивантаження» не дасть вивантажити дані взагалі. Пороги працюють і під час запуску за розкладом — саме там вони й потрібні найбільше, бо вночі ніхто не дивиться на цифри.

Правил три, і за замовчуванням усі три увімкнені в режимі «Попереджати»:

ПравилоПорігЩо означає
«обвал наявності щодо минулого прогону»30На скільки відсотків кількість товарів у наявності може впасти щодо минулого прогону, перш ніж це вважати збоєм
«обвал кількості товарів щодо минулого прогону»50На скільки відсотків може зменшитися загальна кількість товарів у вивантаженні
«вивантажувати нічого, товарів»1Мінімальна кількість товарів у вивантаженні. Менше — отже фільтр шаблону або каталог зламані
Вікно «Стоп-правила вивантаження» для шаблону Google (укр)
1Правило «обвал наявності відносно минулого прогону» з порогом 30
2Колонка «Режим» з «Попереджати»
3Кнопка «Зберегти для всіх шаблонів»
4Перемикач «Показувати зведення перед запуском вивантаження»
  1. Поріг 30% для правила про обвал наявності — при перевищенні система лише попередить.
  2. Колонка «Режим» показує, що для всіх трьох правил зараз обрано «Попереджати», а не «Зупинити вивантаження».
  3. Кнопка «Зберегти для всіх шаблонів» переносить ці пороги на всі шаблони акаунта — застосовувати обережно.
  4. Перемикач керує спільною для акаунта настройкою показу зведення перед запуском.

Режимів теж три: «Вимкнено», «Попереджати» (прогін іде далі, у журналі зʼявляється попередження) і «Зупинити вивантаження» (прогін не починається, старий файл лишається на місці). Вікно відкривається з бургер-меню списку пунктом «Стоп-правила вивантаження».

Кнопок збереження дві. «Зберегти для цього шаблону» задає пороги персонально й зʼявляється, коли ви відкрили вікно з обраним рядком. «Зберегти для всіх шаблонів» робить пороги спільними — і скидає персональні налаштування окремих шаблонів, про що програма перепитує окремо: «Пороги стануть спільними для всіх шаблонів вивантаження. Персональні налаштування окремих шаблонів буде скинуто. Продовжити?»

Два перші правила порівнюють із минулим прогоном — отже, на першому прогоні шаблону порівнювати немає з чим, і вони мовчать. Діалог так і пише: «Шаблон ще не вивантажувався — порівнювати немає з чим.» Тому перший файл нового каналу перевіряють очима, а не покладаються на автоматику.

Стоп-правила рахують ті самі цифри, що й зведення, — отже й межі в них ті самі. Порожній файл через обраний магазин, склад або галочку «лише нові дані» правило «вивантажувати нічого» не побачить: у нього в підрахунку лежить увесь відібраний каталог. Такі випадки ловить тільки журнал прогону.

Зупинений прогін не запамʼятовується як еталон — інакше аварійні цифри стали б нормою для наступного порівняння. Еталоном стає тільки прогін, який відбувся.

Запуск руками і за розкладом

Один шаблон

Виділіть рядок у списку й натисніть «Вивантажити» — або наведіть курсор на рядок і натисніть кнопку-трикутник «Вивантажити цей шаблон». Обидві покажуть зведення, і тільки після вашого підтвердження програма скаже «Вивантаження запущено — стежте в «Операціях»», а в Центрі операцій зʼявиться рядок цього прогону з журналом.

У шапці картки шаблону є кнопка з такою самою підписою «Вивантажити» — і поводиться вона інакше: зберігає форму й одразу відправляє, без діалогу й без питань. Зведення з картки не отримати взагалі, у якому б форматі шаблон не був. Тобто в картці ця кнопка означає «відправити», а не «перевірити»; щоб побачити цифри перед відправкою, закрийте картку й запустіть шаблон із рядка списку. Для перевірки з картки є інша кнопка — колба «Перевірити»: вона нічого не надсилає.

Стоп-правила при цьому працюють в обох випадках: вони живуть на сервері, і правило в режимі «Зупинити вивантаження» зупинить прогін, запущений хоч зі списку, хоч із картки. Без діалогу ви просто не побачите цифр заздалегідь — вердикт піде в журнал.

Руками запускається навіть вимкнений шаблон: перемикач «Стан» обмежує розклад і масовий прогін, а не вашу кнопку. Так перевіряють канал, який ще налаштовується.

Усі шаблони

Бургер-меню списку, пункт «Вивантажити всі шаблони». Беруться тільки активні, і йдуть вони по черзі, один за одним, у порядку колонки «Порядок обробки». Прогін виконується у фоні: вікно можна закрити. Якщо активних шаблонів багато — більше двох десятків, — після масового прогону звіряйте колонку «Останнє вивантаження»: так видно, чи відпрацювали всі.

За розкладом

Кнопка «Налаштування розкладу» в секції «Повʼязані налаштування» картки шаблону.

Дві речі, про які варто знати заздалегідь. По-перше, розклад пропускає вимкнені шаблони — перемикач «Стан» головніший за розклад. По-друге, два вивантаження за розкладом одночасно не запускаються: друге завдання побачить перше й напише в журнал «Скасовано вивантаження за розкладом, причина - вивантажується інший шаблон (конфлікт обробки даних).» Якщо в акаунті кілька важких шаблонів, рознесіть їх у часі.

Зупинити

У рядку операції в Центрі операцій є кнопка «Зупинити». Вона не вбиває процес миттєво: програма перевіряє прапорець зупинки між кроками, тому прогін завершується на найближчій межі. У журналі зʼявиться «Вивантаження перервано користувачем!».

Куди лягає файл

Готовий файл спершу пишеться в теку вашого акаунта, а далі розходиться туди, куди ви налаштували.

  • Посилання. Адреса готового файла показується в колонці «Файл» списку, поруч є кнопка «Копіювати посилання» (після натискання виникає тост «Посилання скопійовано»). Це і є та адреса, яку ви даєте майданчику.
  • FTP. Спрацьовує, якщо в «Налаштуваннях FTP» заповнено адресу сервера й імʼя користувача. Там же — порт, пароль, перемикач «SFTP (SSH File Transfer Protocol)», «Шлях куди вивантажувати», «Кількість потоків» і кнопка «Перевірити підключення». Натисніть її до першого прогону: у відповідь буде або «Підключення успішно встановлено!», або «Помилка: ‹відповідь сервера›». Якщо сервер, порт, користувач і пароль заповнені не всі, кнопка відповість «Заповніть поля!».
  • Пошта. Вкладення до листа працює лише в типі «Прайс-лист (XLSX, CSV)» і лише коли заповнено «Шаблон розсилки». Вкладення можна архівувати в ZIP.
  • Пряме зʼєднання. У типів із групи API файла немає взагалі — дані йдуть у сервіс майданчика запитами.

Імʼя файла задається в картці шаблону, і в ньому працюють три макроси: {DATE} — сьогоднішня дата, {DATETIME} — дата з часом, {TIME} — час. Це потрібно, коли майданчик або клієнт хоче окремий файл на кожен день. Скісна риска в імені замінюється крапкою, а розширення .php та його різновиди програма примусово міняє на .xml.

Після прогону програма записує розмір файла і витрачений час — обидва числа видно і в списку, і в діалозі зведення наступного разу. Файл менший за 4 КБ рахується як 4 КБ: на диску він однаково займає блок.

Журнал прогону й історія запусків

Журнал прогону живе в Центрі операцій і показує рядки в реальному часі — вікно вивантаження при цьому не блокується. Порядок кроків фіксований, і по ньому видно, докуди дійшло:

У XML- і Google-фіда це: «Вивантаження даних…» → «Індексування товарів» → зведення → «Вивантаження категорій товарів» → «Вивантаження товарів» → «Вивантаження товарів ‹N› із ‹M›» → «Завантажуємо файл у хмарне сховище» → посилання «Завантажити файл ‹імʼя›» → «Вивантаження даних завершено» і «Витрачено часу: ‹чч:хх:сс›».

Набір кроків залежить від типу шаблону: рядки про фотографії, генератор описів і розсилку листів зʼявляються тільки там, де ці кроки взагалі є. Рядок «Вивантаження товарів ‹N› із ‹M›» — найважливіший: це вже факт, а не прогноз зведення.

Вікно «Перевірка шаблону вивантаження» з результатом пробного прогону
1Поле «ID товару»
2Підсумковий рядок результату
3Фрагмент сформованого файлу
  1. Поле «ID товару» лишили порожнім — перевірка сама обрала перший товар шаблону.
  2. Підсумковий рядок повідомляє: «Помилок не знайдено: вивантаження сформовано коректно, усі макроси підставлено».
  3. Фрагмент показує згенерований XML для товару Marshall Willen Black and Brass — усі макроси підставлені реальними значеннями.

Одним із перших рядків, відразу після «Індексування товарів», журнал пише зведення: «Передпольотне зведення: усього товарів ‹N›, в наявності ‹N›, немає в наявності ‹N›, під замовлення ‹N›, без статусу наявності ‹N›.» — і, коли є з чим порівнювати, «Минулого прогону: усього ‹N›, в наявності ‹N›.» Це працює і для запуску за розкладом, коли діалогу ніхто не бачив.

Наприкінці журнал дає посилання «Завантажити файл ‹імʼя›» — те саме, що показує колонка «Файл».

Вікно журналу показує поточний прогін. Рядки минулих прогонів із бази не зникають — вони живуть два тижні, а картки операцій три місяці; щоб подивитися, що було раніше, є кнопка-графік «Історія запусків» — вона є і в тулбарі списку, і в шапці картки шаблону. Кожен прогін окремо реєструється в Центрі операцій карткою, підписаною «Вивантаження даних» разом із типом, назвою та імʼям файла шаблону; у масовому прогоні картки шаблонів лягають дочірніми під спільну картку «Вивантаження даних за всіма шаблонами».

Якщо в налаштуваннях увімкнено звук завершення вивантаження, у кінці прогону програма подасть сигнал.

Чого вивантаження не робить

  • Не рахує націнку. У файл іде та ціна, що лежить у каталозі. Іншу треба або порахувати формулою в шаблоні, або виправити раніше — правилами ціноутворення при оновленні каталогу з прайсів.
  • Не бере товари з прайсів постачальників. Джерело у вивантаження одне — . Щоб дані постачальника поїхали на майданчик, спершу оновіть базовий каталог із прайсів. Виняток один — прайс-лист XLSX/CSV, у якого є окрема вкладка для рядків прайсів.
  • Не перевіряє картку товару. Товар без ціни, фото й опису поїде у файл нарівні з повним. Програма порахує його у зведенні, але не відкине — відхилить майданчик.
  • Не тримає історію файлів. Кожен прогін замінює попередній файл; версій «як було минулого тижня» немає. Якщо потрібен архів, вивантажуйте з макросом {DATE} в імені файла на FTP.
  • Не забирає замовлення з майданчика. Це протилежний напрямок і окрема підсистема — пункт меню «Завантаження даних».

Що робити, коли у файлі не те

Розбір частих проблем
Що ви бачитеЧому такЩо зробити
«Під умови цього шаблону не підійшов жоден товар — вивантажувати нічого» Пробний прогін не знайшов жодного товару під умови шаблону Пройдіть таблицю умов згори вниз — найчастіше це прапор товару, категорія або обраний магазин (чому товар не поїхав)
«Товар #123 не потрапив у вивантаження: він не проходить умови цього шаблону (фільтр, категорія, наявність, правила).» Ви вказали ID товару в перевірці, і його відсікає одна з умов Перевірте цей товар по пунктах 1–11: прапор, опис мовою вивантаження, категорія, фільтр (чому товар не поїхав)
«Магазин «‹назва›» обрано в налаштуваннях, але до нього не віднесено жодного товару — вивантажувати нічого.» У полі «ID магазину» обрано магазин, склад якого не заповнено Приберіть вибір магазину або наповніть склад магазину в картках товарів (про пастку з магазином)
«Вивантаження зупинено стоп-правилом: ‹правило›. Перевірте статуси наявності в базовому каталозі.» Спрацювало правило в режимі «Зупинити вивантаження»; старий файл лишився на місці Перевірте каталог. Якщо цифри правильні — тимчасово змініть поріг у вікні «Стоп-правила вивантаження» (про стоп-правила)
«Увага, дані виглядають підозріло: ‹правило›. Перевірте статуси наявності в базовому каталозі.» Те саме правило, але в режимі «Попереджати» — прогін продовжився Перевірте каталог до того, як файл забере майданчик: він уже сформований (про стоп-правила)
«Передпольотне зведення не розраховано: фільтр шаблону використовує поля, недоступні для швидкого підрахунку.» У фільтрі шаблону поля, яких немає у швидкій вибірці Нічого. Вивантаження відпрацює нормально, зникає лише зведення (про зведення)
«Скасовано вивантаження за розкладом, причина - вивантажується інший шаблон (конфлікт обробки даних).» Розклад побачив, що інше вивантаження ще йде Рознесіть розклади шаблонів у часі (про розклад)
«У шаблоні не знайдено повторюваний вузол товару (тег вказано у «Розширеному», наприклад ). Зміни НЕ збережено.» У документі XML-шаблону немає тега, який програма мала б повторити для кожного товару Поверніть вузол у шаблон або вкажіть правильний тег у секції «Розширене». Той самий випадок — тост «Не збережено: у шаблоні немає вузла товару»
«Макроси не розпізнано, і вони будуть вирізані з файлу: ‹список›» У шаблоні макрос із помилкою в назві поля У редакторі шаблону натисніть Ctrl+Space й оберіть поле зі списку
«Файл не сформовано. Спочатку виправте помилку вище — доки вона є, товари у вивантаження не потрапляють.» Прогін упав раніше, ніж дійшов до формування файла Усуньте помилку, названу рядком вище в журналі перевірки
«Для цього формату шаблону перевірка поки недоступна» Пробного прогону немає в Elbuz Tunnel Запустіть повне вивантаження і дивіться журнал (про журнал)
«Увага, ви використовуєте ДЕМО версію! Вивантаження товарів обмежено 100 товарами.» Демо-акаунт: у файл потрапляють перші 100 товарів Поповніть баланс — меню Кабінет → Баланс → Оплата
«Немає доступу до вивантаження даних» Групі користувача не видано доступ до вікна вивантаження Попросіть власника акаунта відкрити доступ (хто має доступ)

Хто має доступ

Вивантаження не заховане за жодним модулем — воно є в кожному акаунті. Доступ дає одне право: до вікна «Вивантаження даних». Хто його не має, побачить повідомлення про відсутність прав замість вікна.

Це право одне і на список, і на картку шаблону, і на кнопку «Перевірити». Дати менеджерові подивитися список, але не пустити його правити умови відбору, зараз неможливо. У вікна «Стоп-правила вивантаження» право своє, окреме: пороги можна закрити від тих, кому відкрито самі шаблони.

Усередині вікна є шість окремих блоків — категорії, товари, виробники, атрибути, опції, фото. Знятий блок галочку не приховує, а блокує: вона видна, але змінити її не можна. Блоки діють у формах Elbuz Tunnel і прямих зʼєднань за API; у формах фідів і прайс-листа ці галочки завжди доступні.

Перед першим вивантаженням

Часті запитання

Товар є в каталозі, а у файлі його немає. Де шукати?

Відкрийте картку шаблону, натисніть «Перевірити» і впишіть ID товару. Програма або покаже фрагмент файла для цього товару, або відповість, що він не проходить умови шаблону. Далі перевіряйте по порядку: прапор «Вивантажувати у файл (на сайт)» у товара, опис мовою з поля «ID мови», категорія товара та її прапор «Прапор: вивантажувати», список категорій шаблону і «Додатковий фільтр».

Чи додає вивантаження націнку до ціни?

Ні. У файл іде значення поля рівно таким, як воно лежить у базовому каталозі. Іншу ціну задають або формулою в шаблоні, або раніше — правилами ціноутворення при оновленні каталогу з прайсів постачальників.

Що буде, якщо запустити вимкнений шаблон?

Він вивантажиться. Перемикач «Стан» обмежує запуск за розкладом і пункт «Вивантажити всі шаблони», а кнопка «Вивантажити» на конкретному шаблоні працює в будь-якому стані.

Чому в зведенні не порахувалися цифри?

Так буває, коли у фільтрі шаблону є поля, недоступні для швидкого підрахунку. Діалог про це прямо пише і пропонує запустити вивантаження без перевірки. Саме вивантаження такий фільтр відпрацює нормально — зникає лише зведення.

Файл вийшов порожній, помилок у журналі немає. З чого почати?

Перевірте три речі. Чи не обрано в полі «ID магазину» магазин із порожнім складом — про це в журналі є окремий червоний рядок. Чи не стоїть галочка «Вивантажувати лише нові дані» ще в одному шаблоні, який відпрацював раніше. Чи не відсікають усе умови «Додаткового фільтра» — у новому шаблоні там за замовчуванням стоїть «Активність = так».

Натиснув «Вивантажити» в картці шаблону — зведення не відкрилося. Чому?

Тому що діалог «Що буде вивантажено» показується тільки при запуску зі списку шаблонів. Кнопка в шапці картки зберігає форму й одразу відправляє вивантаження. Щоб побачити цифри перед відправкою, запускайте шаблон із рядка списку; для перевірки з картки є кнопка-колба «Перевірити» — вона нічого не надсилає.

Зведення показало двадцять тисяч товарів, а файл порожній. Як так?

Зведення рахує тільки прапор вивантаження, умови «Додаткового фільтра» й обрані категорії. Магазин, склад, мову опису й галочку «Вивантажувати лише нові дані» воно не враховує, тому його число — це стеля відбору, а не факт. Найчастіший випадок такої розбіжності — обраний магазин, до якого не віднесено жодного товару. Що поїхало насправді, показує журнал прогону.

Чи можна вивантажувати за розкладом?

Так, кнопка «Налаштування розкладу» в секції «Повʼязані налаштування» картки шаблону. Розклад пропускає вимкнені шаблони, а два вивантаження одночасно не запускаються — друге напише в журнал про конфлікт обробки даних.

Чим «Вивантаження даних» відрізняється від «Завантаження даних»?

Напрямком. Вивантаження відправляє ваш каталог назовні — у файл, на маркетплейс, на сайт. Завантаження приймає дані ззовні до вас. Пункти меню стоять поруч і схожі за назвою, тому варто звіряти, який з них відкрито.

Скільки товарів вивантажується в демо-версії?

Перші сто. У журналі про це зʼявляється окремий рядок; обмеження знімається поповненням балансу.

Суміжні теми

Чи була стаття корисною?