2022-04-24
872
2 minutes.


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
" "
& &
> >
< <
' &apos;
  • 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}



Save a link to this article


Next