XML-фід для Rozetka — це файл, з якого майданчик заводить і оновлює ваші картки товарів. Ви віддаєте Rozetka посилання на файл, вона забирає його за розкладом, і в кабінеті продавця з'являються товари з назвами, описами, фотографіями, характеристиками й цінами. Формат — YML, той самий, що використовують інші майданчики, але з трьома доповненнями, без яких Rozetka фід не прийме як слід.
Це один із трьох різних обмінів із Rozetka, і плутають їх постійно. Фід створює картки. API оновлює ціни й залишки товарів, які на майданчику вже є, і повертає статуси замовлень. А імпорт із Rozetka — навпаки, забирає каталог із майданчика до вас.
Де це у програмі
- Меню
- Довідники → Вивантаження даних
- Створити
- додати шаблон → тип Rozetka.UA
- Налаштувати
- картка шаблону: відбір товарів, шаблон XML, ім'я файлу, розклад
Загальна механіка шаблонів — відбір товарів, доставка файлу, розклад, пробний прогін — однакова для всіх типів і описана в статті про вивантаження товарів. Сам формат YML розібраний у статті про вивантаження у форматі YML. Тут — тільки те, що стосується Rozetka.
Чим фід Rozetka відрізняється від звичайного YML
Коли ви створюєте шаблон типу Rozetka.UA, програма готує XML-шаблон із трьома відмінностями від базового YML. Знати їх варто, бо саме через них фід або приймається майданчиком як слід, або заводить товари «кудись не туди».
| Відмінність | Як виглядає | Навіщо |
|---|---|---|
| Ідентифікатор категорії майданчика | у категорії з'являється атрибут rz_id | Rozetka кладе товар у свою категорію, а не у вашу. Без цього числа майданчик не знає, куди подіти товар |
| Ідентифікатор характеристики майданчика | у характеристики з'являється атрибут paramid | Rozetka зіставляє вашу характеристику зі своєю за номером, а не за назвою — «Діагональ» і «Діагональ екрану» для неї різні речі |
| Кількість | додається вузол stock_quantity | у базовому YML є тільки ознака «є / немає», а Rozetka показує покупцеві залишок числом |
Ці три речі програма підставляє в шаблон сама, коли ви обираєте тип Rozetka.UA. Переписувати шаблон руками не потрібно — але якщо ви його вже правили, звіряйтеся з цією таблицею: зникнення rz_id чи paramid зовні виглядає як «фід начебто нормальний, а товари на майданчику не заводяться».
1
rz_id — ID категорії Rozetka- Сюди підставляється номер категорії з довідника Rozetka — без нього майданчик не знає, куди покласти товар.
Головна підготовка: зіставити категорії й характеристики
Числа для rz_id і paramid беруться не з повітря — вони зберігаються у вашому каталозі, у полях категорій і характеристик. Заповнюються ці поля один раз, у вікні зіставлення з довідником майданчика: ви кажете, якій категорії Rozetka відповідає ваша категорія, і якій характеристиці Rozetka — ваша характеристика.
Порядок дій такий:
- Зіставте категорії. Достатньо зіставити ті, товари з яких ви збираєтеся продавати на майданчику, — решта може лишатися порожньою.
- Зіставте характеристики всередині зіставлених категорій. Rozetka вимагає різний набір характеристик для різних категорій, і обов'язкові з них краще закрити повністю.
- Тільки після цього робіть перше вивантаження.
Найчастіша помилка першого запуску — вивантажити фід до зіставлення. Файл сформується, Rozetka його візьме, але товари або не заведуться, або поїдуть у випадкову категорію, і розбиратися доведеться вже на боці майданчика. Перевірити просто: відкрийте готовий файл і подивіться, чи не порожній rz_id у категорій.
Що їде в товар
Склад товару в фіді стандартний для YML: ідентифікатор, ознака наявності, посилання на товар, ціна й валюта, категорія, назва, виробник, артикул виробника, опис, фотографії, характеристики. До цього Rozetka додає кількість.
Дві дрібниці, які варто перевірити перед першим прогоном:
- Посилання на товар. У заготовці шаблону стоїть приклад адреси. Якщо його не замінити на адресу вашого сайту, у фіді поїдуть посилання в нікуди.
- Штрихкод. Для Rozetka він вивантажується — переконайтеся, що поле заповнене там, де майданчик його вимагає.
Куди віддати готовий файл
Rozetka забирає фід сама, за посиланням. Тому файл треба покласти туди, звідки майданчик його дістане: на ваш сайт, на FTP або у хмарне сховище — усі ці способи доставки налаштовуються в картці шаблону й описані в загальній статті про вивантаження.
Далі порядок такий: копіюєте адресу готового файлу, вставляєте її в кабінеті продавця Rozetka й задаєте там частоту оновлення. В Elbuz паралельно ставите свій розклад — щоб до моменту, коли майданчик прийде за файлом, той був свіжий.
Розклад в Elbuz має спрацьовувати частіше або хоча б не рідше, ніж Rozetka приходить за файлом. Інакше майданчик регулярно забиратиме вчорашні ціни, і виглядатиме це як «Elbuz не оновлює дані».
Фід чи API — що коли
У Rozetka є другий канал обміну, і він вирішує інші завдання. Різниця така:
| XML-фід | API | |
|---|---|---|
| Заводить нові картки | так | ні |
| Оновлює ціни й залишки | так, разом із усім фідом | так, точково |
| Повертає статуси замовлень і номер ТТН | ні | так |
| Що потрібно для підключення | нічого, крім адреси файлу | логін і пароль кабінету продавця |
Типовий робочий набір — обидва: фідом заводять і поповнюють асортимент, API тримає ціни й залишки свіжими між вивантаженнями фіда й повертає в Elbuz те, що сталося із замовленнями.
Розбір частих проблем
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Товари не заводяться на майданчику | у категорій порожній rz_id — категорії не зіставлені з довідником Rozetka | зіставте категорії й вивантажте фід заново |
| Товари завелися, але без характеристик | порожній paramid — характеристики не зіставлені | зіставте характеристики в тих категоріях, які використовуєте |
| Rozetka показує «немає в наявності» у товарів, які є | ознака наявності або кількість порожні | перевірте налаштування статусів наявності в шаблоні |
| Посилання на товари ведуть в нікуди | у шаблоні лишився приклад адреси сайту | замініть його на адресу свого магазину |
| Ціни на майданчику відстають | Rozetka приходить за файлом частіше, ніж Elbuz його оновлює | зробіть розклад вивантаження частішим або підключіть API для точкового оновлення цін |
| У фід потрапили зайві товари | відбір товарів у шаблоні надто широкий | звузьте відбір: за категорією, наявністю, ціною |
Часті питання
Що таке rz_id і звідки він береться?
Це номер категорії в довіднику самої Rozetka. Він зберігається у вашій категорії після того, як ви зіставили її з категорією майданчика, і підставляється у фід автоматично. Вписувати його в шаблон руками не треба.
Чи потрібно зіставляти всі категорії каталогу?
Ні, тільки ті, товари з яких ви продаєте на Rozetka. Незіставлені категорії просто поїдуть без номера майданчика — а якщо їхні товари у фід не потрапляють через відбір, то й не поїдуть узагалі.
Чи можна обійтися без фіда, самим лише API?
Ні, якщо товарів на майданчику ще немає: API оновлює ціни й залишки вже заведених карток, а створює картки саме фід.
Як часто вивантажувати фід?
Не рідше, ніж Rozetka приходить за файлом. Точну частоту майданчик задає у вас у кабінеті продавця; орієнтуйтеся на неї й ставте свій розклад із запасом.
Як перевірити фід до того, як віддавати його майданчику?
Зробіть пробний прогін у картці шаблону — програма збере той самий файл із позначкою test_ в імені. Відкрийте його й подивіться очима: чи не порожній rz_id, чи правильні посилання на товари, чи є ціни.
Я бачу такий самий шаблон у Kasta. Це те саме?
Фіди для Rozetka й Kasta зібрані за однією схемою: обидва майданчики чекають номер своєї категорії в категорії й номер своєї характеристики в характеристиці. Довідники в них при цьому різні, тому й зіставлення для кожного своє.
Суміжні теми
- Вивантаження товарів на маркетплейс, сайт і у файл — відбір, доставка файлу, розклад, пробний прогін.
- Вивантаження каталогу у форматі YML — як влаштований сам формат і його шаблон.
- Імпорт каталогу з Rozetka через API — зворотний напрямок.
- Вивантаження каталогу на Епіцентр — сусідній майданчик зі своїми вимогами до фіда.