Як вивантажити каталог на Rozetka: XML-фід і API

Що вміє вивантаження на Rozetka

• Готовий шаблон Rozetka.UA — номер категорії, номер характеристики й кількість Rozetka стоять у ньому одразу.
• Обмеження Rozetka — фото, довжину характеристик і посилання в описі програма обрізає сама.
• Постійне посилання на файл — його один раз перевіряють у валідаторі Rozetka й передають майданчику.
• Одна правка зіставлення переносить у правильну категорію всі товари категорії.
• Зняття з продажу статусом наявності — картка лишається на майданчику.
• API-шаблон оновлює ціну, стару ціну й кількість між прогонами фіда.

Це один із трьох різних обмінів із Rozetka (у розмові частіше просто «Розетка»), і плутають їх постійно. Фід створює картки. API оновлює ціни й залишки товарів, які на майданчику вже є. А імпорт із Rozetka — навпаки, забирає каталог із майданчика до вас.

Де це і хто має доступ

Меню

Довідники → Операції → Вивантаження даних

Створити

«Додати» → тип Rozetka.UA

Налаштувати

картка шаблону: відбір товарів, шаблон XML, ім'я файлу, розклад

Право доступу

вікна «Вивантаження» і «Детальне налаштування шаблону вивантаження» у «Правах груп»

Підготувати

категорії й характеристики, зіставлені з Rozetka

Загальна механіка шаблонів — відбір товарів, доставка файлу, розклад, журнал — однакова для всіх типів і описана в статті про вивантаження товарів. Сам формат YML розібраний у статті про вивантаження у форматі YML. Тут — тільки те, що стосується Rozetka.

Як створити шаблон і віддати фід Rozetka

1. Зіставте категорії з довідником Rozetka. Достатньо тих, товари з яких ви збираєтеся продавати на майданчику, — решта може лишатися порожньою.
2. Зіставте характеристики всередині зіставлених категорій. Rozetka вимагає різний набір характеристик для різних категорій, і обов'язкові з них краще закрити повністю.
3. У вікні «Вивантаження даних» додайте шаблон типу Rozetka.UA. Замініть у шаблоні товару приклад адреси на адресу свого сайту (що їде в товар).
4. Запустіть шаблон і перевірте готовий файл: чи не порожній rz_id у категорій.
5. Скопіюйте посилання на файл кнопкою «Копіювати посилання».
6. Перевірте фід у кабінеті продавця Rozetka: «Управління товарами» → «Валідатор», вставте посилання в поле «Пряме посилання на файл» і натисніть «Перевірити». Статус перевірки з'явиться в таблиці під полем. Ще до реєстрації магазину фід можна перевірити публічним валідатором Rozetka: посилання або файл, e-mail і капча, звіт приходить на пошту. У формі шаблону Rozetka.UA його відкриває кнопка з галочкою в шапці вікна.
7. Передайте посилання Rozetka через підтримку: у кабінеті напишіть за темою «Робота з товарами, прайс-лист» → «Питання по вивантаженню XML» і вставте посилання у звернення. Кнопки «додати фід» у кабінеті немає, через API посилання теж не передається. Окремий сервіс на кшталт Pricecreator для цього не потрібен: Rozetka приймає фід із будь-якої системи, і Elbuz — одна з них.
8. Підключений фід з'являється рядком у «Управління товарами» → «Управління прайс-листами»: там видно посилання, період і дату останньої синхронізації. Позачергово забрати фід можна з меню рядка — «Синхронізувати», не частіше ніж раз на 3 години. Нові позиції після синхронізації лягають у «Товари» → «Нові». Їх надсилають на модерацію кнопкою «Відправити на модерацію» або вмикають у рядку прайс-листа «Автозаявку для нових» — тоді заявка створюється сама, за замовчуванням щодня о 08:00.
9. В Elbuz поставте шаблон на розклад.
10. Щоб ціни й залишки оновлювалися між прогонами фіда, а замовлення приходили в Elbuz, підключіть завантаження з Rozetka за API-ключем і API-шаблон вивантаження (фід чи API).

