Для автоматизованого імпорту товарів на маркетплейс ROZETKA продавцю необхідно підготувати прайс-лист у форматі XML (YML). Зазвичай ви можете експортувати інформацію про свої товари в необхідному форматі з вашої системи: CMS вашого сайту, сервісу Pricecreator, кабінету Prom.ua тощо.
На цій сторінці наведено технічні вимоги безпосередньо до структури документа, XML-тегів та їхніх атрибутів. Детальну інструкцію про те, як згенерувати XML-прайс-лист читайте за посиланням.
Технічні вимоги:
- URL-адреса на XML-прайс-лист має бути статичною і не повинна змінюватися з часом.
- Допустиме кодування даних — тільки UTF-8.
- Стандарт XML (YML) не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки).
- URL-адреса кожної товарної пропозиції має бути закодована відповідно до стандарту RFC-1738.
- Заборонено змінювати
idтоварів таidкатегорій після додавання товарів на маркетплейс. - Cимволи
" & < > 'у тексті обов'язково потрібно замінювати на їхні еквівалентні XML-коди (символьні сутності). Ця вимога стосується лише написання безпосередньо тексту (значень тегів) і не стосується самого написання XML-тегів.Символ Як записати в HTML-коді "
"
&
&
>
>
<
<
' '
Приклад структури даних у XML-файлі
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-07-20 14:58">
<shop>
<name>Назва магазину</name>
<company>Назва компанії</company>
<url>https://www.abc.ua/</url>
<currencies>
<currency id="UAH" rate="1"/>
<currency id="USD" rate="45.5"/>
<currency id="EUR" rate="52.1"/>
</currencies>
<categories>
<category id="391">Куртки для хлопчиків</category>
</categories>
<offers>
<offer id="19305" available="true">
<price>900</price>
<currencyId>UAH</currencyId>
<categoryId>391</categoryId>
<picture>https://abc.ua/upload/a53/a5391cddb40be91705.jpg</picture>
<picture>https://abc.ua/upload/9d0/9d06805d219fb525fc.jpg</picture>
<picture>https://abc.ua/upload/93d/93de38537e1cc1f8f2.jpg</picture>
<vendor>Abc</vendor>
<article>58265468</article>
<stock_quantity>100</stock_quantity>
<name>Куртка Abc Scoperandom-HH 146 см Черная (58265468)</name>
<name_ua>Куртка Abc Scoperandom-HH 146 см Чорна (58265468)</name_ua>
<description>
<![CDATA[<p>Одежда<b>Abc clothes</b> способствует развитию функций
головного мозга за счет поощрения мелкой моторики.</p><p>В Abc
<b>New Collection</b> будет особенно удобно лазать, прыгать, бег
ать.</p><p>За счет своей универсальноcти и многофункциональности,
<b>Abc clothes</b> отлично подходит:</p><ul><li><b>Для весны</b>
</li><li><b>Для лета</b></li><li><b>Для ранней осени</b></li>
</ul><p><b>Состав:</b>• 92% полиэстер, 8%эластан, не токсичность
подтверждена лабораторно.</p><p><b>Вес:</b> 305 г</p>]]>
</description>
<description_ua>
<![CDATA[<p>Одяг<b>Abc clothes</b> сприяє розвитку функцій
головного мозку шляхом підтримки дрібної моторики.</p><p>В Abc
<b>New Collection</b> буде особливо зручно стрибати, пригати та
бігати.</p><p>Завдяки своїй універсальності та багатофункціона
льності, <b>Abc clothes</b> чудово підійде:</p><ul><li><b>Для
весни</b></li><li><b>Для літа</b></li><li><b>Для ранньої осені
</b></li></ul><p><b>Склад:</b>• 92% поліестер, 8% еластан,
нетоксичність підтверджена в лабораторії.</p>
<p><b>Вага:</b> 305 г</p>]]>
</description_ua>
<param name="Зріст">146 см</param>
<param name="Сезон">Весна-Осінь</param>
<param name="Колір">Чорний</param>
<param name="Особливості моделі">З капюшоном</param>
<param name="Склад">92% поліестер, 8% еластан</param>
<param name="Рекомендації по догляду">
<value lang="uk">Не відбілювати</value>
<value lang="ru">Не отбеливать</value>
</param>
<param name="Країна-виробник товару">Україна</param>
</offer>
</offers>
</shop>
</yml_catalog>
Завантажити приклад XML-файлу ⭣
Опис тегів та елементів даних в XML-файлі
| Елемент / тег | Значення |
|---|---|
|
yml_catalog |
Кореневий елемент формату YML. Атрибут |
|
shop |
Інформація про інтернет-магазин. |
|
name |
Назва магазину. На сайті не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів: 255. |
|
company |
Назва компанії. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів: 255. |
|
url |
URL-адреса головної сторінки сайту продавця. Максимальна кількість символів: 255. |
|
currencies |
Перелік курсу валют. Кожна валюта описується окремим елементом Значення в атрибуті Лише у гривні Приклад: <currencies> <currency id="UAH" rate="1"/> <currency id="USD" rate="36.6"/> <currency id="EUR" rate="37.9"/> </currencies> |
|
categories |
Перелік категорій товарів. Для кожної категорії вказується унікальний ідентифікатор
Приклад: <categories> <category id="1">Кутові дивани</category> <category id="2">Смарт-годинник</category> <category id="3">Дитячі ігрові комплекси</category> </categories> |
|
rz_id (для тегу category) |
Атрибут, який забезпечує автоматичну зв'язку категорії прайс-листа з категорією сайту ROZETKA.
Вказується лише в переліку категорій, для Приклад: <categories> <category id="12345" rz_id="32635505">Джеми та начинки</category> </categories>
Пріоритет rz_id вище, ніж у назви категорії. Наприклад, якщо назва категорії в прайс-листі «Футболка», а в атрибуті rz_id буде вказано значення категорії «Шкарпетки», то автоматично буде зв'язок з категорією «Шкарпетки». |
|
offers |
Список всіх товарних позицій. Відкривається після тегу |
|
offer |
Інформація про товарну позицію.
Кожну варіацію (різновид) товару потрібно передавати окремим унікальним |
|
stock_quantity або quantity_in_stock |
Залишки товару. Ціле цифрове значення. Товар буде в наявності поки цей параметр більше ніж 0. Обов'язково вказувати для кожного |
|
url (в offer) |
URL-адреса сторінки товару на сайті продавця. Максимальна кількість символів: 500. |
|
price |
Ціна товару. Ціле або дробове числове значення. Роздільником цілої та дробової частин використовуйте крапку або кому. На сайті ROZETKA ціна з копійками буде округлена. |
|
price_old або old_price |
Перекреслена ціна (стара ціна товару). Ціле або дробове числове значення. Використовується для встановлення знижки на товар. Значення |
|
price_promo або promo_price |
Промо-ціна, яка використовується щоб долучити товар до поточної промоакції. Ціле або дробове числове значення. |
|
currencyId |
Валюта, в якій вказана ціна товару: UAH / USD / EUR. |
|
categoryId |
Ідентифікатор категорії, до якої відноситься товар. |
|
picture |
URL-адреса зображення товару. Посилання повинно мати
сертифікат безпеки (https), не має містити кирилицю, пробіли та символ Перша фотографія в списку буде основною на сторінці товару. Мінімальна кількість зображень – 1; максимальна – 15. Максимальний розмір одного зображення (файлу): 10 Мб. Якщо на вашому сервері є обмеження на завантаження файлів, необхідно додати у виключення наступні ip-адреси:
|
|
vendor |
Бренд товару (торгова марка/виробник). |
|
article |
|
|
name або model name_ua або model_ua |
name_ua — назва позиції українською мовою. Якщо в прайс-листі не вказується українська назва для товару, на маркетплейсі буде застосований автоматичний переклад |
|
description description_ua |
description_ua — опис товару українською мовою. Якщо в прайс-листі немає українського опису, на сайті буде застосований автоматичний переклад. |
|
state |
Стан товару. Використовується для продажу уцінених, вживаних чи відновлених товарів.
За замовчуванням (якщо тег |
|
docket docket_ua |
Короткий опис товару. Текстове поле, максимальна кількість символів: 255. Обов’язково використовувати для вказання причини уцінки товару, якщо товар має відповідний стан. |
|
param |
Характеристики товару (параметри). Назва характеристики вказується в атрибуті В багатозначному текстовому параметрі значення перераховуються через роздільник
Максимальна кількість символів: 500. Приклад: <param name="Колір">Чорний</param> <param name="Додаткові характеристики"><![CDATA[Прасувати за температури не більше ніж 110 °C <br> Не можна вибілювати засобами, які містять хлор <br> Прання за температури 30 °C.]]></param> |
|
paramid |
Id характеристики (параметра) на сайті ROZETKA. Використовується для автоматичної зв’язки параметра. Id параметрів та їх значень для конкретної категорії можна завантажити в кабінеті продавця, розділ «Управління товарами» → «Довідники». Якщо тип параметра ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язково вказувати атрибут Приклад: <param name="Колір" paramid="136895" valueid="1150615">Коричневий</param> |
|
valueid |
Id значення характеристики (параметра) на сайті ROZETKA. Використовується для автоматичної прив'язки значення. Максимальна кількість символів: 255. Приклад: <param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня</param> |
|
value lang |
Використовується щоб вказати значення текстової характеристики двома мовами. Максимальна кількість символів: 255.
Приклад: <param name="Рекомендації по догляду"> <value lang="uk">Не відбілювати</value> <value lang="ru">Не отбеливать</value> </param> |
Якщо у вас залишились питання, які стосуються XML-прайс-листа, зверніться до служби підтримки за темою «Робота з товарами, прайс-лист» → «Запитання щодо вивантаження XML».