Как создать 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-файла
Описание элементов
Элемент | Описание |
---|---|
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="EUR" 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>https://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, EUR, EUR, RUR. Пример: <currencyid>UAH </currencyid> <currencyid>EUR </currencyid> <currencyid>EUR </currencyid> <currencyid>RUR </currencyid> |
categoryId
Обязательный элемент |
ID категории, к которой привязан данный товар. Пример: <categoryid>391 </categoryid> |
picture
Обязательный элемент |
Ссылка на фото товара. Первая фотография в списке будет основной в карточке товара. Ссылка не должна содержать кириллицу и, пробелы, максимальное количество символов ━ 1999. Минимальное количество фото ━ 1, максимальное ━ 15. Пример: <picture>https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg </picture> <picture>https://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg </picture> <picture>https://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 название}