Для автоматизованого імпорту товарів на маркетплейс ROZETKA продавцю необхідно підготувати прайс-лист товарів у форматі XML (YML). Це структурований формат передачі даних про ваші товари. Як правило, ви можете експортувати інформацію про свої товари в необхідному форматі із вашої системи: CMS вашого сайту, сервіс Pricecreator, кабінет Prom.ua тощо. На цій сторінці описані технічні вимоги до структури XML файлу. Про те, як отримати XML прайс-лист (експортувати інформацію про свої товари), читайте за посиланням.

Технічні вимоги:

Url-адреса на xml прайс-лист повинна бути статичною і не змінюватися.
Допустиме кодування даних: UTF-8;
Стандарт XML (YML) не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки).
Url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738.

Cимволи ", &, > <, ' потрібно замінювати на еквівалентні коди. Вимога стосується лише написання тексту і не стосується написання тегів. [Переглянути приклади]

Символ в тексті	Код в XML
"
&
>
<
'

Заборонено змінювати id товарів та id категорій після додавання на маркетплейс.

Приклад передачі даних в 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="36.6"/>
                <currency id="EUR" rate="37.9"/>
            </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/iblock/a53/a5391cddb40be91705.jpg</picture>
                    <picture>https://abc.ua/upload/iblock/9d0/9d06805d219fb525fc.jpg</picture>
                    <picture>https://abc.ua/upload/iblock/93d/93de38537e1cc1f8f2.jpg</picture>
                    <vendor>Abc clothes</vendor>
                    <article>58265468</article>
                    <stock_quantity>100</stock_quantity>
                    <name>Куртка Abc clothes Scoperandom-HH 146 см Черная (58265468)</name>
                    <name_ua>Куртка Abc clothes 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 файлі

