Как создать 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-файла
.png)
Описание элементов
Элемент | Описание |
---|---|
yml_catalog Обязательный элемент | Корневой элемент формата YML. Атрибут date указывает дату и время генерации или изменения XML (YML). Дата должна иметь формат YYYY-MM-DD hh:mm. |
shop Обязательный элемент | Содержит описание магазина и его товарных предложений. |
name Необязательный элемент | Короткое название магазина. Не публикуется, используется для внутренней идентификации. Максимальное количество символов ━ 255. |
company Необязательный элемент | Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации. Максимальное количество символов ━ 255. |
url Необязательный элемент | URL главной страницы существующего магазина. Максимальное количество символов ━ 255. |
platform Необязательный элемент | Система управления контентом, на основе которой работает магазин (CMS). |
currencies Обязательный элемент | Список курсов валют магазина. Каждая из валют описывается отдельным элементом currency. Пример: <currencies> <currency id="UAH" rate="1"> <currency id="USD" rate="24.50"> <currency id="EUR" rate="28.50"> <currency id="RUR" rate="0.31"> </currency> </currency> </currency> </currency> </currencies> Цены на сайте отображаются только в гривнах. Только у гривны rate="1". В качестве разделителя целой и дробной частей любых чисел в YML независимо от региональных установок используется точка или запятая. Значение в атрибуте currency id="..." указывается по стандарту ISO 4217 в виде трёхбуквенного алфавитного (alfa-3) кода валюты. |
categories Обязательный элемент | Список категорий магазина. Каждой категории присваиваться уникальный номер, нумерация — на усмотрение магазина.
Пример: <categories> <category id="1">Угловые диваны </category> <category id="2">Смарт-часы </category> <category id="3">Детские игровые комплексы </category> </categories> Максимальное количество символов ━ 255. |
rz_id Необязательный элемент | Обеспечивает автоматическую связку категории из прайс-листа с категорией ROZETKA. Указывается только в списке категорий, в карточке товара указывается ваш id категории. Пример: <categories> <category id="12345" rz_id="32635505">Джемы и начинки </category> </categories> id=”12345” ━ ваш id категории; Приоритет rz_id выше, чем у названия категории. Например, если название категории в xml файле «Футболка», а в теге rz_id будет указан id категории «Носки» на сайте ROZETKA, то автоматически будет связь с категорией «Носки». |
offers Обязательный элемент | Список предложений магазина. Открывается один раз, после тега . Закрывается в конце документа, перед тегом Пример: <categories> <category id="261">Платья </category> <category id="391">Куртки </category> </categories> <offers> ... ... ... </offers> Обратите внимание, тег не должен повторяться в пределах прайс-листа. |
offer Обязательный элемент | Карточка товара. Закрывается тегом .
На каждую разновидность товара: цвет, размер, объем, комплектацию и т.д. — должен быть создан отдельный уникальный offer. На нашем сайте товары будут сгруппированы в 1 предложение с возможностью выбора по цвету, размеру, объему и т.п. Пример: <offer available="true" id="74279"> ... </offer> |
stock_quantity (quantity_in_stock) Обязательный элемент | Остатки товара. Товар будет в наличии на сайте до тех пор, пока этот параметр больше 0. Обратите внимание, при использовании тега обязательно указывать его во всех товарах в прайс-листе, иначе товарам без указания данного тега будет присвоен статус “Нет в наличии”. Также обязательно следить за значением в теге available="...", если stock_quantity > 0 ━ true, если stock_quantity < 0 ━ false. Пример: <stock_quantity>10 </stock_quantity> |
url (in offer) Необязательный элемент | Ссылка на товар на вашем сайте. Пример: <url>http://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx.html </url> Максимальное количество символов ━ 500. |
price Обязательный элемент | Цена товара. Указывайте только целое число, копейки на сайте округляются. Пример: <price>4499 </price> В качестве разделителя целой и дробной частей любых чисел в YML используется точка или запятая. Цена указанная с копейками будет округлена на сайте. |
price_old (old_price) Необязательный элемент | Старая цена товара, будет перечеркнута на сайте. Указывайте следом за тегом Пример: <price>3999 </price> <price_old>4499 </price_old> или <price>3999 </price> <old_price>4499 </old_price> Подробнее: Скидка на товар |
price_promo (promo_price) Необязательный элемент | Цена по промо-коду. Обязательно наличие тега Пример: <price>820 </price> <price_promo>620 </price_promo> или
Подробнее: Участие в промо рассылках |
currencyId Обязательный элемент | Валюта, в которой указана цена товара: UAH, USD, EUR, RUR. Пример: <currencyid>UAH </currencyid> <currencyid>USD </currencyid> <currencyid>EUR </currencyid> <currencyid>RUR </currencyid> |
categoryId Обязательный элемент | ID категории, к которой привязан данный товар. Пример: <categoryid>391 </categoryid> |
picture Обязательный элемент | Ссылка на фото товара. Первая фотография в списке будет основной в карточке товара. Ссылка не должна содержать кириллицу и, пробелы, максимальное количество символов ━ 1999. Минимальное количество фото ━ 1, максимальное ━ 15. Пример: <picture>http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg </picture> <picture>http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg </picture> <picture>http://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg </picture> Если на вашем сервере установлено ограничение на загрузку фотографий, необходимо добавить в исключения следующие подсети: 89.184.81.192/27 |
vendor Обязательный элемент | Бренд-производитель товара. Должен соответствовать нашим требованиям. Пример: <vendor>Abc clothes </vendor> |
name (model) Обязательный элемент | Название товара. При указании придерживайтесь наших требований и рекомендаций.
Тег model может использоваться в качестве названия, вместо тега name. Пример: <name>Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) </name> или <model>Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) </model> Максимальное количество символов ━ 255. |
description Обязательный элемент | Описание товара.
Пример: <description> <!--[CDATA[<p-->Одежда <b>Abc clothes</b> способствует развитию…<p> </p><p>Производитель: Эстония.</p>]]> </description> |
state Необязательный элемент | Состояние товара. Используется в случае продажи Б/У и восстановленного товара Если тег state не указан, по умолчанию товарам проставляется статус new. Пример: <state>used </state> |
... Обязательный элемент | Характеристики (параметры) товара. Название или значение характеристики (параметра) обязательно должны быть заполнены, не допускается наличие пустых тегов. Минимальное количество необходимых характеристик у товара = 3.
Пример: <param name="Цвет" />Черный<param name="Дополнительные характеристики" /><!--[CDATA[Гладить при темпера не более 110 °С, Нельзя отбеливать средствами выделяющими хлор, Стирка при температуре 30 °С]]--> В многозначном параметре значения перечисляются через запятую и закрываются в CDATA. Максимальное количество символов ━ 255. |
paramid="..." Необязательный элемент | id характеристики (параметра) на сайте ROZETKA, прописывается для автопривязки параметра и ускорения процесса модерации. Если тип (характеристики) параметра: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ обязательно указание дополнительного тега valueid="..." Пример: <param name="Количество боковых щёток" paramid="126539" />2 |
valueid="..." Необязательный элемент | id значения характеристики (параметра) на сайте ROZETKA, прописывается для автопривязки значения и ускорения процесса модерации. Пример: <param name="Сезон" paramid="39560" valueid="2296922, 2645254, 63320" /> Осенняя, Весенняя, Летняя Максимальное количество символов ━ 255. |
Для выгрузки в XML использовать макроподстановки
{Атрибут: Rozetka ID}
{Атрибут: Rozetka название}