Крім файлу Excel, Elbuz уміє віддавати каталог на Prom.ua у форматі XML — це YML-подібний фід, який майданчик забирає за посиланням і оновлює у себе за розкладом. Формат «prom.ua (XML)» — окремий від «prom.ua (XLS)»: XLSX — це файловий обмін в обидва боки, а XML — фід, що публікується за URL і сам підтримує каталог на Prom свіжим. Ця стаття — про XML-шлях; про файловий див. вивантаження на Prom (XLSX), а про завантаження з Prom — імпорт XLSX (Prom/EVO). Загальний огляд вивантаження — у статті шаблони вивантаження.
Офіційний опис формату фіда — у довідці Prom: Імпорт через YML — формат файлу. Загальний розділ обміну — Імпорт та експорт.
Де це у програмі
У вікні вивантаження ви створюєте шаблон і обираєте формат «prom.ua (XML)». Elbuz формує XML-фід із вашого каталогу; ви обираєте, які товари вивантажувати (весь каталог, категорії чи за правилами), і публікуєте фід за посиланням. Prom забирає це посилання й оновлює каталог у себе — вручну або за розкладом.
Що це за формат
Prom XML — це стандартний YML-фід: у корені yml_catalog, усередині — блок категорій і блок пропозицій (offers). Кожен товар — це один <offer> з набором вкладених елементів. На відміну від Excel-файлу, який ви завантажуєте руками, XML-фід живе за адресою: оновили каталог у Elbuz — фід за тим самим URL віддає свіжі дані, а Prom підхоплює їх за розкладом. Саме тому XML зручний для постійного автоматичного оновлення.
Структура пропозиції (offer)
Кожен товар у фіді виглядає приблизно так (набір полів можна змінювати в шаблоні):
| Елемент XML | Що містить |
|---|---|
| id — ідентифікатор товару (ваш UUID); available — поточна наявність; group_id — прив'язка різновиду до основного товару | |
| посилання на товар | |
| ціна та валюта | |
| ідентифікатор категорії товару | |
| зображення; для Prom кількість фото обмежена десятьма | |
| назва товару | |
| виробник та артикул (MPN) | |
| опис товару | |
характеристики (атрибути); для української версії — name_ua |
Категорії у фіді йдуть окремим блоком і несуть ідентифікатори Prom (внутрішній номер категорії на майданчику), щоб товари стали в правильні розділи каталогу Prom.
Ідентифікатор — той самий UUID, що і в XLSX
Найважливіше для надійного оновлення: id пропозиції у XML — це наш UUID товару, той самий ключ, що потрапляє в колонку «Ідентифікатор_товару» при вивантаженні в XLSX. Тобто ідентичність товару однакова в обох форматах Prom. Що це дає:
- Prom упізнає товар за
idі оновлює наявну позицію, а не плодить копії — так само, як з ідентифікатором у XLSX. - Новий товар, створений у Elbuz, іде у фід зі своїм новим UUID — Prom бачить невідомий
idі додає його як новий. - Оскільки ключ один (UUID), формати не «сваряться» між собою: товар лишається тим самим, хоч через XLSX, хоч через XML.
Елемент available береться з поточного статусу наявності товару в каталозі, тож у фіді наявність завжди свіжа. А group_id зв'язує різновиди (варіанти) з основним товаром — тому кольори й розміри одного товару лишаються згрупованими, а не розсипаються окремими картками.
Характеристики й різновиди
Характеристики товару виходять у фід елементами <param name="Назва" unit="одиниця">значення</param>, з окремим варіантом для української мови. Різновиди товару (варіанти) зв'язуються через group_id: основний товар і його варіанти мають спільну прив'язку, і Prom складає їх в одну картку з вибором варіанта. Фото у фіді обмежені десятьма на товар — це вимога самого Prom.
Публікація та оновлення за розкладом
Головна перевага XML-фіда — автоматизація. Фід публікується за посиланням, і Prom забирає його за заданою періодичністю: ви оновили ціни чи наявність у Elbuz — фід віддав нові дані — Prom оновив каталог у себе, без вашої участі. За словами самого Prom, оновлювати позиції через YML «на порядок легше», ніж файлом: досить один раз налаштувати фід і розклад. У Elbuz розклад вивантаження задають у налаштуваннях шаблону, а віддавати фід можна за прямим посиланням або на FTP.
XML чи XLSX — коли що
Обидва формати Prom спираються на той самий ідентифікатор (UUID), тож обидва оновлюють каталог без дублів. Різниця — у способі роботи:
- XML (YML-фід) — простіший, автоматичний шлях. Публікуєте посилання, ставите розклад — і каталог на Prom підтримується свіжим сам. Менше ручних дій, добре для постійного оновлення цін, наявності й асортименту.
- XLSX (файл) — повний двобічний файловий обмін з максимальним набором полів Prom. Зручно, коли треба разово вивантажити чи прийняти файл, попрацювати з ним у таблиці, керувати кожним полем.
Практичне правило: для щоденної автоматичної синхронізації зручніший XML-фід; для повного файлового обміну з усіма полями — XLSX. Оскільки ключ товару в них однаковий, можна навіть початково залити каталог файлом XLSX, а далі тримати його свіжим XML-фідом — ідентичність позицій при цьому не втратиться. Головне — не гнати в один і той самий бік два різні формати водночас, щоб не плутати, хто головне джерело.
XML-шаблон у Elbuz редагований: ви можете додати чи прибрати елементи <offer> під вимоги Prom. Але не чіпайте id пропозиції — це UUID товару, ключ синхронізації; його підстановку Elbuz робить сам, а ручна зміна призведе до задвоєння позицій на Prom.
Як налаштувати фід крок за кроком
Порядок простий і робиться один раз. Створіть шаблон вивантаження й оберіть формат «prom.ua (XML)». Визначте, які товари вивантажувати: весь каталог, окремі категорії чи за правилами відбору — так у фід потрапить саме те, що ви продаєте на Prom. За потреби відкоригуйте набір елементів <offer> під вимоги майданчика. Скористайтесь перевіркою («тест-прогон»), щоб побачити, як виглядає один товар у фіді, ще до повного вивантаження. Потім опублікуйте фід — отримаєте посилання, яке вставляється в кабінеті Prom, або віддавайте його на FTP.
Далі лишається задати розклад: як часто Elbuz оновлює фід і як часто Prom його забирає. Для активного магазину має сенс оновлювати частіше, для спокійного — раз на добу. Перші кілька разів варто зазирнути в журнал вивантаження й переконатися, що фід формується без помилок, а на боці Prom товари оновились як слід. Після цього обмін працює сам: ви змінюєте каталог у Elbuz, а Prom підтягує зміни за посиланням.
Часті питання
Чим XML відрізняється від XLSX для Prom?
XLSX — це файл, який ви завантажуєте й приймаєте вручну або за розкладом, з максимальним набором полів. XML — це фід за посиланням, який Prom забирає сам за розкладом і оновлює каталог. XML простіший для постійної автоматизації, XLSX — повніший для файлового обміну.
Який ідентифікатор товару у XML-фіді?
Атрибут id пропозиції — це UUID товару в Elbuz, той самий ключ, що й «Ідентифікатор_товару» у XLSX. Тому ідентичність товару однакова в обох форматах, і Prom оновлює позиції без дублів.
Як Prom підхопить нові товари з фіда?
Новий товар іде у фід зі своїм новим UUID у id. Prom бачить невідомий ідентифікатор і додає товар як новий. Наявні позиції (чий id Prom уже знає) оновлюються.
Чому у фіді не всі фото товару?
Для Prom кількість зображень у фіді обмежена десятьма на товар — це вимога майданчика. Перше фото вважається головним.
Чи треба щоразу вивантажувати фід вручну?
Ні. Фід публікується за посиланням, а Prom забирає його за розкладом. Достатньо один раз налаштувати шаблон і періодичність — далі каталог на Prom оновлюється автоматично.
Як передаються різновиди (варіанти) товару?
Через атрибут group_id: основний товар і його варіанти мають спільну прив'язку, і Prom складає їх в одну картку з вибором варіанта, а не показує окремими позиціями.