Елемент / тег	Значення
yml_catalog *обов'язковий елемент	Кореневий елемент формату YML. Атрибут `date` вказує дату і час генерації або зміни XML (YML). Дата повинна мати формат YYYY-MM-DD hh:mm.
shop *обов'язковий елемент	Інформація про інтернет-магазин.
name необов'язковий елемент	Назва магазину. На сайті не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів: 255.
company необов'язковий елемент	Назва компанії. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів: 255.
url необов'язковий елемент	Url-адреса головної сторінки сайту продавця. Максимальна кількість символів: 255.
currencies *обов'язковий елемент	Перелік курсу валют. Кожна валюта описується окремим елементом `currency.` Значення в атрибуті `currency id` потрібно вказувати у вигляді трибуквеного алфавітного коду валютиза стандартом ISO 4217: `UAH USD EUR`. Лише у гривні `rate="1"`. Роздільником цілої та дробової частини частини може бути крапка або кома. Приклад: <currencies> <currency id="UAH" rate="1"/> <currency id="USD" rate="36.6"/> <currency id="EUR" rate="37.9"/> </currencies>
categories *обов'язковий елемент	Перелік категорій товарів. Для кожної категорії вказується унікальний ідентифікатор `(id)`, нумерація дозвільна. Id категорій не повинні змінюватись. Рекомендуємо, щоб в одній категорії в прайс-листі не було товарів з різних категорій сайту ROZETKA. Рекомендуємо вказувати назву категорії згідно з назвою на сайті ROZETKA. Максимальна кількість символів: 255. Приклад: <categories> <category id="1">Кутові дивани</category> <category id="2">Смарт-годинник</category> <category id="3">Дитячі ігрові комплекси</category> </categories>
rz_id (для тегу category) необов'язковий елемент	Атрибут, який забезпечує автоматичну зв'язку категорії прайс-листа з категорією сайту ROZETKA. Вказується лише в переліку категорій, для `offer` вказується лише основний `category id`. Приклад: <categories> <category id="12345" rz_id="32635505">Джеми та начинки</category> </categories> `id="12345"` ━ ідентифікатор категорії у вашій систем; `rz_id="32635505"` ━ ідентифікатор відповідної категорії на сайті ROZETKA. Пріоритет rz_id вище, ніж у назви категорії. Наприклад, якщо назва категорії в прайс-листі «Футболка», а в атрибуті rz_id буде вказано значення категорії «Шкарпетки», то автоматично буде зв'язок з категорією «Шкарпетки».
offers *обов'язковий елемент	Список всіх товарних позицій. Відкривається після тегу `</categories>`. Закривається перед тегом `</shop>`.
offer *обов'язковий елемент	Інформація про товарну позицію. Кожен товар описується в окремому елементі `offer`. Кожна позиція повинна мати унікальний `id`, нумерація дозвільна, допускається використання символів: Aa-Zz і 0-9, не допускається використання кирилиці та пробілів. Забороняється змінювати `id`, якщо товар вже доданий на сайт ROZETKA. Атрибут `available` вказує наявність товару: `true` — товар в наявності, `false` — немає в наявності. Кожен різновид товару потрібно передавати окремим унікальним `offer id` (колір, розмір, об'єм, комплектація тощо).
stock_quantity або quantity_in_stock *обов'язковий елемент	Залишки товару. Ціле цифрове значення. Товар буде в наявності поки цей параметр більше ніж 0. Обов'язково вказувати для кожного `offer`, позиції без тегу будуть у статусі «немає в наявності».
url (в offer) необов'язковий елемент	Url-адреса сторінки товару на сайті продавця. Максимальна кількість символів: 500.
price *обов'язковий елемент	Ціна товару. Ціле або дробове числове значення. Роздільником цілої та дробової частин використовуйте крапку або кому. Ціна з копійками на сайті ROZETKA буде округлена.
price_old або old_price необов'язковий елемент	Перекреслена ціна (стара ціна товару). Ціле або дробове числове значення. Використовується для відображення знижки на товар. Значення `price_old` має бути вище значення `price`.
price_promo або promo_price необов'язковий елемент	Промо-ціна, яка використовується щоб додати товар на промо-сторінку. Ціле або дробове числове значення.
currencyId *обов'язковий елемент	Валюта, в якій вказана ціна товару: UAH / USD / EUR.
categoryId *обов'язковий елемент	Ідентифікатор категорії, до якої відноситься товар.
picture *обов'язковий елемент	url-адреса зображення товару. Посилання повинно мати сертифікат безпеки (https), не має містити кирилицю та пробіли, максимальна кількість символів: 1999. Перша фотографія в списку буде основною на сторінці товару. Мінімальна кількість: 1, максимальна: 15. Максимальний розмір одного зображення (файлу): 10 Мб. Якщо на вашому сервері встановлено обмеження на завантаження файлів, необхідно додати у виключення наступні ip-адреси: 89.184.81.192/27 89.184.81.128/26 78.27.198.0/24 89.184.65.128 88.81.226.126 78.27.198.189 91.210.37.210 45.128.216.254 45.128.217.251
vendor *обов'язковий елемент	Бренд товару (торгова марка/виробник).
article необов'язковий елемент	Артикул товару.
name або model обов'язковий елемент name_ua* або model_ua необов'язковий елемент	Назва товарної позиції. В прайс-листі не має бути більше однієї позиції з абсолютно однаковою назвою. Максимальна кількість символів: 255. name_ua — назва позиції українською мовою. Якщо в прайс-листі не вказується українська назва для товару, на маркетплейсі буде застосований автоматичний переклад
description обов'язковий елемент description_ua* необов'язковий елемент	Текстовий опис товару. Максимальна кількість символів: 50 000; Опис можна форматувати за допомогою HTML тегів, які потрібно поміщати всередину `CDATA`. description_ua — опис товару українською мовою. Якщо в прайс-листі немає українського опису, на сайті буде застосований автоматичний переклад.
state необов'язковий елемент	Стан товару. Використовується для продажу уцінених, вживаних чи відновлених товарів. `new` — новий товар; `stock` — уцінений товар; `used` — вживаний товар; `refurbished` — відновлений товар. За замовчуванням (і якщо тег `state` не вказаний) товарам встановлюється статус `new`.
docket необов'язковий елемент docket_ua необов'язковий елемент	Короткий опис товару. Обов’язково використовувати для вказання причини уцінки товару (якщо товар має відповідний статус). Текстове поле, максимальна кількість символів: 255.
param *обов'язковий елемент	Характеристики товару (параметри). Назва характеристики вказується в атрибуті `name`. Назва та значення обов'язково мають бути заповнені, не допускається наявність незаповненого тегу. В багатозначному текстовому параметрі значення перераховуються через роздільник `<br>` і закриваються в CDATA. Максимальна кількість символів: 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 ━ обов'язково вказувати атрибут `valueid`. Приклад: <param name="Колір" paramid="136895" valueid="1150615">Коричневий</param>
valueid необов'язковий елемент	Id значення характеристики (параметра) на сайті ROZETKA. Використовується для автоматичної прив'язки значення. Максимальна кількість символів: 255. Приклад: <param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня</param>
value lang необов'язковий елемент	Використовується для вказання текстової характеристики двома мовами. Максимальна кількість символів: 255. `value lang="uk"` — українська; `value lang="ru"` — російська. Приклад: <param name="Рекомендації по догляду"> <value lang="uk">Не відбілювати</value> <value lang="ru">Не отбеливать</value> </param>

Якщо у вас залишились запитання, які стосуються XML файлу, зверніться до служби підтримки за темою «Робота з товарами, прайс-лист» → «Запитання щодо вивантаження XML».

Вимоги до xml файлу

Пов'язані запитання

Чи можна використовувати в id значенні товарів букви/символи?

Чи можна одночасно передавати промоціну та ціну зі знижкою (price_promo та price_old)?

Чи можна в XML прайс-листі використовувати посилання на зображення, які знаходяться на Google Диску?

Пов'язані запитання

Чи можна використовувати в id значенні товарів букви/символи?

Чи можна одночасно передавати промоціну та ціну зі знижкою (price_promo та price_old)?

Чи можна в XML прайс-листі використовувати посилання на зображення, які знаходяться на Google Диску?