Ця стаття — про зворотний бік обміну з майданчиками EVO (Prom.ua, satu.kz, deal.by): як вивантажити каталог із Elbuz у файл Excel того самого формату Prom, щоб завантажити його назад на маркетплейс. Формат вивантаження й формат завантаження в Prom однакові, тож імпорт та експорт тут — єдиний цикл. Про завантаження з такого файлу читайте парну статтю імпорт каталогу з XLSX (Prom/EVO), а про вивантаження загалом — шаблони вивантаження.
Офіційний опис на боці майданчика: Експорт товарів та груп товарів і формат файлу XLS(X)/CSV. Загальний розділ обміну — Імпорт та експорт у довідці Prom.
Де це у програмі
У вікні вивантаження ви створюєте шаблон і обираєте формат Prom. Elbuz одразу заповнює шаблон повним набором колонок Prom — вам не треба складати їх вручну. Далі ви обираєте, які товари вивантажувати (весь каталог, окремі категорії чи за правилами відбору), і формуєте файл. Його можна віддавати на Prom вручну або за розкладом.
Що формує вивантаження: два аркуші
Файл на виході має ту саму структуру, що й файл завантаження Prom — два аркуші:
- «Export Products Sheet» — товари з повним набором колонок Prom (назва, ціна, наявність, ідентифікатори, характеристики й десятки додаткових полів).
- «Export Groups Sheet» — структура груп (категорій): номери, назви, ідентифікатори та зв'язок «батько–дитина».
Саме тому файл, вивантажений із Elbuz, Prom приймає без переробки: це той самий формат, який майданчик віддає при власному експорті.
Звідки беруться значення
Колонки файлу заповнюються з полів картки товару. Частина — з рідних полів (назва, ціна, кількість, габарити, GTIN, категорія, виробник, опис, meta), а десятки Prom-специфічних колонок — із тих додаткових полів, які створив імпорт при першому завантаженні (оптова ціна, знижки, тип товару, спосіб пакування, ярлики, подарунки тощо). Тому вивантаження нічого не «вигадує»: воно віддає назад те, що прийшло з Prom, плюс ваші зміни.
Кілька значень формуються автоматично, якщо їх не задано: Тип_товару за замовчуванням r (роздріб), Валюта — ваша базова валюта, Одиниця_виміру — «шт.». Окремо цікаве поле Наявність: воно рахується формулою з поточного статусу наявності товару в каталозі (у наявності → +, немає → -, очікується → &). Тож на вивантаженні наявність завжди актуальна — така, яка зараз у вашій системі, а не застигла на моменті імпорту.
Ідентифікатори на виході — найважливіше
Саме ідентифікатори роблять обмін надійним. У файл вивантаження вони лягають так:
| Колонка Prom | Звідки береться в Elbuz |
|---|---|
| Ідентифікатор_товару | наш UUID товару — унікальний ключ позиції в каталозі. Заповнюється завжди, для кожного товару. |
| Унікальний_ідентифікатор | внутрішній номер Prom із додаткового поля. Якщо його немає (товар створено в Elbuz, а не прийшов з Prom) — колонка йде порожня. |
| Ідентифікатор_групи / Ідентифікатор_підрозділу | ідентифікатор категорії; якщо порожній — підставляється UUID категорії. |
Ключове тут — що Elbuz завжди проставляє Ідентифікатор_товару (наш UUID) у кожен рядок. Це принципово важливо для наступного розділу.
Чому Elbuz не задвоює товари на Prom
У Prom є відома пастка: якщо редагувати файл вручну й завантажувати назад без ідентифікаторів, майданчик не може відрізнити наявні товари від нових — і дублює їх (додає ще раз, як нові). Саме тому в довідці Prom радять спершу зробити експорт із кабінету, щоб у файлі проставились ідентифікатори, а вже потім вносити зміни.
З Elbuz цієї проблеми немає: вивантаження завжди кладе в колонку Ідентифікатор_товару наш UUID — для кожного товару, зокрема й для тих, що ви щойно створили в каталозі. Тому Prom бачить ідентифікатор у кожному рядку, впізнає наявні позиції й оновлює саме їх, а не плодить копії. Вам не треба «спершу експортувати з Prom, щоб отримати ідентифікатори» — Elbuz дає їх сам.
Порядок обміну з Prom крок за кроком
Повний цикл роботи виглядає так:
- 1. Завантаження. Заберіть каталог з Prom у Elbuz — імпортом XLSX. Кожен товар отримає UUID, що дорівнює його Ідентифікатору_товару на Prom.
- 2. Робота в Elbuz. Змінюйте ціни й наявність, редагуйте картки, додавайте нові товари. Нові позиції отримують власний UUID; поля «Унікальний_ідентифікатор» у них немає.
- 3. Вивантаження. Сформуйте файл вивантаження у форматі Prom. У ньому в кожного товару вже проставлено Ідентифікатор_товару (UUID), а в нових — порожній Унікальний_ідентифікатор.
- 4. Завантаження на Prom. Віддайте файл на майданчик. Наявні товари (чий Ідентифікатор_товару Prom знає) оновляться, нові — додадуться, і Prom присвоїть їм свій внутрішній номер.
Далі цикл повторюється: наступні вивантаження знову несуть ті самі UUID, тож Prom оновлює ті самі позиції. Повторно робити експорт із кабінету Prom, щоб «підхопити» ідентифікатори, не обов'язково — Elbuz уже проставляє їх сам.
Для того щоб оновлення на Prom проходили без дублів, зворотний імпорт не потрібен: зіставлення тримається на нашому UUID. Але періодично заново завантажувати каталог із Prom у Elbuz корисно з іншої причини — щоб підхопити зміни, зроблені на боці Prom (модерація, ручні правки в кабінеті, привласнений майданчиком Унікальний_ідентифікатор). Це «гігієна» синхронізації, а не умова її роботи.
XLSX чи XML/YML — що обрати
Prom підтримує обидва формати, і в кожного своя роль:
- XLSX (цей формат) — повний двобічний обмін: усі поля Prom, ідентифікатори проставляються автоматично, зручно, коли ви ведете каталог у Elbuz як головній системі й вивантажуєте на Prom усе, зокрема нові товари. Файловий обмін, ви керуєте кожним полем.
- XML / YML — простіший, фідовий формат. Prom оновлює позиції з YML «на порядок легше»: ви задаєте періодичність, і майданчик сам підтягує свіжі дані з фіда. Полів менше, зате оновлення автоматичні. Добре, коли треба переважно тримати актуальними ціни й наявність.
Практичне правило: якщо Elbuz — ваша головна система і ви керуєте повним каталогом (з новими товарами, характеристиками, усіма полями) — беріть XLSX. Якщо потрібне переважно автоматичне оновлення цін і наявності з мінімумом налаштувань — зручніший YML-фід. Обидва працюють через один і той самий принцип стабільного ідентифікатора; головне — не змішувати формати наосліп в одному напрямку, щоб не заплутати відповідність позицій.
Не редагуйте вручну колонки Ідентифікатор_товару та Унікальний_ідентифікатор у файлі. Це ключі синхронізації: Elbuz заповнює їх сам, а ручна зміна UUID наявного товару змусить Prom визнати його новим і задвоїти позицію.
Часті питання
Чому при ручному редагуванні файлу Prom задвоює товари, а через Elbuz — ні?
Prom дублює позиції, коли у файлі немає ідентифікаторів товарів і він не може відрізнити наявні від нових. Elbuz же завжди проставляє Ідентифікатор_товару (наш UUID) у кожен рядок вивантаження, тож Prom упізнає наявні товари й оновлює саме їх.
Чи треба знову експортувати з Prom після додавання нових товарів?
Для коректного оновлення без дублів — ні: Elbuz сам проставляє ідентифікатори. Заново завантажити каталог із Prom варто лише щоб підхопити зміни, зроблені на боці майданчика (модерація, ручні правки, номери, які Prom присвоїв новим товарам).
Як Prom підхопить новий товар, створений у Elbuz?
Такий товар вивантажується з власним UUID у колонці Ідентифікатор_товару й порожнім Унікальним_ідентифікатором. Prom бачить невідомий йому ідентифікатор і додає товар як новий, присвоївши свій внутрішній номер. Наявні товари при цьому оновлюються.
XLSX чи XML — що надійніше?
Це не про надійність, а про задачу. XLSX — повний двобічний обмін з усіма полями й автоматичними ідентифікаторами, коли Elbuz веде весь каталог. YML — простіший фід для автоматичного оновлення цін і наявності за розкладом. Обидва працюють на тому самому принципі стабільного ідентифікатора.
Чому наявність у файлі не така, як була при завантаженні?
Бо колонка «Наявність» рахується формулою з поточного статусу товару у вашому каталозі, а не береться зі старого файлу. Так на Prom завжди йде актуальна наявність.
Які поля потрапляють у файл вивантаження?
Повний набір колонок Prom: рідні поля картки (назва, ціна, кількість, габарити, GTIN, категорія, виробник, опис, meta) плюс десятки Prom-специфічних полів із додаткових полів, створених імпортом. Набір колонок можна скоригувати в налаштуваннях шаблону вивантаження.