1

Пряме посилання на файл

2

Перевірити

3

Управління товарами → Валідатор

1. Пряме посилання на файл — вставте посилання, скопійоване кнопкою «Копіювати посилання» шаблону Rozetka.UA.
2. Перевірити — Rozetka завантажить фід і покаже статус перевірки в таблиці нижче.
3. Шлях у меню кабінету: «Управління товарами» → «Валідатор».

Rozetka забирає фід сама, за посиланням. Тому файл треба покласти туди, звідки майданчик його дістане: на ваш сайт, на FTP або у хмарне сховище — способи доставки описані в розділі «Куди лягає файл».

У скопійованому посиланні щоразу інший хвіст ?uuid=… — це мітка проти кешування. Сама адреса файлу від прогону до прогону не змінюється, тому в кабінеті Rozetka посилання переставляти не треба.

Що програма додає у фід саме для Rozetka

Коли ви створюєте шаблон типу Rozetka.UA, програма готує XML-шаблон із трьома відмінностями від базового YML. Саме через них фід або приймається майданчиком як слід, або заводить товари «кудись не туди».

Числа для rz_id і paramid зберігаються у ваших категоріях і характеристиках. Заповнюються вони один раз, у вікні зіставлення з маркетплейсами; колонки Rozetka видно й у довіднику атрибутів.

1

rz_id — ID категорії Rozetka

1. Сюди підставляється номер категорії з довідника Rozetka — без нього майданчик не знає, куди покласти товар.

Що потрапляє на майданчик

Склад товару в фіді стандартний для YML, плюс кількість для Rozetka.

Числа з вікна «Налаштування оновлення за наявністю товару» у XML-фід не потрапляють: там вони працюють на інші типи вивантаження. З цього вікна береться тільки available:

• для кожного статусу наявності у фід іде ваш текст із колонки «Назва на сайті (у файлі)»;
• якщо колонка порожня — true для статусу з ознакою «в наявності» і false для решти;
• для статусу, вимкненого в цьому вікні, — true тільки для «В наявності», для решти false.

1

Назва на сайті (у файлі)

2

Активність налаштування

3

Кількість

1. Назва на сайті (у файлі) — текст звідси потрапляє в available фіду дослівно; порожня комірка означає true/false за ознакою статусу.
2. Активність налаштування — знята галочка вмикає запасне правило (true лише для «В наявності»).
3. Кількість — у XML-фід Rozetka це число не потрапляє, stock_quantity береться з картки товару.

Що програма обріже саме для Rozetka

Три речі в товарі обробляються інакше, ніж у звичайному YML. Робиться це мовчки: окремих рядків у журналі про це немає.

• Фотографії — не більш ніж 15. Решта у файл не піде, навіть якщо в картці товару їх тридцять. Однакові посилання рахуються за одне. Якщо в полі «Максимальна кількість фотографій» стоїть менше число, працює воно.
• Значення характеристики — не довше за 255 символів. Довше значення обрізається, і на майданчик їде обрізок.
• З тексту прибираються картинки й посилання. Теги <img loading="lazy" alt="Як вивантажити каталог на Rozetka XML фід і API" title="Як вивантажити каталог на Rozetka XML фід і API"> і <a> вирізаються з полів товару, які підставляються в шаблон, — насамперед з опису.

Що перезапише повторне вивантаження і як зняти товар із продажу

Кожен прогін збирає файл з нуля: програма бере всі товари, що проходять відбір шаблону, і підставляє їх у шаблон XML із поточними значеннями каталогу. Кожен товар у файлі їде повним набором вузлів шаблону — надіслати окремо одне змінене поле фід не вміє. Звузити можна лише перелік товарів — прапорцем «Вивантажувати лише нові дані».

