yml_catalog *обов'язковий елемент | Кореневий елемент формату YML. Атрибут date вказує дату і час генерації або зміни XML (YML). Дата повинна мати формат YYYY-MM-DD hh:mm. |
shop *обов'язковий елемент | Інформація про інтернет-магазин. |
name необов'язковий елемент | Назва магазину. На сайті не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів ━ 255. |
company необов'язковий елемент | Назва компанії. Не публікується, використовується для внутрішньої ідентифікації. Максимальна кількість символів ━ 255. |
url необов'язковий елемент | url-адреса головної сторінки магазину. Максимальна кількість символів ━ 255. |
currencies *обов'язковий елемент | Перелік курсу валют. Кожна валюта описується окремим елементом currency. Значення в атрибуті currency id потрібно вказувати у вигляді трибуквеного алфавітного коду валюти: UAH USD EUR (стандарт ISO 4217). Лише у гривні 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;
- кожна позиція повинна мати унікальний 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> має бути вище значення <price>. |
price_promo або promo_price необов'язковий елемент | Промо-ціна, яка використовується щоб додати товар на промо-сторінку. Ціле або дробове числове значення. |
currencyId *обов'язковий елемент | Валюта, в якій вказана ціна товару: UAH / USD / EUR. |
categoryId *обов'язковий елемент | Ідентифікатор категорії, до якої відноситься товар. |
*обов'язковий елемент | url-адреса зображення товару. Перша фотографія в списку буде основною на сторінці товару. Посилання не може містити кирилицю і пробіли, максимальна кількість символів ━ 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 |
*обов'язковий елемент | Бренд товару (торгова марка/виробник). |
articleнеобов'язковий елемент | |
*обов'язковий елемент name_ua або model_ua необов'язковий елемент | Назва товарної позиції. - у прайс-листі не може бути дві чи більше позицій з абсолютно однаковою назвою;
- максимальна кількість символів — 255.
name_ua — назва позиції українською мовою. Якщо в прайс-листі не вказується українська назва для товару, на маркетплейсі буде застосований автоматичний переклад |
description *обов'язковий елемент description_ua необов'язковий елемент | Текстовий опис товару. - максимальна кількість символів — 50 000;
- опис можна форматувати за допомогою HTML тегів, які потрібно згрупувати в розділі CDATA.
description_ua — опис товару українською мовою. Якщо в прайс-листі немає українського опису, на сайті буде застосований автоматичний переклад. |
state необов'язковий елемент | Стан товару. Використовується для продажу вживаних чи відновлених товарів. - new — новий товар;
- used — вживаний товар;
- refurbished — відновлений товар.
За замовчуванням (і якщо тег state не вказаний) товарам проставляється статус new. |
param *обов'язковий елемент | Характеристики товару (параметри). Назва характеристики вказується в атрибуті name. Назва та значення обов'язково мають бути заповнені, не допускається наявність незаповненого тегу. В багатозначному текстовому параметрі значення перераховуються через роздільник <br> і закриваються в CDATA. Приклад: <param name="Колір">Чорний</param>
<param name="Додаткові характеристики"><![CDATA[Прасувати за температури не більше ніж 110 °C <br>
Не можна вибілювати засобами, які містять хлор <br>
Прання за температури 30 °C.]]></param> Максимальна кількість символів ━ 255. |
paramid необов'язковий елемент | id характеристики (параметра) на сайті ROZETKA. Використовується для автоматичної зв’язки параметра. id параметрів та їх значень для конкретної категорії можна завантажити в кабінеті продавця, розділ «Управління товарами» → «Довідники». Якщо тип параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язково вказувати атрибут valueid. Приклад: <param name="Колір" paramid="136895" valueid="1150615">Коричневий</param> |
valueid необов'язковий елемент | id значення характеристики (параметра) на сайті ROZETKA. Використовується для автоматичної прив'язки значення. Приклад: <param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320">Осіння, Весняна, Літня</param> Максимальна кількість символів ━ 255. |
value lang необов'язковий елемент | Використовується для вказання текстової характеристики двома мовами.
value lang="uk" — українська;
value lang="ru" — російська. Приклад: <param name="Рекомендації по догляду">
<value lang="uk">Не відбілювати</value>
<value lang="ru">Не отбеливать</value>
</param> Максимальна кількість символів ━ 255. |
