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