XML для Rozetka: файл є, імпорт мовчить

XML-фід для Rozetka — це один файл, у якому площадка читає каталог: назви, ціни, категорії, фото й залишки. Імпорт не виправляє дані за вас: якщо поле не відповідає формату, офер виключається або потрапляє в каталог із помилкою. Тому ми спершу перевіряємо прайс, а вже потім збираємо XML.

Структура файлу

Кореневий елемент — yml_catalog з датою формування. Усередині один shop: назва магазину, URL, довідники валют і категорій, блок offers.

<yml_catalog date="2026-11-04 12:00">
  <shop>
    <name>Ваш магазин</name>
    <company>Ваш магазин</company>
    <url>https://example.com</url>
    <currencies>
      <currency id="UAH" rate="1"/>
    </currencies>
    <categories>
      <category id="1001">Інструмент</category>
    </categories>
    <offers>
      <offer id="1841" available="true">
        <price>1299</price>
        <currencyId>UAH</currencyId>
        <categoryId>1001</categoryId>
        <picture>https://cdn.example.com/1.jpg</picture>
        <vendor>Brand</vendor>
        <article>SKU-1841</article>
        <stock_quantity>12</stock_quantity>
        <name>Кабель USB-C</name>
        <description>Опис товару</description>
        <param name="Колір">Чорний</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

id і available — атрибути офера, решта полів — окремі елементи. Ми формуємо їх у порядку, заданому правилами площадки.

Обов'язкові поля офера

Точний перелік обов'язкових param для конкретної категорії звіряйте з довідкою Rozetka перед завантаженням: вимоги відрізняються за розділами.

Типові помилки

• Ціна записана як 1 299,00 грн замість 1299 — імпорт не розпізнає число.
• Той самий id або артикул у двох рядках — площадка не розуміє, який офер головний.
• Фото починається з http://, містить пробіл або кирилицю — для Rozetka посилання має бути HTTPS.
• Порожній categoryId або id, якого немає в дереві категорій Rozetka.
• Відсутній vendor, description або stock_quantity — офер не проходить перевірку.
• Дублі назв: два різні товари з однаковою назвою теж вважаються конфліктом.

Що робимо з прайсом

1. Читаємо XLSX або CSV у тому вигляді, у якому його надіслав постачальник.
2. Зіставляємо колонки з полями фіда за мапою: id, name, price, currency, category, available, picture, vendor, article, stock_quantity, description.
3. Перевіряємо типи, обов'язковість, дублі та формат посилань — без мережевих запитів до сайтів із фото.
4. Рядки з помилками не включаємо у фід. У звіті залишаємо номер рядка, id, поле, код і причину.
5. Віддаємо готовий XML і звіт: що виправлено, що виключено і чому.