Как создать 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="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 Обязательный элемент	Список категорий магазина. Каждой категории присваиваться уникальный номер, нумерация — на усмотрение магазина. при любых изменениях в прайс-листе id категорий должны оставаться неизменными; перед указанием необходимо подобрать конечные категории товара; рекомендуем указывать название категории согласно названию на нашем сайте. В одной категории не должно быть товаров из разных категорий на нашем сайте; в одной категории магазина не должно быть товаров из двух разных категорий на нашем сайте. Пример: `<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=”32635505” ━ id той категории на ROZETKA, где должны быть размещены товары. Приоритет rz_id выше, чем у названия категории. Например, если название категории в xml файле «Футболка», а в теге rz_id будет указан id категории «Носки» на сайте ROZETKA, то автоматически будет связь с категорией «Носки».
offers Обязательный элемент	Список предложений магазина. Открывается один раз, после тега . Закрывается в конце документа, перед тегом Пример: `<categories> <category id="261">Платья </category> <category id="391">Куртки </category> </categories> <offers> ... ... ... </offers>` Обратите внимание, тег не должен повторяться в пределах прайс-листа.
offer Обязательный элемент	Карточка товара. Закрывается тегом . каждый товар описывается отдельным элементом offer; каждому предложению необходимо присвоить уникальный номер id="...", нумерация – на усмотрение магазина; offer id должен оставаться неизменным, допускается использование символов: Aa-Zz и 0-9, не допускается использование кириллицы и пробелов атрибут available — указывает наличие товара: true — товар в наличии, false — товар не в наличии. На каждую разновидность товара: цвет, размер, объем, комплектацию и т.д. — должен быть создан отдельный уникальный 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) Необязательный элемент	Цена по промо-коду. Обязательно наличие тега в карточке товара со значением не меньше 2-х, а также соблюдение рекомендованной цены для участия в промо-активностях которая отображается в личном кабинете. Пример: `<price>820 </price> <price_promo>620 </price_promo> или` `<price>820 </price>` `<promo_price>620 </promo_price>` Подробнее: Участие в промо рассылках
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 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 Обязательный элемент	Бренд-производитель товара. Должен соответствовать нашим требованиям. Пример: `<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 Обязательный элемент	Описание товара. описание может быть однотипным для всей категории; в описании должна присутствовать информация только про товар; описание не должно содержать ссылок, телефонов, адресов, предложений услуг, акций, цен, картинок, видеообзоров и т.д.; описание желательно отформатировать с помощью html тегов. Html теги закрыть в . Пример: `<description> <!--[CDATA[<p-->Одежда <b>Abc clothes</b> способствует развитию… <p> </p> <p>Производитель: Эстония.</p> ]]> </description>`
state Необязательный элемент	Состояние товара. Используется в случае продажи Б/У и восстановленного товара used б/у товар refurbished восстановленный new новый Если тег state не указан, по умолчанию товарам проставляется статус new. Пример: `<state>used </state>`
... Обязательный элемент	Характеристики (параметры) товара. Название или значение характеристики (параметра) обязательно должны быть заполнены, не допускается наличие пустых тегов. Минимальное количество необходимых характеристик у товара = 3. в атрибуте name укажите название параметра (обязательно); в самом элементе ... укажите значение параметра. Пример: `<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 название}