Епіцентр — один із найбільших українських маркетплейсів. Каталог на нього Elbuz віддає XML-фідом: програма формує файл за своїм шаблоном, а майданчик періодично його забирає й оновлює ваші товари, ціни та наявність. Це односторонній канал — ви публікуєте асортимент, а не забираєте щось звідти.
Ця стаття — про вивантаження саме на Епіцентр: чим його фід відрізняється від інших, що обов'язково треба підготувати в каталозі й чому без зіставлення довідників товари не приймаються. Загальні принципи вивантаження описано в огляді вивантаження даних.
Де це у програмі
У вікні вивантаження створіть шаблон і оберіть тип «epicentrk.ua (XML)». Це різновид XML-фіду: Elbuz одразу підставляє готову структуру файлу під вимоги майданчика, тож складати її вручну не потрібно. Один шаблон — один фід; посилання на нього ви передаєте Епіцентру, а далі оновлення йде за розкладом.
1
Назва і тип шаблону2
Блок налаштувань фіда- Назва і тип шаблону — заголовок форми показує тип фіда epicentrk.ua (XML) та його ID.
- Блок налаштувань фіда — перелік даних, які потрапляють у вивантаження: категорії, товари, фото, атрибути.
У формі шаблону дві вкладки. На вкладці «Вибір даних для вивантаження» галочками задається склад фіду — для Епіцентру потрібні Категорії, Товари, Фото й Атрибути; окремий перемикач «Вивантажувати лише нові дані» лишають вимкненим, коли майданчик має отримувати повний каталог. Вкладка «Обмеження вивантаження (фільтр)» звужує асортимент, якщо на Епіцентр їде не весь каталог.
Нижче у формі показано сам шаблон XML — текст файлу з підстановками виду {Поле}. Його видно й можна редагувати: програма сама розмножує рядок категорії та рядок товару, а підстановки підбираються по Ctrl+Space. Міняти шаблон варто лише тоді, коли Епіцентр попросив щось специфічне: типовий уже відповідає вимогам майданчика.
Чим фід Епіцентру відрізняється від інших
Зовні це той самий сімейний формат XML-фідів, але Епіцентр вимагає кількох речей, яких немає в інших майданчиків. Найважливіше — він працює за своїми довідниками: категорію й кожну характеристику товару треба назвати кодом Епіцентру, а не вашою назвою.
| Елемент фіду | Звідки береться в Elbuz |
|---|---|
ідентифікатор товару в offer | у типовому шаблоні — внутрішній номер товару в Elbuz (не uuid, як у Prom); змінюється в шаблоні |
| ознака наявності | залишок товару |
price, price_old | ціна та стара ціна |
category (атрибут code) | поле категорії «ID epicentrk.ua» |
| назва категорії у фіді | останній рівень шляху з поля «Категорія epicentrk.ua» |
attribute_set | той самий код категорії Епіцентру |
| назва та опис | назва й повний опис товару, українською |
| зображення | фотографії товару |
| характеристики | назва, код і значення з довідника Епіцентру |
| габарити | поля товару Ширина, Висота, Глибина |
| вага | поле товару Вага |
| штрихкод | поле товару Штрихкод EAN |
| одиниця виміру та кратність | підставляються фіксовано: штука, кратність 1 |
Зверніть увагу на перший рядок. У типовому шаблоні товар адресується внутрішнім номером товару в Elbuz — не тим кодом, який використовується для Prom. Це значення ви можете змінити в шаблоні XML: замість номера підставити код товару (uuid) або артикул — залежно від того, чим вам зручніше зіставляти позиції на майданчику.
Що б ви не обрали, воно має лишатися незмінним: саме за цим значенням Епіцентр упізнає товар при кожному оновленні, за ним же повертаються рядки замовлень (див. завантаження замовлень з Епіцентру). Звідси два правила. По-перше, не міняйте ідентифікатор у шаблоні після того, як каталог уже вивантажено: майданчик сприйме всі товари як нові. По-друге, не видаляйте й не перестворюйте картку заради виправлення — у нової буде інший номер, і на майданчику вона стане окремим товаром, а стара лишиться «висіти».
Що підготувати перед першим вивантаженням
Фід збереться і без підготовки, але майданчик такі товари не прийме. Порядок дій такий.
1. Зіставте категорії. У кожної вашої категорії є поля «ID epicentrk.ua» та «Категорія epicentrk.ua». Перше — код категорії з довідника майданчика, друге — її повний шлях. У фід іде код, а назвою підставляється останній рівень шляху: якщо вписано «Інструменти / Електроінструмент / Дрилі», у файл потрапить «Дрилі». Без коду категорії товар їде з порожнім значенням, і Епіцентр не розуміє, куди його покласти.
2. Зіставте характеристики. Для кожної характеристики Епіцентр чекає свій код і назву зі свого довідника, а для значень — код значення. У картці характеристики для цього є поля «Epicentr: код», «Epicentr: назва», а у вікні зіставлення з зовнішніми системами — колонки «Назва EPICENTR», «Код EPICENTR» і «Значення EPICENTR». Якщо назву Епіцентру не заповнено, Elbuz підставить вашу власну назву характеристики — файл буде коректним, але майданчик таку характеристику може не впізнати.
3. Заповніть габарити, вагу й штрихкод. Ширина, висота, глибина, вага та штрихкод виїжджають у фід окремими параметрами з фіксованими кодами. Для маркетплейсу це не «приємне доповнення»: за габаритами й вагою рахується доставка, а штрихкод використовується для зіставлення товару з наявною карткою на майданчику.
4. Перевірте українські тексти. Назва й опис ідуть у фід лише українською — окремих полів для іншої мови в шаблоні немає. Якщо картка заповнена іншою мовою, на майданчику з'явиться саме цей текст.
Майже всі проблеми з Епіцентром зводяться до незіставлених довідників. Категорія без коду й характеристики без кодів — це формально валідний XML, який майданчик відхилить або прийме частково. Тому перед першим запуском пройдіться саме по зіставленню, а не по налаштуваннях самого фіду: шаблон Elbuz уже підставляє потрібну структуру.
Епіцентр приймає числові характеристики упаковки тільки в міліметрах і грамах. Elbuz віддає у фід значення полів товару як є, без перерахунку. Якщо у вас габарити записані в сантиметрах, а вага в кілограмах, майданчик отримає товар, який «важить 2 грами» й має «ширину 40 міліметрів». Перед першим вивантаженням переконайтесь, що поля Ширина, Висота, Глибина заповнені в міліметрах, а Вага — у грамах.
Вимоги Епіцентру до даних
Майданчик перевіряє не лише структуру файлу, а й сам вміст карток. Нижче — зведення вимог, які найчастіше стають причиною відмови; повні тексти є в довідці Епіцентру (посилання наприкінці статті).
| Що | Вимога |
|---|---|
| Артикул | Унікальний, до 64 символів, без роздільних знаків. Не можна використовувати назву товару як артикул |
| Назва | До 150 символів, українською. Порядок: тип товару → особливість → бренд → модель → додаткові характеристики → колір → артикул у дужках |
| Чого не має бути в назві | CAPSLOCK, розділові знаки (крім дужок), спецсимволи, слова «Акція», «Знижка», «Розпродаж», посилання, жаргон |
| Опис | Обов'язково українською. За вимогами до контенту — до 1500 символів (рекомендовано близько 1000); технічна межа самого файлу значно більша |
| Дозволені теги в описі | p, br, b, ul, li, table, tr, td — решта вирізається |
| Чого не має бути в описі | Умови оплати й доставки, контакти магазину, посилання, реклама третіх осіб, згадки інших товарів |
| Ціна | У гривнях, копійки через крапку (25.78). Стара ціна — тільки за наявності знижки й завжди більша за поточну |
| Категорія | Лише кінцева категорія (та, у якої немає підкатегорій) |
| Габарити й вага | Міліметри і грами |
| Характеристики | Топ-характеристики та основні обов'язкові — за ними працюють фільтри пошуку; параметри упаковки теж обов'язкові |
| Фото | Посилання через HTTPS, від 1 до 10 штук (оптимально 2–8), не менше 500×500 (краще 1280×1280) |
| Вимоги до головного фото | Товар займає щонайменше 80 % кадру, білий або однотонний фон, без вотермарків, написів, логотипів, колажів і упаковки |
Обов'язковою є назва українською. Російська (name з атрибутом мови ru) потрібна лише тоді, коли ви хочете, щоб товар показувався й російською — типовий шаблон Elbuz її не вивантажує. Якщо вона вам потрібна, додайте відповідний рядок у шаблон XML у формі вивантаження. Так само за потреби можна додати окремий тег наявності зі значеннями «в наявності / під замовлення / немає»: Епіцентр віддає йому перевагу перед звичайною ознакою наявності.
Покроковий сценарій: від нуля до товарів на майданчику
Щоб не блукати між кабінетами, ось повний порядок дій — від першого входу до автоматичних оновлень.
- Отримайте довідники Епіцентру. Вам потрібні коди кінцевих категорій і коди характеристик (наборів атрибутів) майданчика. Їх видає сам Епіцентр — через кабінет або запитом до свого довідника.
- Зіставте категорії в Elbuz. У кожній категорії заповніть «ID epicentrk.ua» і «Категорія epicentrk.ua». Робиться один раз: усі нові товари категорії успадкують зіставлення.
- Зіставте характеристики. Проставте коди й назви Епіцентру характеристикам, а для списків — ще й коди значень.
- Підготуйте картки. Українські назва й опис за правилами вище, фото за вимогами, габарити в міліметрах, вага в грамах, штрихкод.
- Створіть шаблон вивантаження типу «epicentrk.ua (XML)», оберіть склад даних і за потреби звузьте асортимент фільтром.
- Перевірте файл. Сформуйте вивантаження один раз вручну й подивіться результат: чи всі товари потрапили, чи не порожні коди категорій.
- Передайте посилання на фід Епіцентру й увімкніть автооновлення на їхньому боці (див. нижче).
- Поставте шаблон на розклад в Elbuz, щоб файл перезбирався зі свіжими цінами та залишками.
Кроки 1–3 — найдовші, але одноразові. Далі робота зводиться до підтримки карток у порядку: нові товари підхоплюються фідом автоматично, якщо їхня категорія вже зіставлена.
Автооновлення на боці Епіцентру
Фід сам по собі нічого не оновлює — його має забирати майданчик. У кабінеті Епіцентру це вмикається так: розділ «Товари» → «Імпорт», підрозділ «Автооновлення залишків», куди ви вставляєте посилання на свій фід і натискаєте «Зберегти». Після збереження майданчик повідомить, що імпорт запущено.
| Що | Як це працює |
|---|---|
| Періодичність за замовчуванням | Один раз на добу, о 24:00 за UTC |
| Частіше | Раз на 12, 4 або 1 годину — вмикається лише через вашого менеджера або підтримку Епіцентру |
| За чим впізнаються товари | За артикулом: значення у фіді має точно збігатися з артикулом товару в кабінеті, інакше оновлення не спрацює |
| Якщо товар зник із фіду | Майданчик не прибирає його автоматично — потрібно окремо позначити опцію зміни статусу на «Немає в наявності» |
Розкладів насправді два: в Elbuz фід перезбирається, а в Епіцентрі — забирається. Немає сенсу перезбирати файл щогодини, якщо майданчик читає його раз на добу. Зробіть навпаки: спершу дізнайтеся у свого менеджера, з якою періодичністю Епіцентр забиратиме фід, і поставте оновлення в Elbuz трохи частіше — так до моменту зчитування у файлі завжди будуть свіжі дані.
Оновлення за розкладом в Elbuz
Коли шаблон налаштовано, поставте його на розклад — і фід перезбиратиметься сам. Частоту обирайте за темпом змін і за періодичністю читання на боці майданчика. Кожен запуск лишає слід у журналі: скільки товарів потрапило у файл, чи були помилки — туди варто заглянути після перших прогонів.
Корисно час від часу звіряти кількість позицій у фіді з тим, скільки ви очікуєте віддати. Якщо число менше, причину шукайте в умовах відбору шаблону. Незіставлена категорія чи порожні габарити товар із файлу не прибирають: такий товар потрапляє у фід з порожніми значеннями, і відхиляє його вже Епіцентр.
Як перезбирається фід і що робити, якщо щось пішло не так
Файл вивантаження: що в нього потрапляє, коли він замінюється і як виправити помилку
Вивантаження у файл робить одне: за шаблоном збирає файл з товарами й кладе його за постійним посиланням. Площадка сама забирає цей файл за посиланням. Окремих команд площадці при такому вивантаженні програма не надсилає: ні «видали товар», ні «зніми з продажу». Усе, що площадка дізнається від нас, записано в останньому файлі, який лежить за посиланням.
Які товари потрапляють у файл
Товар потрапляє у файл, тільки якщо виконано всі умови одночасно:
- у картці товару ввімкнено «Вивантажувати у файл (на сайт)»;
- товар лежить хоча б в одній категорії, яка активна і в якої теж увімкнено «Вивантажувати у файл (на сайт)». Якщо в шаблоні задано відбір за категоріями, категорія має бути ще й серед обраних;
- товар проходить «Обмеження вивантаження (фільтр)» шаблону. У новому шаблоні там уже стоїть одна умова: товар активний (колонка «А» у сітці каталогу). Якщо цю умову прибрати, у файл підуть і неактивні товари;
- якщо в шаблоні не відмічено «Опції», товари-опції у файл не йдуть, тільки звичайні товари. У шаблонах Google Merchant (XML) ця галочка не діє: товари-опції туди йдуть завжди;
- якщо в шаблоні обрано магазин, у файл ідуть лише товари з асортименту цього магазину;
- якщо в шаблоні обрано склад, у файл ідуть лише товари, які на цьому складі є в наявності або мають залишок більше нуля.
Якщо в шаблоні відмічено «Вивантажувати лише нові дані», у файл іде не весь відібраний каталог, а лише товари, в яких знята позначка «Вивантажено». Після вивантаження програма ставить цю позначку тим товарам, що потрапили у файл, а знімається вона, коли товар змінюють у каталозі. Позначка одна на товар для всіх шаблонів: товар, який уже забрав один шаблон із цією галочкою, до іншого такого шаблону не потрапить, доки його не змінять. Для шаблонів Google Merchant (XML) ця галочка не діє.
Перед кожним запуском програма рахує, скільки товарів піде у файл, і пише це на початку журналу, ще до збирання файлу: «Передпольотне зведення: усього товарів…, в наявності…». Під час ручного запуску ті самі цифри показує вікно «Що буде вивантажено» (якщо його показ не вимкнено), і там же можна відкрити ці товари в каталозі.
Що відбувається з товаром, який випав із файлу
З нашого боку — нічого, крім того, що в новому файлі його немає. Товар лишається в каталозі таким, яким був. Що площадка зробить з позицією, якої більше немає у файлі (сховає, зніме з продажу, видалить або залишить як є), вирішує сама площадка, і програма на це не впливає. Дивіться правила вашої площадки.
- Якщо потрібно, щоб площадка побачила товар як відсутній, товар має лишитися у файлі. Для цього він має проходити умови відбору вище, а його статус наявності має відповідати в налаштуваннях наявності шаблону варіанту «немає в наявності» (там же задається кількість, яку отримає такий товар).
- Якщо товар просто зробити неактивним, а в шаблоні стоїть умова «товар активний», він не отримає позначку «немає в наявності», а зникне з файлу повністю.
- Якщо товар повернувся (його знову ввімкнули або він знову пройшов умови), він з'явиться у файлі під час наступного вивантаження.
Що лежить за посиланням, поки збирається новий файл
Новий файл збирається окремо, у робочій папці програми, частинами (у XML-шаблонах по 500 товарів). За посиланням весь цей час лежить попередній файл. Коли новий файл зібрано до кінця, програма записує його в сховище, і тільки після вдалого запису посилання в шаблоні веде на новий файл. Якщо записати новий файл не вдалося, журнал пише «Файл не завантажився в хмарне сховище. Попередній файл і посилання на нього залишено без змін», вивантаження закінчується рядком «Вивантаження даних НЕ завершено: файл не сформовано», а «Посилання на файл (#1)» і «Дата вивантаження» у шаблоні лишаються попередніми.
- Якщо вивантаження зупинили кнопкою «Стоп», воно зупиняється після поточного товару. Недозібраний файл нікуди не потрапляє, за посиланням лишається попередній.
- Якщо умова в шаблоні містить помилку, файл не публікується, і за посиланням теж лишається попередній. Якщо відбір не дав жодного товару, файл не публікується в XML-фідах (YML, Google-фід) і в «Прайс-листі (XLSX, CSV)», крім режиму «Вивантажувати рядки з категоріями, нижче товари + угруповання». Шаблони prom.ua у форматі XLS і «1С (CommerceML2)» за порожнього відбору публікують файл без товарів, і він замінює попередній.
- Якщо в назві файлу в шаблоні є
{DATE},{DATETIME}або{TIME}, назва, а з нею й посилання, змінюється з кожним прогоном. Площадці, яка забирає файл за однією адресою, потрібна назва без цих підстановок. - У хмарній версії до посилання дописується
?uuid=з новим числом після кожного вивантаження. Сам файл лежить за тією самою адресою, число лише обходить кешування в браузері.
Як за журналом зрозуміти, що файл зібрано
Хід вивантаження видно в «Центрі операцій». Файл зібрано й покладено за посиланням, якщо в журналі є рядок «Завантажити файл» з назвою файлу, а останній рядок — «Вивантаження даних завершено». Якщо файл не сформовано або сховище його не прийняло, останній рядок — «Вивантаження даних НЕ завершено: файл не сформовано», і так само закінчується журнал у вікні запуску. Після вдалого прогону в списку шаблонів оновлюються «Дата вивантаження» і «Посилання на файл (#1)». Якщо файл не сформовано, «Дата вивантаження» лишається старою, а змінюється тільки «Витрачено часу».
| Що ви бачите | Що це означає | Що зробити |
|---|---|---|
| «Вивантаження товарів 500 з …» | Файл збирається: перше число — скільки товарів уже записано, друге — скільки всього відібрано. У XML-шаблонах рядок з'являється кожні 500 товарів і ще раз наприкінці | Нічого, чекати завершення |
| «Завантажуємо файл у хмарне сховище» | Файл зібрано повністю, програма замінює ним попередній за посиланням | Нічого, чекати рядка «Завантажити файл» |
| «Файл не завантажився в хмарне сховище. Попередній файл і посилання на нього залишено без змін» | Файл зібрано, але сховище його не прийняло. Вивантаження не завершено, за посиланням лишився попередній файл | Запустити вивантаження ще раз |
| «Вивантаження даних НЕ завершено: файл не сформовано» | Відбір не дав жодного товару, умова шаблону містить помилку, сховище не прийняло файл, або вивантаження зупинили. За посиланням лишився попередній файл | Перевірити цифри передпольотного зведення й умови відбору (які товари потрапляють у файл) |
| «Вивантаження зупинено стоп-правилом: …» | Кількість товарів або наявність упала сильніше за поріг, і правило стоїть у режимі «Зупинити вивантаження». Файл не збирався, за посиланням попередній | Перевірити статуси наявності в базовому каталозі; якщо цифри правильні, змінити поріг у «Стоп-правила вивантаження» й запустити знову |
| «Увага, дані виглядають підозріло: …» | Спрацювало стоп-правило в режимі попередження. Вивантаження при цьому пішло далі, файл замінено | Перевірити каталог; якщо дані неправильні, виправити їх і вивантажити ще раз (як виправити помилкове вивантаження) |
| «Скасовано вивантаження за розкладом, причина - вивантажується інший шаблон» | Поки йде одне вивантаження за розкладом, друге за розкладом не запускається. Файл цього шаблону не оновлено | Рознести завдання розкладу в часі або запустити шаблон вручну |
Як виправити помилкове вивантаження
Кнопки «повернути попередній файл» немає: новий файл замінює попередній, і копії програма не зберігає. Від помилкового файлу є один засіб: виправити причину і вивантажити ще раз. Новий файл замінить помилковий за тим самим посиланням.
- Якщо у файл потрапили не ті товари або їх стало менше, ніж треба, виправте умови відбору шаблону, позначки «Вивантажувати у файл (на сайт)» у товарів і категорій, вибір магазину чи складу. Перед повторним запуском звірте цифри у вікні «Що буде вивантажено».
- Якщо товари у файлі правильні, а неправильні їх дані (ціни, наявність, описи), виправте дані в каталозі й запустіть вивантаження знову.
- Якщо шаблон працює з галочкою «Вивантажувати лише нові дані», товари з помилкового файлу вже мають позначку «Вивантажено» і повторно самі не підуть. Їх треба змінити в каталозі або зняти з них позначку «Вивантажено», інакше виправлення до файлу не потрапить.
- Що площадка встигла зробити з помилковим файлом до того, як забрала виправлений, залежить від площадки: коли вона перечитує файл і як обробляє зміни, програма не контролює.
Щоб помилка не пішла у файл наступного разу, налаштуйте «Стоп-правила вивантаження». Програма порівнює кількість товарів і наявність з минулим успішним прогоном цього шаблону. Прогін, після якого файл не замінено, для порівняння не береться. За замовчуванням усі три правила лише попереджають, а в режимі «Зупинити вивантаження» не дають замінити файл. Пороги діють і під час запуску за розкладом. Якщо фільтр шаблону не вдається перерахувати, журнал пише «Передпольотне зведення не розраховано…», і стоп-правила в такому прогоні не спрацьовують.
Межі
- Обмеження на кількість товарів у файлі програма не ставить. Виняток — демо-версія: там у файл потрапляє не більше 100 товарів, про що журнал попереджає окремим рядком.
- Файл збирається в робочій папці. Якщо прогін обірвався посередині, недозібраний файл лишається в робочій папці і за посиланням не з'являється.
Правки в кабінеті Епіцентру і наступне оновлення
Кожен прогін збирає файл заново з каталогу Elbuz. Ціна, стара ціна, назва, опис, фото, характеристики, габарити, вага й штрихкод беруться з картки товару в момент збирання. Те, що ви змінили в кабінеті Епіцентру, Elbuz не читає: канал односторонній. Тому у файлі за посиланням завжди значення з Elbuz, а не з кабінету.
- Якщо значення має триматися, змінюйте його в Elbuz: наступний файл понесе вже його.
- Якщо якесь поле ви хочете вести тільки в кабінеті, приберіть його рядок із шаблону XML. Чого немає в шаблоні, того немає й у файлі.
- Чи перезапише Епіцентр правки в кабінеті значеннями з файлу при наступному зчитуванні, вирішує майданчик. Програма на це не впливає, дивіться довідку Епіцентру про автооновлення.
Якщо змінили ідентифікатор або перестворили картки
Програма не надсилає Епіцентру команд «видали товар». Позиція, якої більше немає у файлі, з майданчика сама не зникає, тож задвоєння прибирається в кабінеті Епіцентру, а не в Elbuz.
- Якщо в шаблоні замінили ідентифікатор у рядку
offer, поверніть ту підстановку, з якою каталог вивантажувався раніше (у типовому шаблоні —{product_id}), і вивантажте знову. У файлі знову будуть ідентифікатори, які майданчик уже знає. Позиції, які Епіцентр встиг завести під новим ідентифікатором, лишаться в кабінеті, поки ви їх там не приберете. - Якщо картку в Elbuz видалили й створили заново, старий номер їй не повернути: нова картка йде у файл під новим номером. Стару позицію на майданчику прибирайте в кабінеті Епіцентру.
Що дає вимкнення шаблону
Перемикач «Активний» / «Вимкнений» у шапці форми шаблону змінює тільки те, чи запускається шаблон автоматично. Файл за посиланням він не чіпає.
- Якщо шаблон вимкнено, розклад його пропускає, і рядка про це в журналі немає. Так само його пропускають «Вивантажити всі шаблони» і черга завдань.
- Файл за посиланням лишається таким, яким його зібрав останній прогін. Епіцентр і далі забиратиме його, тобто отримуватиме ціни й залишки на момент останнього прогону.
- Кнопка «Вивантажити» для одного шаблону працює і для вимкненого: файл збереться й замінить попередній.
- Розклад при вимкненні не видаляється. Якщо шаблон увімкнути знову, наступний запуск за розкладом збере файл як раніше.
Сценарії
Віддавати на Епіцентр лише частину каталогу
Задача. На Епіцентр мають іти кілька груп товарів, а не весь каталог.
Що налаштувати. На вкладці «Обмеження вивантаження (фільтр)» шаблону задайте умову відбору, наприклад за категоріями чи виробником. Категоріям, які не мають потрапляти ні в який фід, можна вимкнути «Вивантажувати у файл (на сайт)», але ця позначка діє не тільки на шаблон Епіцентру, а й на інші XML-фіди.
Що вийде. У файл підуть лише товари, які пройшли умову. Чого не станеться: товари, які вже були на Епіцентрі й тепер випали з файлу, з майданчика самі не зникнуть. Програма не надсилає Епіцентру команд «видали товар», а що робити з позицією, якої немає у файлі, вирішує майданчик.
Вивантажувати тільки те, що є на одному складі
Задача. Замовлення з Епіцентру магазин відвантажує з одного складу, і на майданчику має бути лише те, що на ньому лежить.
Що налаштувати. На вкладці «Вибір даних для вивантаження», у блоці «Обмеження вивантаження», оберіть склад у полі «ID складу».
Що вийде. У файл підуть тільки товари, які на цьому складі є в наявності або мають залишок більше нуля. Чого не станеться: товар, що закінчився на складі, не піде у файл з позначкою «немає в наявності». Він зникне з файлу повністю, і далі діє те саме, що в попередньому сценарії: з кабінету Епіцентру позиція сама не прибирається.
Не показувати на Епіцентрі службову характеристику
Задача. У каталозі є характеристики для внутрішнього обліку, яких покупець бачити не повинен.
Що налаштувати. У такої характеристики зніміть позначку «Вивантаження на сайт (файл)».
Що вийде. Рядка param з цією характеристикою у файлі не буде. Чого не станеться: позначка належить характеристиці, а не шаблону, тож характеристика зникне з усіх XML-фідів, а не тільки з Епіцентру. І навпаки, стерти характеристиці «Epicentr: назва» чи «Epicentr: код», щоб її сховати, не вийде: без назви Епіцентру вона піде у файл під вашою назвою.
Не віддати Епіцентру обвалений фід
Задача. Якщо після збою в каталозі раптом зникла більшість товарів або вся наявність, такий файл не повинен дійти до майданчика.
Що налаштувати. У вікні вивантаження виділіть шаблон Епіцентру й відкрийте «Стоп-правила вивантаження» з меню панелі інструментів (або посиланням «Налаштувати пороги» у зведенні перед запуском). Для потрібних правил оберіть режим «Зупинити вивантаження» і натисніть «Зберегти для цього шаблону».
Що вийде. Якщо розбіжність із минулим успішним прогоном цього шаблону більша за поріг, прогін зупиняється ще до збирання файлу. У журналі з'являється «Вивантаження зупинено стоп-правилом», за посиланням лишається попередній файл. Так само це працює під час запуску за розкладом. Чого не станеться: у режимі «Попереджати» прогін не зупиняється, і файл замінюється. Самі дані в каталозі стоп-правило не виправляє: після виправлення запустіть вивантаження знову.
А як же API та токен Епіцентру
В Епіцентру є власний API з токенами — його використовують для інтеграції кабінету з CRM та іншими системами. Для вивантаження каталогу з Elbuz токен не потрібен: обмін іде XML-фідом, і жодного ключа в шаблон вивантаження вводити не треба. Якщо ви вже згенерували токен у кабінеті, це не помилка — просто він потрібен для інших сценаріїв, не для цього фіду.
Вкладка «API» з'являється в розділі «Налаштування» → «Налаштування компанії» після ввімкнення відповідного перемикача в додаткових налаштуваннях. Там кнопка «Згенерувати» створює токен, іконка поруч копіює його, а «Оновити ключ» видає новий (попередній лишається у списку активних). Токени не мають терміну дії й працюють, доки ви їх не видалите іконкою кошика; кількість не обмежена, усі створені ключі активні одночасно. Докладніше — у довідці Епіцентру про роботу з API.
Першоджерела: довідка Епіцентру
Вимоги майданчика змінюються, тому за спірними питаннями звіряйтеся з його власною довідкою:
- Формування XML-файлу — структура файлу, теги, типи характеристик, обмеження.
- Автооновлення — як підключити фід за посиланням і з якою періодичністю він читається.
- Загальні вимоги до контенту — правила назви, опису й характеристик.
- Вимоги до зображень — розміри, фон, що заборонено на фото.
- Робота з API — токени та можливості інтерфейсу майданчика.
Навіщо вести Епіцентр із Elbuz
Маркетплейс вимагає дисципліни: свої коди категорій, свої довідники характеристик, обов'язкові габарити й штрихкоди. Вести це вручну у файлі — робота, яку доводиться повторювати за кожної зміни асортименту. Коли каталог живе в Elbuz, зіставлення робиться один раз на рівні категорії й характеристики, а далі кожен новий товар успадковує його автоматично й потрапляє у фід правильно оформленим.
Другий аргумент — той самий, що й для інших каналів: Епіцентр рідко буває єдиним майданчиком. Коли ціни й залишки рахуються в одному місці за єдиними правилами націнок, усі канали отримують узгоджені дані, і не виникає ситуації, коли на одному майданчику товар уже закінчився, а на іншому ще продається.
Часті питання
Чи потрібен токен API, щоб вивантажувати товари на Епіцентр?
Ні. Вивантаження з Elbuz працює XML-фідом: ви передаєте майданчику посилання на файл, і жодного ключа вводити не треба. Токен потрібен для API Епіцентру — це інший сценарій, наприклад інтеграція кабінету з CRM.
Чому товари не приймаються, хоча фід формується?
Найчастіше — через незіставлені довідники. Перевірте, що в категорії заповнено «ID epicentrk.ua», а в характеристик — коди Епіцентру. Формально файл валідний і без них, але майданчик не розуміє, до якої категорії й до яких характеристик належить товар.
Категорія Епіцентру вказана шляхом — що потрапить у файл?
У файл іде код категорії, а назвою підставляється лише останній рівень шляху. Тобто зі шляху «Інструменти / Електроінструмент / Дрилі» у фіді буде «Дрилі». Повний шлях зберігається у вас для зручності орієнтування.
Якою мовою виїжджають назви й описи?
Українською — окремих полів для іншої мови в шаблоні Епіцентру немає. Якщо картка заповнена іншою мовою, саме цей текст і потрапить на майданчик, тож перевірте українські назви перед першим вивантаженням.
Що буде, якщо видалити товар і створити його заново?
Епіцентр упізнає товари за внутрішнім номером картки в Elbuz. У нової картки номер інший, тож майданчик сприйме її як окремий товар, а стара позиція лишиться «висіти». Виправляйте наявну картку замість перестворення.
Навіщо обов'язково заповнювати габарити й вагу?
За ними маркетплейс рахує доставку, тому вони виїжджають у фід окремими параметрами. Товар без габаритів і ваги майданчик або відхилить, або не зможе коректно обробити замовлення з ним.