How to create an XML file for Rozetka.ua (sockets)

To list products on Rozetka.ua, you need to prepare a price list with offers in XML (YML) format. While the store is running, the xml link address must be static and not change.

XML (YML) file requirements

the XML (YML) standard does not allow the use of non-printable characters with ASCII codes from 0 to 31 (with the exception of characters with codes 9, 10, 13 - tab, line feed, carriage return).
the characters ", &, >, <, ' must be replaced with equivalent codes. The requirement applies only to the text and does not affect the writing of tags;
it is forbidden to change the id of products and categories after adding to the ROZETKA website.

Symbol in text	Code for XML file
"
&
>
<
'

The URL address of a product offer on the store website must be encoded in accordance with the RFC-1738 standard.
valid XML (YML) file encoding: UTF-8.

XML file example

Description of elements

Element	Description
yml_catalog Required element	The root element of the YML format. The date attribute specifies the date and time the XML (YML) was generated or modified. The date must be in YYYY-MM-DD hh:mm format.
shop Required element	Contains a description of the store and its product offerings.
name Optional element	Short store name. Not published, used for internal identification. The maximum number of characters is ━ 255.
company Optional element	The full name of the company that owns the store. Not published, used for internal identification. The maximum number of characters is ━ 255.
url Optional element	URL of the main page of an existing store. The maximum number of characters is ━ 255.
platform Optional element	The content management system on which the store operates (CMS).
currencies Required element	List of store exchange rates. Each of the currencies is described by a separate currency element. Example: Prices on the site are displayed only in UAH. Only hryvnia has rate="1". YML uses a dot or a comma to separate the integer and fractional parts of any numbers, regardless of locale. The value in the currency id=". . . " attribute is specified according to the ISO 4217 standard as a three-letter alphabetic (alfa-3) currency code.
categories Required element	List of store categories. Each category is assigned a unique number, the numbering is at the discretion of the store. for any changes in the price list, category id must remain unchanged; before specifying, it is necessary to select the final categories of goods; We recommend that you indicate the name of the category according to the name on our website. In one category there should not be products from different categories on our site; in one category of the store there should not be products from two different categories on our website. Example: `Угловые диваны Смарт-часы Детские игровые комплексы` `Угловые диваны Смарт-часы Детские игровые комплексы` `Угловые диваны Смарт-часы Детские игровые комплексы` The maximum number of characters is ━ 255.
rz_id Optional element	Provides automatic linking of the category from the price list with the ROZETKA category. It is indicated only in the list of categories, your category id is indicated in the product card. Example: `Джемы и начинки` id="12345" ━ your category id; rz_id=”32635505” ━ id of the category on ROZETKA where the products should be placed. The priority of rz_id is higher than that of the category name. For example, if the name of the category in the xml file is "T-shirt", and the id of the "Socks" category on the ROZETKA website is indicated in the rz_id tag, then there will automatically be a connection with the "Socks" category.
offers Required element	Shop offer list. Opens once, after the tag. Closes at the end of the document, before the tag Example: `Платья Куртки . . . . . . . . .` `Платья Куртки . . . . . . . . .` `Платья Куртки . . . . . . . . .` Please note that the tag must not be repeated within the price list.
offer Required element	Card Product. Closed with tag. each product is described by a separate offer element; each offer must be assigned a unique number id=". . . ", numbering is at the discretion of the store; offer id must remain unchanged, characters are allowed: Aa-Zz and 0-9, Cyrillic and spaces are not allowed the available attribute indicates the availability of the product: true — the product is available, false — the product is not available. For each type of product: color, size, volume, configuration, etc. — a separate unique offer must be created. On our website, products will be grouped into 1 offer with a choice of color, size, volume, etc. Example: `. . .`
stock_quantity (quantity_in_stock) Required element	The rest of the goods. The product will be in stock on the site as long as this parameter is greater than 0. Please note that when using the tag, it is mandatory to indicate it in all products in the price list, otherwise products without this tag will be assigned the “Out of stock” status. Also be sure to follow the value in the available=". . . " tag if stock_quantity > 0 ━ true, if stock_quantity < 0 ━ false. Example: `10`
url (in offer) Optional element	Link to the product on your site. Example: `http://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx. html` The maximum number of characters is ━ 500.
price Required element	The price of the product. Specify only a whole number, kopecks are rounded on the site. Example: `4499` YML uses a dot or a comma to separate the integer and fractional parts of any numbers. The price indicated with kopecks will be rounded on the site.
price_old (old_price) Optional element	The old price of the products will be crossed out on the site. Specify after the tag. Tag value must be higher than the value of the tag Example: `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` `3999 4499 или 3999 4499` Read more: Product discount
price_promo (promo_price) Optional element	Promo code price. Must have a tag in the product card with a value of at least 2, as well as compliance with the recommended price for participating in promotional activities, which is displayed in your account. Example: `820 620 или` `820 620 или` `820 620 или` `820` `620` Read more: Participation in promotional mailings
currencyId Required element	Currency in which the price of the products is indicated: UAH, USD, EUR, RUR. Example: `UAH USD EUR RUR` `UAH USD EUR RUR` `UAH USD EUR RUR` `UAH USD EUR RUR`
categoryId Required element	ID of the category to which this product is associated. Example: `391`
picture Required element	Link to product photo. The first photo in the list will be the main one in the product card. The link should not contain Cyrillic and spaces, the maximum number of characters is ━ 1999. The minimum number of photos is ━ 1, the maximum is 15. Example: `http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg http://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg` `http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg http://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg` `http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-1.jpg http://elbuz.com/upload/iblock/a53/a5391cddb40be91705-2.jpg http://elbuz.com/upload/iblock/a53/a5391cddb40be91703-3.jpg` If your server has a restriction on uploading photos, you need to add the following subnets to the exceptions: 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 Required element	Manufacturer's brand. Should meet our requirements . Example: `Abc clothes`
name (model) Required element	Product Name. Please adhere to our requirements and recommendations when specifying. the price list cannot contain two products with exactly the same name; the brand indicated in the title and in the tag should be the same. The model tag can be used as a title instead of the name tag. Example: `Куртка 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)` The maximum number of characters is ━ 255.
description Required element	Product description. the description can be the same type for the whole category; the description should contain information only about the product; the description should not contain links, phone numbers, addresses, service offers, promotions, prices, pictures, video reviews, etc. ; The description should preferably be formatted using html tags. Html tags close in . Example: `Одежда <b>Abc clothes</b> способствует развитию…` Producer: Estonia. ]]>
state Optional element	Product condition. used in the case of used and refurbished goods used goods refurbished new If the state tag is not specified, by default the products are assigned the new status. Example: `used`
. . . Required element	Characteristics (parameters) of the goods. The name or value of the characteristic (parameter) must be filled in, empty tags are not allowed. The minimum number of required characteristics for a product = 3. in the name attribute, specify the name of the parameter (required); in the element itself . . . specify the parameter value. Example: `Черный` In a multivalued parameter, the values are listed separated by commas and closed in CDATA. The maximum number of characters is ━ 255.
paramid=". . . " Optional element	id of the characteristic (parameter) on the ROZETKA website, is prescribed for automatic binding of the parameter and speeding up the moderation process. If the parameter type (characteristics) is: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ additional valueid=". . . " tag is required Example: `2`
valueid=". . . " Optional element	id of the value of the characteristic (parameter) on the ROZETKA website, is prescribed for autobinding the value and speeding up the moderation process. Example: `Осенняя, Весенняя, Летняя` The maximum number of characters is ━ 255.

To unload in XML, use macro substitutions
{Attribute: Rozetka ID}
{Attribute: Rozetka name}