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

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.

Required element

Contains a description of the store and its product offerings.

Optional element

Short store name. Not published, used for internal identification.

The maximum number of characters is ━ 255.

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.

Optional element

URL of the main page of an existing store.

The maximum number of characters is ━ 255.

Optional element

The content management system on which the store operates (CMS).

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.

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.

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.

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.

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:

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:

Optional element

Link to the product on your site.

Example:

The maximum number of characters is ━ 500.

Required element

The price of the product. Specify only a whole number, kopecks are rounded on the site.

Example:

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.

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:

Read more: Product discount

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

Read more: Participation in promotional mailings

Required element

Currency in which the price of the products is indicated: UAH, EUR, EUR, RUR.

Example:

Required element

ID of the category to which this product is associated.

Example:

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:

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

Required element

Manufacturer's brand.

Should meet our requirements .

Example:

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:

The maximum number of characters is ━ 255.

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:

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:

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.

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:

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.