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

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

На цій сторінці описані технічні вимоги до структури XML. Про те, як отримати прайс-лист (експортувати інформацію про свої товари), описано за посиланням.

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

• url-адреса на xml прайс-лист повинна бути статичною і не змінюватися;
• допустиме кодування даних — UTF-8;
• стандарт XML (YML) не допускає використання недрукованих символів з ASCII-кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 — табуляція, перенесення рядка, повернення каретки);
• url-адреса товарної пропозиції повинна бути закодована відповідно до стандарту RFC-1738;
• символи ", &, > <, ' потрібно замінювати на еквівалентні коди. (приклади)
  X

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

  *Вимога стосується лише написання тексту і не стосується написання тегів;
• заборонено змінювати id товарів і категорій після додавання на сайт ROZETKA.

Приклад 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

<currencies>
<currency id="UAH" rate="1"/>
<currency id="USD" rate="36.6"/>
<currency id="EUR" rate="37.9"/>
</currencies>

<categories>
<category id="1">Кутові дивани</category>
<category id="2">Смарт-годинник</category>
<category id="3">Дитячі ігрові комплекси</category>
</categories>

<categories>
<category id="12345" rz_id="32635505">Джеми та начинки</category>
</categories>

<param name="Колір">Чорний</param>
<param name="Додаткові характеристики"><![CDATA[Прасувати за температури не більше ніж 110 °C <br>
Не можна вибілювати засобами, які містять хлор <br>
Прання за температури 30 °C.]]></param>

<param name="Колір" paramid="136895" valueid="1150615">Коричневий</param>

<param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня</param>

<param name="Рекомендації по догляду">
<value lang="uk">Не відбілювати</value>
<value lang="ru">Не отбеливать</value>
</param>

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