Elbuz збирає з каталогу XML-фід для Епіцентру з кодами його категорій і характеристик, а майданчик сам забирає файл за посиланням і оновлює ваші товари, ціни й наявність.
Коли це знадобиться:
- Ви виходите на Епіцентр — шаблон «epicentrk.ua (XML)» уже має структуру файлу під вимоги майданчика.
- Нові товари мають іти на майданчик без ручної роботи — зіставлення робиться один раз на категорію, нові товари його успадковують.
- Ціни й залишки рахуються в Elbuz для кількох каналів — Епіцентр отримує ті самі дані, що й інші майданчики.
- Каталог після збою обвалився — стоп-правило не віддасть такий фід майданчику.
З чого почати: порядок підключення — від зіставлення довідників до посилання в кабінеті Епіцентру.
Що вміє вивантаження на Епіцентр
- Готова структура фіда — коди категорії й характеристик, габарити, вага, штрихкод.
- Коди з вашого каталогу — зіставлення категорій і характеристик підставляється у файл саме.
- Постійне посилання — Епіцентр забирає файл за своїм розкладом.
- Перезбирання за розкладом — свіжі ціни й залишки до моменту зчитування.
- Відбір асортименту — частина каталогу, один склад, без службових характеристик.
Де це і хто має доступ
- Меню
- Довідники → Операції → Вивантаження даних
- Створити
- «Додати» → тип «epicentrk.ua (XML)»
- Право доступу
- вікна «Вивантаження» і «Детальне налаштування шаблону вивантаження» у «Правах груп»
- Підготувати
- коди категорій і характеристик Епіцентру, габарити в міліметрах, вагу в грамах
Один шаблон — один фід. Загальна механіка шаблонів — відбір, доставка файлу, розклад, журнал — описана в статті про вивантаження товарів; тут — тільки те, що стосується Епіцентру.
1
Назва і тип шаблону2
Блок налаштувань фіда- Назва і тип шаблону — заголовок форми показує тип фіда epicentrk.ua (XML) та його ID.
- Блок налаштувань фіда — перелік даних, які потрапляють у вивантаження: категорії, товари, фото, атрибути.
У формі шаблону дві вкладки. На вкладці «Вибір даних для вивантаження» галочками задається склад фіду — для Епіцентру потрібні Категорії, Товари, Фото й Атрибути; окремий перемикач «Вивантажувати лише нові дані» лишають вимкненим, коли майданчик має отримувати повний каталог. Вкладка «Обмеження вивантаження (фільтр)» звужує асортимент, якщо на Епіцентр їде не весь каталог.
Нижче у формі показано сам шаблон XML — текст файлу з підстановками виду {Поле}. Його видно й можна редагувати: програма сама розмножує рядок категорії та рядок товару, а підстановки підбираються по Ctrl+Space. Міняти шаблон варто лише тоді, коли Епіцентр попросив щось специфічне: типовий уже відповідає вимогам майданчика.
Як підключити Епіцентр: від нуля до товарів на майданчику
- Отримайте довідники Епіцентру. Вам потрібні коди кінцевих категорій і коди характеристик (наборів атрибутів) майданчика. Їх видає сам Епіцентр — через кабінет або запитом до свого довідника.
- Зіставте категорії в Elbuz (як). У кожній категорії заповніть «ID epicentrk.ua» і «Категорія epicentrk.ua». Робиться один раз: усі нові товари категорії успадкують зіставлення.
- Зіставте характеристики. Проставте коди й назви Епіцентру характеристикам, а для списків — ще й коди значень.
- Підготуйте картки. Українські назва й опис і фото за вимогами Епіцентру, габарити в міліметрах, вага в грамах, штрихкод.
- Створіть шаблон вивантаження типу «epicentrk.ua (XML)», оберіть склад даних і за потреби звузьте асортимент фільтром.
- Перевірте файл. Сформуйте вивантаження один раз вручну й подивіться результат: чи всі товари потрапили, чи не порожні коди категорій.
- Передайте посилання на фід Епіцентру й увімкніть автооновлення на їхньому боці.
- Поставте шаблон на розклад в Elbuz, щоб файл перезбирався зі свіжими цінами та залишками.
Кроки 1–3 — найдовші, але одноразові. Далі робота зводиться до підтримки карток у порядку: нові товари підхоплюються фідом автоматично, якщо їхня категорія вже зіставлена.
Що потрапляє на майданчик
Епіцентр працює за своїми довідниками: категорію й кожну характеристику товару треба назвати кодом Епіцентру, а не вашою назвою.
| Елемент фіду | Звідки береться в 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 підставить вашу власну назву характеристики — файл буде коректним, але майданчик таку характеристику може не впізнати. Колонки Epicentr спільні для всіх категорій (довідник атрибутів).
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
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 у формі вивантаження.
Так само за потреби можна додати окремий тег наявності зі значеннями «в наявності / під замовлення / немає»: Епіцентр віддає йому перевагу перед звичайною ознакою наявності.
Де звірити вимоги: довідка Епіцентру
Вимоги майданчика змінюються, тому за спірними питаннями звіряйтеся з його власною довідкою:
- Формування XML-файлу — структура файлу, теги, типи характеристик, обмеження.
- Автооновлення — як підключити фід за посиланням і з якою періодичністю він читається.
- Загальні вимоги до контенту — правила назви, опису й характеристик.
- Вимоги до зображень — розміри, фон, що заборонено на фото.
- Робота з API — токени та можливості інтерфейсу майданчика.
Як увімкнути автооновлення на боці Епіцентру
Фід сам по собі нічого не оновлює — його має забирати майданчик. У кабінеті Епіцентру це вмикається так: розділ «Товари» → «Імпорт», підрозділ «Автооновлення залишків», куди ви вставляєте посилання на свій фід і натискаєте «Зберегти». Після збереження майданчик повідомить, що імпорт запущено.
| Що | Як це працює |
|---|---|
| Періодичність за замовчуванням | Один раз на добу, о 24:00 за UTC |
| Частіше | Раз на 12, 4 або 1 годину — вмикається лише через вашого менеджера або підтримку Епіцентру |
| За чим впізнаються товари | За артикулом: значення у фіді має точно збігатися з артикулом товару в кабінеті, інакше оновлення не спрацює |
| Якщо товар зник із фіду | Майданчик не прибирає його автоматично — потрібно окремо позначити опцію зміни статусу на «Немає в наявності» |
Розкладів насправді два: в Elbuz фід перезбирається, а в Епіцентрі — забирається. Немає сенсу перезбирати файл щогодини, якщо майданчик читає його раз на добу. Зробіть навпаки: спершу дізнайтеся у свого менеджера, з якою періодичністю Епіцентр забиратиме фід, і поставте оновлення в Elbuz трохи частіше — так до моменту зчитування у файлі завжди будуть свіжі дані.
Розклад і оновлення фіда
Коли шаблон налаштовано, поставте його на розклад — і фід перезбиратиметься сам. Частоту обирайте за темпом змін і за періодичністю читання на боці майданчика (автооновлення). Як задати розклад — у розділі «Запуск руками і за розкладом». Кожен запуск лишає слід у журналі: скільки товарів потрапило у файл, чи були помилки — туди варто заглянути після перших прогонів.
Корисно час від часу звіряти кількість позицій у фіді з тим, скільки ви очікуєте віддати. Якщо число менше, причину шукайте в умовах відбору шаблону. Незіставлена категорія чи порожні габарити товар із файлу не прибирають: такий товар потрапляє у фід з порожніми значеннями, і відхиляє його вже Епіцентр.
Кожен прогін збирає файл заново, а за посиланням до кінця прогону лежить попередній файл: обрив, стоп-правило чи помилка заливання його не чіпають. Що потрапляє у файл, коли він замінюється і як за журналом зрозуміти, що файл зібрано, — у розділі «Файл вивантаження».
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Правки в кабінеті Епіцентру і наступне оновлення
Кожен прогін збирає файл заново з каталогу Elbuz. Ціна, стара ціна, назва, опис, фото, характеристики, габарити, вага й штрихкод беруться з картки товару в момент збирання. Те, що ви змінили в кабінеті Епіцентру, Elbuz не читає: канал односторонній. Тому у файлі за посиланням завжди значення з Elbuz, а не з кабінету.
- Якщо значення має триматися, змінюйте його в Elbuz: наступний файл понесе вже його.
- Якщо якесь поле ви хочете вести тільки в кабінеті, приберіть його рядок із шаблону XML. Чого немає в шаблоні, того немає й у файлі.
- Чи перезапише Епіцентр правки в кабінеті значеннями з файлу при наступному зчитуванні, вирішує майданчик. Програма на це не впливає, дивіться довідку Епіцентру про автооновлення.
Якщо змінили ідентифікатор або перестворили картки
Програма не надсилає Епіцентру команд «видали товар». Позиція, якої більше немає у файлі, з майданчика сама не зникає, тож задвоєння прибирається в кабінеті Епіцентру, а не в Elbuz.
- Якщо в шаблоні замінили ідентифікатор у рядку
offer, поверніть ту підстановку, з якою каталог вивантажувався раніше (у типовому шаблоні —{product_id}), і вивантажте знову. У файлі знову будуть ідентифікатори, які майданчик уже знає. Позиції, які Епіцентр встиг завести під новим ідентифікатором, лишаться в кабінеті, поки ви їх там не приберете. - Якщо картку в Elbuz видалили й створили заново, старий номер їй не повернути: нова картка йде у файл під новим номером. Стару позицію на майданчику прибирайте в кабінеті Епіцентру.
Що дає вимкнення шаблону
Перемикач «Активний» / «Вимкнений» у шапці форми шаблону змінює тільки те, чи запускається шаблон автоматично. Файл за посиланням він не чіпає.
- Якщо шаблон вимкнено, розклад його пропускає, і рядка про це в журналі немає. Так само його пропускають «Вивантажити всі шаблони» і черга завдань.
- Файл за посиланням лишається таким, яким його зібрав останній прогін. Епіцентр і далі забиратиме його, тобто отримуватиме ціни й залишки на момент останнього прогону.
- Кнопка «Вивантажити» для одного шаблону працює і для вимкненого: файл збереться й замінить попередній.
- Розклад при вимкненні не видаляється. Якщо шаблон увімкнути знову, наступний запуск за розкладом збере файл як раніше.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Чи потрібен токен API Епіцентру
В Епіцентру є власний API з токенами — його використовують для інтеграції кабінету з CRM та іншими системами. Для вивантаження каталогу з Elbuz токен не потрібен: обмін іде XML-фідом, і жодного ключа в шаблон вивантаження вводити не треба. Якщо ви вже згенерували токен у кабінеті, це не помилка — просто він потрібен для інших сценаріїв, не для цього фіду.
Вкладка «API» з'являється в розділі «Налаштування» → «Налаштування компанії» після ввімкнення відповідного перемикача в додаткових налаштуваннях. Там кнопка «Згенерувати» створює токен, іконка поруч копіює його, а «Оновити ключ» видає новий (попередній лишається у списку активних).
Токени не мають терміну дії й працюють, доки ви їх не видалите іконкою кошика; кількість не обмежена, усі створені ключі активні одночасно. Докладніше — у довідці Епіцентру про роботу з API.
Сценарії
Віддавати на Епіцентр лише частину каталогу
Задача. На Епіцентр мають іти кілька груп товарів, а не весь каталог.
Що налаштувати. На вкладці «Обмеження вивантаження (фільтр)» шаблону задайте умову відбору, наприклад за категоріями чи виробником. Категоріям, які не мають потрапляти ні в який фід, можна вимкнути «Вивантажувати у файл (на сайт)», але ця позначка діє не тільки на шаблон Епіцентру, а й на інші XML-фіди.
Що вийде. У файл підуть лише товари, які пройшли умову. Чого не станеться: товари, які вже були на Епіцентрі й тепер випали з файлу, з майданчика самі не зникнуть. Програма не надсилає Епіцентру команд «видали товар», а що робити з позицією, якої немає у файлі, вирішує майданчик.
Вивантажувати тільки те, що є на одному складі
Задача. Замовлення з Епіцентру магазин відвантажує з одного складу, і на майданчику має бути лише те, що на ньому лежить.
Що налаштувати. На вкладці «Вибір даних для вивантаження», у блоці «Обмеження вивантаження», оберіть склад у полі «ID складу».
Що вийде. У файл підуть тільки товари, які на цьому складі є в наявності або мають залишок більше нуля. Чого не станеться: товар, що закінчився на складі, не піде у файл з позначкою «немає в наявності». Він зникне з файлу повністю, і далі діє те саме, що в попередньому сценарії: з кабінету Епіцентру позиція сама не прибирається.
Не показувати на Епіцентрі службову характеристику
Задача. У каталозі є характеристики для внутрішнього обліку, яких покупець бачити не повинен.
Що налаштувати. У такої характеристики зніміть позначку «Вивантаження на сайт (файл)».
Що вийде. Рядка param з цією характеристикою у файлі не буде. Чого не станеться: позначка належить характеристиці, а не шаблону, тож характеристика зникне з усіх XML-фідів, а не тільки з Епіцентру. І навпаки, стерти характеристиці «Epicentr: назва» чи «Epicentr: код», щоб її сховати, не вийде: без назви Епіцентру вона піде у файл під вашою назвою.
Не віддати Епіцентру обвалений фід
Задача. Якщо після збою в каталозі раптом зникла більшість товарів або вся наявність, такий файл не повинен дійти до майданчика.
Що налаштувати. У вікні вивантаження виділіть шаблон Епіцентру й відкрийте «Стоп-правила вивантаження» з меню панелі інструментів (або посиланням «Налаштувати пороги» у зведенні перед запуском). Для потрібних правил оберіть режим «Зупинити вивантаження» і натисніть «Зберегти для цього шаблону».
Що вийде. Якщо розбіжність із минулим успішним прогоном цього шаблону більша за поріг, прогін зупиняється ще до збирання файлу. У журналі з'являється «Вивантаження зупинено стоп-правилом», за посиланням лишається попередній файл. Так само це працює під час запуску за розкладом.
Чого не станеться. у режимі «Попереджати» прогін не зупиняється, і файл замінюється. Самі дані в каталозі стоп-правило не виправляє: після виправлення запустіть вивантаження знову.
Що робити, коли Епіцентр не приймає товари
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Фід формується, а товари не приймаються | у категорії не заповнено «ID epicentrk.ua» або в характеристик немає кодів Епіцентру — файл формально валідний, але майданчик не розуміє, куди покласти товар | зіставте категорії й характеристики (як) |
| Характеристика на майданчику не впізнається | не заповнені «Epicentr: назва» чи «Epicentr: код» — у файл іде ваша назва з порожніми кодами | заповніть коди у вікні зіставлення |
| Товар на Епіцентрі «важить 2 грами» або має дивні розміри | габарити записані в сантиметрах, вага в кілограмах — Elbuz віддає значення без перерахунку | заповніть Ширину, Висоту, Глибину в міліметрах, Вагу — у грамах |
| На майданчику назва чи опис не українською | у фід іде лише українська назва й опис картки | заповніть українські тексти картки (підготовка карток) |
| На Епіцентрі задвоєні позиції | змінили ідентифікатор у шаблоні або перестворили картку в Elbuz | поверніть ідентифікатор і приберіть зайві позиції в кабінеті (як) |
| Товар випав із фіда, а на Епіцентрі досі продається | майданчик не прибирає товар, якого немає у файлі | позначте в кабінеті опцію зміни статусу на «Немає в наявності» (автооновлення) |
| Ціни на Епіцентрі не оновлюються, помилок у журналі немає | шаблон вимкнено або Епіцентр читає файл раз на добу | увімкніть шаблон (про вимкнення); частіше читання вмикає менеджер Епіцентру |
| «Вивантаження зупинено стоп-правилом» | розбіжність із минулим прогоном більша за поріг | перевірте каталог і запустіть вивантаження знову (стоп-правило) |
Часті запитання
Категорія Епіцентру вказана шляхом — що потрапить у файл?
У файл іде код категорії, а назвою підставляється лише останній рівень шляху: зі шляху «Інструменти / Електроінструмент / Дрилі» у фіді буде «Дрилі».
Якою мовою виїжджають назви й описи?
Українською — окремих полів для іншої мови в шаблоні Епіцентру немає. Російську назву за потреби додають рядком у шаблон XML.
Що буде, якщо видалити товар і створити його заново?
Епіцентр упізнає товари за внутрішнім номером картки в Elbuz. У нової картки номер інший, тож майданчик сприйме її як окремий товар, а стара позиція лишиться «висіти». Виправляйте наявну картку замість перестворення.
Навіщо обов'язково заповнювати габарити й вагу?
За ними маркетплейс рахує доставку, тому вони виїжджають у фід окремими параметрами. Товар без габаритів і ваги майданчик або відхилить, або не зможе коректно обробити замовлення з ним.
Як отримати замовлення з Епіцентру?
Фід тільки публікує асортимент. Замовлення забирає окремий шаблон — завантаження з Епіцентру; рядки замовлень він зіставляє з товарами за тим самим ідентифікатором, що й у фіді.
Суміжні теми
- Якщо категорії й характеристики ще не мають кодів Епіцентру — Зіставлення категорій із маркетплейсами.
- Якщо товар не потрапив у файл або треба налаштувати відбір і розклад — Вивантаження товарів на маркетплейс, сайт і у файл.
- Якщо треба забирати замовлення з Епіцентру — Завантаження з Епіцентру.
- Якщо ви виставляєте товари ще й на Rozetka — Вивантаження каталогу на Rozetka.