Як створити XML файл для Rozetka.ua (розетки)

Для виставлення товарів на Rozetka.ua необхідно підготувати прайс-лист із пропозиціями у форматі XML (YML). У процесі роботи магазину адреса посилання xml має бути статичною і не змінюватися.

Вимоги до файлу XML (YML)

стандарт XML (YML) не допускає використання недрукованих символів з ASCII кодами від 0 до 31 (за винятком символів з кодами 9, 10, 13 - табуляція, переклад рядка, повернення каретки).
символи ", &, >, <, ' потрібно замінювати на еквівалентні коди. Вимога відноситься тільки до тексту і не торкається написання тегів;
заборонено змінювати id товарів та категорій після додавання на сайт ROZETKA.

Символ у тексті	Код для файлу XML
"
&
>
<
'

URL-адреса товарної пропозиції на сайті магазину має бути закодована відповідно до стандарту RFC-1738.
допустиме кодування файлу XML (YML): UTF-8.

Приклад XML-файлу

Як створити XML файл для Rozetka ua розетки

Опис елементів

Елемент	Опис
yml_catalog Обов'язковий елемент	Кореневий елемент YML. Атрибут date вказує дату та час генерації або зміни XML (YML). Дата має формат YYYY-MM-DD hh:mm.
shop Обов'язковий елемент	Містить опис магазину та його товарних пропозицій.
name Необов'язковий елемент	Коротка назва магазину. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів ━ 255.
company Необов'язковий елемент	Повне найменування підприємства, що володіє магазином. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів ━ 255.
url Необов'язковий елемент	URL головної сторінки існуючого магазину. Максимальна кількість символів ━ 255.
platform Необов'язковий елемент	Система керування контентом, на основі якої працює магазин (CMS).
currencies Обов'язковий елемент	Перелік курсів валют магазину. Кожна з валют описується окремим елементом currency. Приклад: Ціни на сайті відображаються лише у гривнях. Тільки гривня rate="1". Як роздільник цілої та дробової частин будь-яких чисел у YML незалежно від регіональних установок використовується точка або кома. Значення в атрибуті currency id=". . . " вказується за стандартом ISO 4217 у вигляді трилітерного алфавітного (alfa-3) коду валюти.
categories Обов'язковий елемент	Список категорії магазину. Кожній категорії надається унікальний номер, нумерація — на розсуд магазину. за будь-яких змін у прайс-листі id категорій повинні залишатися незмінними; перед зазначенням необхідно підібрати кінцеві категорії товару; рекомендуємо вказувати назву категорії відповідно до назви на нашому сайті. В одній категорії не повинно бути товарів із різних категорій на нашому сайті; в одній категорії магазину не повинно бути товарів із двох різних категорій на нашому сайті. Приклад: `Угловые диваны Смарт-часы Детские игровые комплексы` `Угловые диваны Смарт-часы Детские игровые комплексы` `Угловые диваны Смарт-часы Детские игровые комплексы` Максимальна кількість символів ━ 255.
rz_id Необов'язковий елемент	Забезпечує автоматичну зв'язку категорії із прайс-листа з категорією ROZETKA. Вказується лише у списку категорій, у картці товару вказується ваш ID категорії. Приклад: `Джемы и начинки` id=”12345” ━ ваш id категорії; rz_id=”32635505” ━ id тієї категорії на ROZETKA, де мають бути розміщені товари. Пріоритет rz_id вищий, ніж назва категорії. Наприклад, якщо назва категорії в xml файлі "Футболка", а в тезі rz_id буде вказано id категорії "Шкарпетки" на сайті ROZETKA, то автоматично буде зв'язок з категорією "Шкарпетки".
offers Обов'язковий елемент	Список пропозицій магазину. Відкривається один раз після тега. Закривається в кінці документа, перед тегом Приклад: `Платья Куртки . . . . . . . . .` `Платья Куртки . . . . . . . . .` `Платья Куртки . . . . . . . . .` Зверніть увагу, що тег не повинен повторюватися в межах прайс-листа.
offer Обов'язковий елемент	Карточка товару. Закривається тегом. кожен товар описується окремим елементом offer; кожній пропозиції необхідно надати унікальний номер id=". . . ", нумерація – на розсуд магазину; offer id повинен залишатися незмінним, допускається використання символів: Aa-Zz та 0-9, не допускається використання кирилиці та пробілів атрибут available - вказує наявність товару: true - товар у наявності, false - товар не в наявності. На кожен різновид товару: колір, розмір, обсяг, комплектацію тощо. - повинен бути створений окремий унікальний offer. На нашому сайті товари будуть згруповані в 1 пропозицію з можливістю вибору за кольором, розміром, обсягом тощо. Приклад: `. . .`
stock_quantity (quantity_in_stock) Обов'язковий елемент	Залишки товару. Товар буде в наявності на сайті до тих пір, поки цей параметр більше 0. Зверніть увагу, при використанні тега обов'язково вказувати його у всіх товарах у прайс-листі, інакше товарам без вказівки даного тега буде надано статус "Немає в наявності". Також обов'язково слідкувати за значенням у тезі available=". . . ", якщо stock_quantity > 0 ━ true, якщо stock_quantity < 0 ━ false. Приклад: `10`
url (in offer) Необов'язковий елемент	Посилання товару на вашому сайті. Приклад: `https://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx. html` Максимальна кількість символів ━ 500.
price Обов'язковий елемент	Ціна товару. Вказуйте лише ціле число, копійки на сайті округляються. Приклад: `4499` Як роздільник цілої та дробової частин будь-яких чисел в YML використовується точка або кома. Ціна вказана з копійками буде заокруглена на сайті.
price_old (old_price) Необов'язковий елемент	Стара ціна товару буде перекреслена на сайті. Вказуйте слідом за тегом. Значення тега обов'язково має бути вище значення тега Приклад: `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` Докладніше: Знижка на товар
price_promo (promo_price) Необов'язковий елемент	Ціна за промо-кодом. Обов'язково наявність тега у картці товару зі значенням не менше 2-х, а також дотримання рекомендованої ціни для участі у промо-активностях, що відображається в особистому кабінеті. Приклад: `820 620 или` `820 620 или` `820 620 или` `820` `620` Детальніше: Участь у промо-розсилках
currencyId Обов'язковий елемент	Валюта, в якій вказана ціна товару: UAH, EUR, EUR, RUR. Приклад: `UAH EUR EUR RUR` `UAH EUR EUR RUR` `UAH EUR EUR RUR` `UAH EUR EUR RUR`
categoryId Обов'язковий елемент	ID категорії, до якої прив'язаний цей товар. Приклад: `391`
picture Обов'язковий елемент	Посилання на фото товару. Перша фотографія у списку буде основною у картці товару. Посилання не повинно містити кирилицю та, пробіли, максимальну кількість символів ━ 1999. Мінімальна кількість фото ━ 1, максимальна ━ 15. Приклад: `https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg https://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg` `https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg https://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg` `https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg https://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg` Якщо на вашому сервері встановлено обмеження на завантаження фотографій, необхідно додати такі підмережі: 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
vendor Обов'язковий елемент	Бренд-виробник товару. Повинен відповідати нашим вимогам . Приклад: `Abc clothes`
name (model) Обов'язковий елемент	Назва товару. При вказівці дотримуйтесь наших вимог та рекомендацій . у прайс-листі не може бути два товари з абсолютно однаковою назвою; бренд, вказаний у назві та в тезі має бути однаковим. Тег model може використовуватися як назва, замість тега name. Приклад: `Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900)` `Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900)` `Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900)` Максимальна кількість символів ━ 255.
description Обов'язковий елемент	Опис товару. опис може бути однотипним для всієї категорії; в описі повинна бути інформація тільки про товар; опис не повинен містити посилань, телефонів, адрес, пропозицій послуг, акцій, цін, картинок, відеооглядів тощо; опис бажано відформатувати за допомогою HTML тегів. Html теги закрити в . Приклад: `Одежда <b>Abc clothes</b> способствует развитию…` Виробник Естонія. ]]>
state Необов'язковий елемент	Стан товару. Використовується у разі продажу Б/У та відновленого товару used б/у товар refurbished відновлений new новий Якщо тег state не вказано, за замовчуванням товар проставляється статус new. Приклад: `used`
. . . Обов'язковий елемент	Характеристики (параметри) товару. Назва чи значення характеристики (параметра) обов'язково мають бути заповнені, не допускається наявність порожніх тегів. Мінімальна кількість необхідних характеристик товару = 3. в атрибуті name вкажіть назву параметра (обов'язково); у самому елементі . . . вкажіть значення параметра. Приклад: `Черный` У багатозначному параметрі значення перераховуються через кому і закриваються CDATA. Максимальна кількість символів ━ 255.
paramid=". . . " Необов'язковий елемент	id характеристики (параметра) на сайті ROZETKA, прописується для автоприв'язки параметра та прискорення процесу модерації. Якщо тип (характеристики) параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язкове вказівку додаткового тега valueid=". . . " Приклад: `2`
valueid=". . . " Необов'язковий елемент	id значення характеристики (параметра) на сайті ROZETKA, прописується для автоприв'язування значення та прискорення процесу модерації. Приклад: `Осенняя, Весенняя, Летняя` Максимальна кількість символів ━ 255.