All elements included in offer
in a custom type. YML and CSV formats
Information about formats
YML: this section describes all the elements of a single offer (offer
). Description of higher-level elements: shop
, promos
, YML header and root elements.
CSV: this section describes all elements for CSV format.
Examples
- Offer example (
offer
) for YML format -
<offer id="9012" type="vendor.model" bid="80"> <typePrefix>Мороженица</typePrefix> <vendor>Brand</vendor> <model>3811</model> <url>http://best.seller.ru/product_page.asp?pid=12345</url> <price>8990</price> <oldprice>9900</oldprice> <currencyId>RUR</currencyId> <categoryId>102</categoryId> <picture>http://best.seller.ru/img/model_12345.jpg</picture> <store>false</store> <pickup>false</pickup> <delivery>true</delivery> <delivery-options> <option cost="300" days="1" order-before="18"/> </delivery-options> <description> <![CDATA[ <h3>Мороженица Brand 3811</h3> <p>Это прибор, который придётся по вкусу всем любителям десертов и сладостей, ведь с его помощью вы сможете делать вкусное домашнее мороженое из натуральных ингредиентов.</p> ]]> </description> <param name="Цвет">белый</param> <sales_notes>Необходима предоплата.</sales_notes> <manufacturer_warranty>true</manufacturer_warranty> <country_of_origin>Китай</country_of_origin> <barcode>0123456789379</barcode> </offer>
- Example for CSV format
List and description of elements
Elements specific to custom description | Description | Required |
---|---|---|
| Type of offer description. The value must be In YML it is an attribute for | Required |
| Model and product name. | Required |
| Manufacturer. | Required |
| The product type / category (for example, “мобильный телефон (mobile phone)”, “стиральная машина (washing machine)”, “угловой диван (corner sofa)”). Note. The vendor , model , and typePrefix elements determine the offer title on Yandex.Market and affect the linking of the offer to a product profile. | Optional |
Standard elements | Description | Required |
| Product manufacturer's code. | Optional |
| Offer ID. May contain only numbers and Latin letters. Maximum length: 20 characters. Must be unique for each offer. In YML it is an attribute for | Required |
| Attention. This element is obsolete. Use the bid element instead. | Optional |
| Bid amount. In YML it is an attribute for | Optional |
| URL of the product page on the store's website. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard. | Required |
| Up-to-date product price. Note. If the product is sold by weight, length, and so on (not in pieces), specify the price for your unit of sale. For example, if you sell cable in coils, set the price per coil. In some categories (if the price list is sent in YML format), it is acceptable to indicate the bottom of the price range (“from”) using the View the list of categories “Банкетки и скамьи (Window-seats and benches)”, “Ванные комнаты (Bathrooms)”, “Гостиные (Living rooms)”, “Детские (Children's rooms)”, “Детские комоды (Children's dressers)”, “Диваны (Sofas)”, “Кабинеты (Offices)”, “Колыбели и люльки (Cradles and bassinets)”, “Комоды (Chests of drawers)”, “Компьютерные столы (Computer tables)”, “Кресла (Chairs)”, “Кровати (Beds)”, “Кухонные гарнитуры (Kitchen sets)”, “Кухонные уголки и обеденные группы (Kitchen nooks and dining room sets)”, “Манежи (Playpens)”, “Парты и стулья (School desks and chairs)”, “Полки (Shelves)”, “Прихожие (Entryways)”, “Пуфики (Ottomans)”, “Спальни (Bedrooms)”, “Стеллажи (Racks)”, “Столы и столики (Tables and end-tables)”, “Стулья, табуретки (Chairs and stools)”, “Тумбы (Bedside tables)”, “Шкафы (Cabinets)”. Example: | Required |
| The old price of the product should be higher than the current one. Yandex.Market automatically calculates the difference and shows users the discount. Note. Discount information is updated on Yandex.Market every 40 to 80 minutes. | Optional |
| Product purchase price. The purchase price is needed to calculate markups and for the configuration of marginality strategies in PriceLabs. | Optional |
enable_auto_discounts | Attention. Only used in YML format. Automatic calculation and display of discounts for offers. | Optional |
| Product price currency: Note. The text format doesn't allow you to indicate your currency conversion conditions. Prices displayed to the buyer will be converted to the appropriate currency using the current exchange rate of the Central Bank of the Russian Federation. | Required |
| Attention. Only used in YML format. Product category ID assigned by the store (an integer up to 18 digits long). | Required |
| Attention. Only used in CSV format. Name of the product category. | Required |
| URL link to product image. We recommend that you review the link and image requirements. | Required for some categories. See the detailed description of the element. |
| Availability of courier delivery (for all regions that the store delivers to). Possible values:
Important. At least one of the elements — delivery or pickup — must have the value true . If both elements have the value false , the product won't be shown on Yandex.Market.If the element is not specified, courier delivery is automatically considered to be available (the default value is | Optional |
| Availability of customer pickup at pickup points (in all regions that the store delivers to). Possible values:
Important. At least one of the elements — delivery or pickup — must have the value true . If both elements have the value false , the product won't be shown on Yandex.Market.Attention. Be sure to create points of sale in your store account so that the availability of customer pickup is displayed. If the element is not specified, customer pickup is automatically considered to be available (the default value is | Optional |
| Attention. Only used in YML format. Terms of courier delivery service for this product in the store's local region (types of delivery, period, cost). You can also set up delivery terms for your local region in your store account. | Optional |
| Attention. Only used in YML format. Customer pickup conditions in the store's region (timeframe, cost). You can also set up pickup conditions for your local region in your store account. | Optional |
| Attention. Only used in CSV format. Period (in days) for the product delivery by courier in the store's local region.
Examples of values The maximum period that Yandex.Market shows is 31 days. If you specify a value of 32 or more, information on a delivery taking “up to 60 days” will be displayed (or a “pre-order” label will be displayed if the Yandex.Market database contains a date when the product will officially start being sold). You can also set up a delivery period for your local region in your store account. | Optional |
| Attention. Only used in CSV format. Cost of courier delivery in the store's region. For free delivery, set the value to 0. You can also set up delivery cost for your local region in your store account. | Optional |
| Attention. Only used in CSV format. Delivery period to pickup points in the store's region (in days).
Examples of values The product is available for customer pickup: The maximum period that Yandex.Market shows is 31 days. If you specify a value of 32 or more, information on a delivery taking “up to 60 days” will be displayed (or a “pre-order” label will be displayed if the Yandex.Market database contains a date when the product will officially start being sold). You can also set up pickup conditions for your local region in your store account. | Optional |
| Attention. Only used in CSV format. The collection cost from pickup points in the store's region. If pickup is free, enter 0. You can also set up pickup conditions for your local region in your store account. | Optional |
| Option to purchase a product without a pre-order. Possible values:
| Optional |
| Offer description. Maximum text length is 3,000 characters (including punctuation marks).
The following are not allowed in the description: In YML format you can use some XHTML tags, provided that they are enclosed in a CDATA block and that the general rules of the XHTML standard are followed. | Optional |
|
The text may be up to 50 characters in length. | See detailed element description. |
min-quantity | Attention. Only used in YML format. Minimum number of identical products in an order (in cases where a product can only be ordered as part of a set and not individually)This element is only used in the following categories: “Автошины (Car tires)”, “Грузовые шины (Truck tires)”, “Мотошины (Motorcycle tires)”, “Диски (Wheel rims)”. If the element is not specified, the default value "1" is used. | Optional |
| Manufacturer's official warranty. Possible values:
| Optional |
| The product's country of manufacture. A list of countries that can be specified in this element is available at: http://partner.market.yandex.ru/pages/help/Countries.pdf. | Optional |
| The product is of a sexual nature or pertains to sexual interest in any way. Possible values: | Optional |
| Product manufacturer's barcode in one of the following formats: EAN-13, EAN-8, UPC-A, or UPC-E. In YML, the | Optional |
| All important characteristics of the product: color, size, volume, material, weight, age, gender, etc. In YML, the | For some categories this is a required element. |
condition | Attention. Only used in YML format. Use this element for used goods and products marked down due to defects. In the
In the Example: Attention. Information about the reasons for the price reduction should be exhaustive. Your texts shouldn't be evasive. For example, you shouldn't write: “Contact our consultant to get the reasons for the price reduction”. If the item is not marked down, don't use this item. | Optional |
credit-template | Attention. Only used in YML format. Credit program ID.
| Optional |
credit-template-ids | Attention. Only used in CSV format. Credit program ID.
| Optional |
condition-type | Attention. Only used in CSV format. Use this element for used goods and products marked down due to defects. Enter the condition of the product into the element. Possible values:
If the item is not marked down, don't use this item. | Optional |
condition-reason | Attention. Only used in CSV format. Reasons for the price reduction and a detailed description of defects. Information about the reasons for the price reduction should be exhaustive. Your texts shouldn't be evasive. For example, you shouldn't write: “Contact our consultant to get the reasons for the price reduction”. | Required if specified condition-type |
| Product's period of use or expiration date. The value must be in ISO 8601 format:
| Optional |
| Item weight in kilograms including packaging. . In any category, the weight can be specified accurate to one thousandth (for example, 1.001, using a dot as a decimal point). If the minimum value is set to 0, there is no minimum weight limit and it can be specified starting from one gram (0.001 kg). | Optional |
| Product dimensions (length, width, height) including packaging. Specify dimensions in centimeters. Format: three positive numbers with accuracy of 0.001, using a dot as the decimal separator. The numbers must be separated by the slash character “/” without spaces. | Optional |
| The product can be downloaded. If | Optional |
| Using the If you want to use In YML it is an attribute for | Optional |
| Product's age category.
| Optional |
group_id | Attention. This element is used only in YML format and only in the following categories: Одежда, обувь и аксессуары (Clothing, shoes and accessories), Мебель (Furniture), Косметика, парфюмерия и уход (Cosmetics, perfumes and personal care products), Детские товары (Children's goods), Аксессуары для портативной электроники (Portable electronics accessories). This element is used in descriptions for all offers that are variants of a particular model. The elements should all have the same value. The element value must be an integer with no more than 9 digits. This is an attribute for the | Optional |
Elements specific to custom description | Description | Required |
---|---|---|
| Type of offer description. The value must be In YML it is an attribute for | Required |
| Model and product name. | Required |
| Manufacturer. | Required |
| The product type / category (for example, “мобильный телефон (mobile phone)”, “стиральная машина (washing machine)”, “угловой диван (corner sofa)”). Note. The vendor , model , and typePrefix elements determine the offer title on Yandex.Market and affect the linking of the offer to a product profile. | Optional |
Standard elements | Description | Required |
| Product manufacturer's code. | Optional |
| Offer ID. May contain only numbers and Latin letters. Maximum length: 20 characters. Must be unique for each offer. In YML it is an attribute for | Required |
| Attention. This element is obsolete. Use the bid element instead. | Optional |
| Bid amount. In YML it is an attribute for | Optional |
| URL of the product page on the store's website. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard. | Required |
| Up-to-date product price. Note. If the product is sold by weight, length, and so on (not in pieces), specify the price for your unit of sale. For example, if you sell cable in coils, set the price per coil. In some categories (if the price list is sent in YML format), it is acceptable to indicate the bottom of the price range (“from”) using the View the list of categories “Банкетки и скамьи (Window-seats and benches)”, “Ванные комнаты (Bathrooms)”, “Гостиные (Living rooms)”, “Детские (Children's rooms)”, “Детские комоды (Children's dressers)”, “Диваны (Sofas)”, “Кабинеты (Offices)”, “Колыбели и люльки (Cradles and bassinets)”, “Комоды (Chests of drawers)”, “Компьютерные столы (Computer tables)”, “Кресла (Chairs)”, “Кровати (Beds)”, “Кухонные гарнитуры (Kitchen sets)”, “Кухонные уголки и обеденные группы (Kitchen nooks and dining room sets)”, “Манежи (Playpens)”, “Парты и стулья (School desks and chairs)”, “Полки (Shelves)”, “Прихожие (Entryways)”, “Пуфики (Ottomans)”, “Спальни (Bedrooms)”, “Стеллажи (Racks)”, “Столы и столики (Tables and end-tables)”, “Стулья, табуретки (Chairs and stools)”, “Тумбы (Bedside tables)”, “Шкафы (Cabinets)”. Example: | Required |
| The old price of the product should be higher than the current one. Yandex.Market automatically calculates the difference and shows users the discount. Note. Discount information is updated on Yandex.Market every 40 to 80 minutes. | Optional |
| Product purchase price. The purchase price is needed to calculate markups and for the configuration of marginality strategies in PriceLabs. | Optional |
enable_auto_discounts | Attention. Only used in YML format. Automatic calculation and display of discounts for offers. | Optional |
| Product price currency: Note. The text format doesn't allow you to indicate your currency conversion conditions. Prices displayed to the buyer will be converted to the appropriate currency using the current exchange rate of the Central Bank of the Russian Federation. | Required |
| Attention. Only used in YML format. Product category ID assigned by the store (an integer up to 18 digits long). | Required |
| Attention. Only used in CSV format. Name of the product category. | Required |
| URL link to product image. We recommend that you review the link and image requirements. | Required for some categories. See the detailed description of the element. |
| Availability of courier delivery (for all regions that the store delivers to). Possible values:
Important. At least one of the elements — delivery or pickup — must have the value true . If both elements have the value false , the product won't be shown on Yandex.Market.If the element is not specified, courier delivery is automatically considered to be available (the default value is | Optional |
| Availability of customer pickup at pickup points (in all regions that the store delivers to). Possible values:
Important. At least one of the elements — delivery or pickup — must have the value true . If both elements have the value false , the product won't be shown on Yandex.Market.Attention. Be sure to create points of sale in your store account so that the availability of customer pickup is displayed. If the element is not specified, customer pickup is automatically considered to be available (the default value is | Optional |
| Attention. Only used in YML format. Terms of courier delivery service for this product in the store's local region (types of delivery, period, cost). You can also set up delivery terms for your local region in your store account. | Optional |
| Attention. Only used in YML format. Customer pickup conditions in the store's region (timeframe, cost). You can also set up pickup conditions for your local region in your store account. | Optional |
| Attention. Only used in CSV format. Period (in days) for the product delivery by courier in the store's local region.
Examples of values The maximum period that Yandex.Market shows is 31 days. If you specify a value of 32 or more, information on a delivery taking “up to 60 days” will be displayed (or a “pre-order” label will be displayed if the Yandex.Market database contains a date when the product will officially start being sold). You can also set up a delivery period for your local region in your store account. | Optional |
| Attention. Only used in CSV format. Cost of courier delivery in the store's region. For free delivery, set the value to 0. You can also set up delivery cost for your local region in your store account. | Optional |
| Attention. Only used in CSV format. Delivery period to pickup points in the store's region (in days).
Examples of values The product is available for customer pickup: The maximum period that Yandex.Market shows is 31 days. If you specify a value of 32 or more, information on a delivery taking “up to 60 days” will be displayed (or a “pre-order” label will be displayed if the Yandex.Market database contains a date when the product will officially start being sold). You can also set up pickup conditions for your local region in your store account. | Optional |
| Attention. Only used in CSV format. The collection cost from pickup points in the store's region. If pickup is free, enter 0. You can also set up pickup conditions for your local region in your store account. | Optional |
| Option to purchase a product without a pre-order. Possible values:
| Optional |
| Offer description. Maximum text length is 3,000 characters (including punctuation marks).
The following are not allowed in the description: In YML format you can use some XHTML tags, provided that they are enclosed in a CDATA block and that the general rules of the XHTML standard are followed. | Optional |
|
The text may be up to 50 characters in length. | See detailed element description. |
min-quantity | Attention. Only used in YML format. Minimum number of identical products in an order (in cases where a product can only be ordered as part of a set and not individually)This element is only used in the following categories: “Автошины (Car tires)”, “Грузовые шины (Truck tires)”, “Мотошины (Motorcycle tires)”, “Диски (Wheel rims)”. If the element is not specified, the default value "1" is used. | Optional |
| Manufacturer's official warranty. Possible values:
| Optional |
| The product's country of manufacture. A list of countries that can be specified in this element is available at: http://partner.market.yandex.ru/pages/help/Countries.pdf. | Optional |
| The product is of a sexual nature or pertains to sexual interest in any way. Possible values: | Optional |
| Product manufacturer's barcode in one of the following formats: EAN-13, EAN-8, UPC-A, or UPC-E. In YML, the | Optional |
| All important characteristics of the product: color, size, volume, material, weight, age, gender, etc. In YML, the | For some categories this is a required element. |
condition | Attention. Only used in YML format. Use this element for used goods and products marked down due to defects. In the
In the Example: Attention. Information about the reasons for the price reduction should be exhaustive. Your texts shouldn't be evasive. For example, you shouldn't write: “Contact our consultant to get the reasons for the price reduction”. If the item is not marked down, don't use this item. | Optional |
credit-template | Attention. Only used in YML format. Credit program ID.
| Optional |
credit-template-ids | Attention. Only used in CSV format. Credit program ID.
| Optional |
condition-type | Attention. Only used in CSV format. Use this element for used goods and products marked down due to defects. Enter the condition of the product into the element. Possible values:
If the item is not marked down, don't use this item. | Optional |
condition-reason | Attention. Only used in CSV format. Reasons for the price reduction and a detailed description of defects. Information about the reasons for the price reduction should be exhaustive. Your texts shouldn't be evasive. For example, you shouldn't write: “Contact our consultant to get the reasons for the price reduction”. | Required if specified condition-type |
| Product's period of use or expiration date. The value must be in ISO 8601 format:
| Optional |
| Item weight in kilograms including packaging. . In any category, the weight can be specified accurate to one thousandth (for example, 1.001, using a dot as a decimal point). If the minimum value is set to 0, there is no minimum weight limit and it can be specified starting from one gram (0.001 kg). | Optional |
| Product dimensions (length, width, height) including packaging. Specify dimensions in centimeters. Format: three positive numbers with accuracy of 0.001, using a dot as the decimal separator. The numbers must be separated by the slash character “/” without spaces. | Optional |
| The product can be downloaded. If | Optional |
| Using the If you want to use In YML it is an attribute for | Optional |
| Product's age category.
| Optional |
group_id | Attention. This element is used only in YML format and only in the following categories: Одежда, обувь и аксессуары (Clothing, shoes and accessories), Мебель (Furniture), Косметика, парфюмерия и уход (Cosmetics, perfumes and personal care products), Детские товары (Children's goods), Аксессуары для портативной электроники (Portable electronics accessories). This element is used in descriptions for all offers that are variants of a particular model. The elements should all have the same value. The element value must be an integer with no more than 9 digits. This is an attribute for the | Optional |