Той самий товар щоразу їде під тим самим UUID — за ним майданчик бачить оновлення старої позиції, а не нову.

На майданчик іде те, що є в шаблоні товару. Якщо назви ви ведете в кабінеті продавця, а не в Elbuz, приберіть із шаблону вузол <name> — чого немає у файлі, того Rozetka з фіда не отримає. Так само з описом, ціною, фотографіями. Галочки «не оновлювати це поле» у вивантаженні немає.

Як зняти товар із продажу

У фіді немає команди «видалити товар». Єдине, чим файл говорить про продаж, — ознака наявності й кількість усередині самого товару. Позиція, якої у файлі немає, не несе майданчику жодного сигналу. Тому, щоб припинити продаж, лишіть позицію у фіді зі статусом наявності, який дає available="false" (сценарій), а не викидайте її з відбору.

Товар зникає з файлу, щойно перестає проходити відбір шаблону: знято прапорець вивантаження, вимкнено категорію, не пройдено «Додатковий фільтр» тощо. Повний перелік умов — у розділі «Чому товар не поїхав у файл». Для Rozetka важливі ще дві:

• товар є товаром-опцією (варіантом), а в шаблоні не відмічено «Опції» — у новому шаблоні ця галочка знята;
• у шаблоні обрано склад, на якому в товару немає ані залишку, ані статусу «В наявності».

Як виправити товари, що поїхали не в ту категорію

Виправляти доведеться не товари. Номер категорії Rozetka лежить у вашій категорії, тому одна правка в зіставленні міняє rz_id одразу всім її товарам.

