Для виставлення товарів на 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-файлу
.png "Як створити 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 Обов'язковий елемент | Список категорії магазину. Кожній категорії надається унікальний номер, нумерація — на розсуд магазину.
Приклад: Угловые диваны Смарт-часы Детские игровые комплексыУгловые диваны Смарт-часы Детские игровые комплексыУгловые диваны Смарт-часы Детские игровые комплексыМаксимальна кількість символів ━ 255. |
| rz_id Необов'язковий елемент | Забезпечує автоматичну зв'язку категорії із прайс-листа з категорією ROZETKA. Вказується лише у списку категорій, у картці товару вказується ваш ID категорії. Приклад: Джемы и начинки id=”12345” ━ ваш id категорії; Пріоритет rz_id вищий, ніж назва категорії. Наприклад, якщо назва категорії в xml файлі "Футболка", а в тезі rz_id буде вказано id категорії "Шкарпетки" на сайті ROZETKA, то автоматично буде зв'язок з категорією "Шкарпетки". |
| offers Обов'язковий елемент | Список пропозицій магазину. Відкривається один раз після тега. Закривається в кінці документа, перед тегом Приклад: Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Зверніть увагу, що тег не повинен повторюватися в межах прайс-листа. |
| offer Обов'язковий елемент | Карточка товару. Закривається тегом.
На кожен різновид товару: колір, розмір, обсяг, комплектацію тощо. - повинен бути створений окремий унікальний 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 44993999 4499 или 3999 44993999 4499 или 3999 44993999 4499 или 3999 44993999 4499 или 3999 4499Докладніше: Знижка на товар |
| price_promo (promo_price) Необов'язковий елемент | Ціна за промо-кодом. Обов'язково наявність тега Приклад: 820 620 или820 620 или820 620 или
Детальніше: Участь у промо-розсилках |
| currencyId Обов'язковий елемент | Валюта, в якій вказана ціна товару: UAH, EUR, EUR, RUR. Приклад: UAH EUR EUR RURUAH EUR EUR RURUAH EUR EUR RURUAH 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.jpghttps://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.jpghttps://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 |
| 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 Обов'язковий елемент | Опис товару.
Приклад: Одежда <b>Abc clothes</b> способствует развитию…Виробник Естонія. ]]> |
| state Необов'язковий елемент | Стан товару. Використовується у разі продажу Б/У та відновленого товару Якщо тег state не вказано, за замовчуванням товар проставляється статус new. Приклад: used |
| . . . Обов'язковий елемент | Характеристики (параметри) товару. Назва чи значення характеристики (параметра) обов'язково мають бути заповнені, не допускається наявність порожніх тегів. Мінімальна кількість необхідних характеристик товару = 3.
Приклад: Черный У багатозначному параметрі значення перераховуються через кому і закриваються CDATA. Максимальна кількість символів ━ 255. |
| paramid=". . . " Необов'язковий елемент | id характеристики (параметра) на сайті ROZETKA, прописується для автоприв'язки параметра та прискорення процесу модерації. Якщо тип (характеристики) параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обов'язкове вказівку додаткового тега valueid=". . . " Приклад: 2 |
| valueid=". . . " Необов'язковий елемент | id значення характеристики (параметра) на сайті ROZETKA, прописується для автоприв'язування значення та прискорення процесу модерації. Приклад: Осенняя, Весенняя, ЛетняяМаксимальна кількість символів ━ 255. |
Для вивантаження в XML використовувати макропідстановки
{Атрибут: Rozetka ID}
{Атрибут: Rozetka назва}
.png)
.png)
.png)