1. Відкрийте вікно зіставлення й знайдіть категорію з неправильним номером.
2. Замініть зіставлення на правильне (як замінити зв'язок).
3. Запустіть вивантаження ще раз і дочекайтеся, поки Rozetka забере свіжий файл за своїм розкладом.

У характеристик зіставлень два рівні: загальне для характеристики й окреме всередині конкретної категорії. Зіставлення в категорії головніше — якщо воно заповнене, у paramid поїде саме воно. Тому характеристику, яка в різних категоріях Rozetka значить різне, зіставляють на рівні категорії.

Розклад, обрив і пауза фіда

Розклад в Elbuz має спрацьовувати не рідше, ніж Rozetka приходить за файлом. Інакше майданчик забиратиме вчорашні ціни, і виглядатиме це як «Elbuz не оновлює дані». Як задати розклад і що буде, якщо два шаблони збігаються в часі, — у розділі «Запуск руками і за розкладом».

Якщо прогін обірвався

Обрив посеред прогону не псує того, що вже віддано Rozetka: файл збирається в тимчасовій теці й потрапляє на постійну адресу цілком, останнім кроком. За посиланням лишається файл минулого прогону — цілий, хоч і вчорашній, а колонка «Останнє вивантаження» — зі старою датою.

Повторювати обірваний прогін безпечно: наступний запуск збирає файл заново. Як розпізнати обрив за журналом — у розділі «Журнал прогону».

Вимкнути шаблон чи видалити

• Вимкнули шаблон перемикачем «Стан». Розклад його пропускає мовчки. Файл за посиланням лишається таким, яким його зібрав останній прогін, і Rozetka продовжує забирати його: ціни й залишки застигають на момент вимкнення. Помилки майданчик не бачить.
• Увімкнули назад. Найближчий прогін за розкладом збере файл на ту саму адресу.
• Видалили шаблон. Сам файл у сховищі не видаляється — посилання лишається робочим і віддає останній зібраний файл. Щоб Rozetka справді перестала брати ваш каталог, приберіть посилання в кабінеті продавця.

Скільки поміститься у фід

Стелі за кількістю товарів немає: скільки пройде відбір, стільки й піде у файл. На демонстраційному акаунті у вивантаження потрапляє не більш ніж 100 товарів. Прогін звітує кожні 500 товарів рядком «Вивантаження товарів ‹N› із ‹M›» — число росте, прогін іде. Якщо фід для Rozetka великий, рознесіть його з іншими шаблонами в часі.

Фід чи API — що коли

У Rozetka є другий канал обміну, і він вирішує інші завдання.

В API-шаблоні вивантаження ключ вставляють у поле «Пароль кабінету продавця Rozetka або API-ключ (gapi_…)» — логін тоді можна лишити порожнім. Шаблон, налаштований раніше з логіном і паролем, працює й далі.

Типовий робочий набір — обидва: фідом заводять і поповнюють асортимент, API тримає ціни й залишки свіжими між вивантаженнями фіда й повертає в Elbuz те, що сталося із замовленнями.

Що саме надсилає API

Тільки три величини: ціну, стару ціну й кількість — і тільки тим товарам, у яких уже є номер картки Rozetka. Назви, описи, фото й характеристики API не чіпає. Позиції без номера картки він пропускає й пише в журнал: «Rozetka: пропущено позицій без прив`язки до товарів майданчика: ‹N› (картки створюються вивантаженням YML-фіда)».

Номер картки приходить не з фіда, а зі зворотного напрямку — його приносить завантаження каталогу Rozetka. Порядок: фід заводить картки → завантаження каталогу приносить в Elbuz їхні номери → API оновлює по них ціни й залишки. Поки другого кроку не було, API пропускатиме все.

• Різкий рух ціни застосовується не одразу. Ціна, змінена більш ніж у 1,5 раза вгору або у 2 рази вниз, іде на перевірку менеджеру майданчика. Після прогону Elbuz пише: «Rozetka: цін очікує підтвердження менеджера майданчика: ‹N›». Решта цін із того самого прогону вже застосована.
• Порожня стара ціна стирає перекреслену ціну на майданчику. Якщо стара ціна в Elbuz не заповнена, API надсилає замість неї −1, і Rozetka прибирає стару ціну з картки.
• Позиції йдуть пачками по сто за запит, а в журнал після кожної лягає рядок «Rozetka: оновлено позицій: ‹N› з ‹M›».

Хто головніший, коли обидва пишуть ціну

Пріоритету між каналами немає: це два окремі шаблони з власним відбором, розкладом і джерелом ціни. У фіді ціна підставляється макросом із шаблону XML, в API-шаблоні вона задається у списку полів. Зведіть обидва до одного поля ціни — і розбіжності не буде. Якщо поля різні, фід переписує ціну всіх відібраних товарів, а API — тільки тих, у яких є номер картки.

Сценарії

Завести товари на Rozetka й тримати ціни свіжими між фідами

Що налаштувати. Три шаблони, кожен зі своїм розкладом: шаблон типу Rozetka.UA для фіда, завантаження каталогу Rozetka і API-шаблон Rozetka з API-ключем кабінету продавця.

Що вийде. Фід заводить картки. Завантаження каталогу приносить в Elbuz номери цих карток і зберігає їх біля ваших товарів. API-шаблон надсилає по цих номерах ціну, стару ціну й кількість.

Чого не буде. API не створить картку й не змінить назву, опис, фото чи характеристики. Товар, якого ще немає в завантаженому каталозі, API пропустить. Різко змінена ціна не застосується, поки її не перевірить менеджер Rozetka.

Припинити продаж позиції, не прибираючи картку

Що налаштувати. Поставте товару статус наявності, відмінний від «В наявності», — наприклад, «Немає в наявності» — і лишіть товар у відборі шаблону. У вікні «Налаштування оновлення за наявністю товару» для цього статусу лишіть колонку «Назва на сайті (у файлі)» порожньою або впишіть туди false.

Що вийде. Позиція лишається у фіді, а в available іде false. Статус «під замовлення» без власного тексту в тій колонці теж дає false.

Чого не буде. Текст із колонки іде у фід дослівно: слово на кшталт «Немає» опиниться в available замість false. Якщо в шаблоні обрано склад, товар без залишку й без статусу «В наявності» на цьому складі випаде з відбору зовсім.

Поставити фід на паузу

Що налаштувати. Вимкніть шаблон перемикачем у колонці «Стан».

Що вийде. Розклад пропускає шаблон, файл за посиланням лишається тим, який зібрав останній прогін. Перевірити фід можна кнопкою запуску — вона працює і для вимкненого шаблону.

Чого не буде. Rozetka не дізнається про паузу: вона далі забирає останній файл із цінами й наявністю на момент вимкнення. Щоб майданчик перестав продавати позиції, потрібен попередній сценарій або прибране посилання в кабінеті продавця.

Одна характеристика означає різне в різних категоріях Rozetka

Що налаштувати. У вікні зіставлення зіставте характеристику всередині кожної категорії, де вона потрібна, а не тільки загально.

Що вийде. Для товарів цієї категорії в paramid іде номер із категорійного зіставлення. З назвою характеристики Rozetka так само: категорійна головніша за загальну. Якщо назви Rozetka немає ніде, іде ваша назва характеристики.

Чого не буде. У категоріях без категорійного зіставлення товари й далі їдуть із загальним номером.

Що робити, коли товари не завелися на Rozetka

Часті запитання

Що таке rz_id і звідки він береться?

Це номер категорії в довіднику самої Rozetka. Він зберігається у вашій категорії після зіставлення з категорією майданчика і підставляється у фід автоматично. Вписувати його в шаблон руками не треба.

Чи потрібно зіставляти всі категорії каталогу?

Ні, тільки ті, товари з яких ви продаєте на Rozetka. Незіставлені категорії поїдуть без номера майданчика, а якщо їхні товари не проходять відбір — не поїдуть узагалі.

Чи можна обійтися без фіда, самим лише API?

Ні, якщо товарів на майданчику ще немає: API оновлює ціни й залишки вже заведених карток, а створює картки саме фід.

Як перевірити фід до того, як віддавати його майданчику?

Зробіть пробний прогін у картці шаблону — програма збере той самий файл із позначкою test_ в імені. Відкрийте його й перевірте: чи не порожній rz_id, чи правильні посилання на товари, чи є ціни.

Я поправив назву товару в кабінеті Rozetka. Наступний фід її перезапише?

Фід віддає значення з каталогу Elbuz — про правку в кабінеті він не знає. Якщо поле ви ведете на боці майданчика, приберіть відповідний вузол із шаблону товару (що перезапише фід).

Вивантаження на Розетку пише «пропущено позицій без прив`язки до товарів майданчика». Чому?

Це рядок API-шаблону, а не фіда. API оновлює тільки товари з номером картки Розетки, а номер приносить завантаження каталогу Rozetka. Заведіть картки фідом → завантажте каталог → наступний прогін API оновить ці товари.

Змінив ціни, а на Розетці частина не застосувалась: «очікує підтвердження менеджера». Що це?

Правило самої Розетки: ціна, змінена більш ніж у 1,5 раза вгору або у 2 рази вниз, застосовується після перевірки менеджером. Elbuz її надіслав, інші ціни прогону вже застосовані. Стан таких цін дивіться в кабінеті продавця.

Я бачу такий самий шаблон у Kasta. Це те саме?

Фіди для Rozetka й Kasta зібрані за однією схемою: обидва чекають номер своєї категорії й своєї характеристики. Довідники в них різні, тому й зіставлення для кожного своє.

Суміжні теми

• Якщо категорії й характеристики ще не зіставлені з Rozetka — Зіставлення категорій із маркетплейсами.
• Якщо товар не потрапив у файл або треба налаштувати відбір, доставку й розклад — Вивантаження товарів на маркетплейс, сайт і у файл.
• Якщо API пропускає товари без номера картки — Імпорт каталогу з Rozetka.
• Якщо ви виставляєте товари ще й на Епіцентр — Вивантаження каталогу на Епіцентр.