Market for partners

<offers>

The <offers> element contains a list of the store's product offers. Each product offer is described in a separate <offer> element.

<offers>
    <offer>...</offer>
    ...
</offers>

YML has several types of product offer descriptions. The type determines which fields are used to describe the offer. Product offers that are not described correctly for their type might not be accepted for publication.

The description type is set in the type attribute for the <offer> element:

<offer id="123" type="vendor.model" available="true">
    <url>...</url>
    ...
</offer>

The id attribute specifies the identifier of the product offer. This attribute may contain only numbers and Latin letters. The maximum length of the id is 20 characters.

Attention! 

The offer ID is required; it must be :

  • unique within all the product offers in a single price list;

  • consistent for the same offer in all versions of a single price list;

  • consistent for the same offer in different price lists of a single store.

If identical id attributes are set for two or more product offers, the ID is only assigned to the first of these offers. For the others, you will get a warning message about a missing identifier.

The available attribute specifies the product's availability status:

  • false — The product offer must be ordered. The store is prepared to take an order and deliver the product within the time-frame agreed upon with the customer, which is no more than two months (with the exception of products that are manufactured on order; their approximate delivery date is negotiated with the customer during the order process).

  • true — The product offer is in stock. The store is prepared to arrange delivery/purchase of the product immediately.

For additional information, refer to the document Requirements for Advertising Materials.

Examples of using various description types:

Simplified description

This is the basic, simplest type of description, but it lacks many features.

Example:

<offer id="12346" available="true" bid="21">
    <url>http://best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <picture>http://best.seller.ru/img/device12345.jpg</picture>
    <store>false</store>
    <pickup>true</pickup>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Наручные часы Casio A1234567B</name>
    <vendor>Casio</vendor>
    <vendorCode>A1234567B</vendorCode>
    <description>Изящные наручные часы.</description>
    <sales_notes>Необходима предоплата.</sales_notes>
    <manufacturer_warranty>P2Y</manufacturer_warranty>
    <country_of_origin>Япония</country_of_origin>
    <barcode>0123456789012</barcode>  
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

local_delivery_cost

Cost of delivering this product within your region.

Optional element.

name

Name of the product offer. In the name of a simplified offer, we recommend specifying the product name and code used by the manufacturer.

Required element.

vendor

Manufacturer. Not displayed in the name of the product offer.

Optional element.

vendorCode

Product code (specify the manufacturer's code). Not displayed in the name of the product offer.

Optional element.

description

Description of the product offer.

Optional element.

sales_notes

This element is used for indicating information about the minimum order amount, minimum product lot, or prepayment requirements. It is also used for describing special offers, discounts, and sales. The text may be up to 50 characters in length.

Optional element.

manufacturer_warranty

This element indicates products that have an official manufacturer's warranty.

Optional element.

Possible values:

1) false — Product does not have an official warranty.

2) true — Product has an official warranty.

3) Length of guarantee. The format must conform to ISO 8601, such as: P1Y2M10DT2H30M. This represents 1 year, 2 months, 10 days, 2 hours and 30 minutes.

country_of_origin

This element indicates the country where the product was manufactured. A list of countries that can be specified in this element is available at: http://partner.market.yandex.ru/pages/help/Countries.pdf.

Note. If you want to participate in the Market Ordering program, you should preferably specify this element in the YML file.

Optional element.

adult

This element is mandatory for designating products that are related to satisfying sexual needs or that pertain to sexual interest in any way.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18. Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

barcode

The product's barcode as specified by the manufacturer.

Optional element. The <offer> element may contain multiple <barcode> elements.

param

This element is intended for defining product characteristics. Each parameter is described using a separate <param> element.

Optional element. The <offer> element may contain multiple <param> elements.

Custom product (vendor.model)

This type of description is the most convenient and versatile. It is recommended for describing products in most of the Yandex.Market categories.

Example:
<offer id="12341" type="vendor.model" available="true" bid="13">
    <url>http://best.seller.ru/product_page.asp?pid=12344</url>
    <price>700</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <picture>http://best.seller.ru/img/device12345.jpg</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <typePrefix>Принтер</typePrefix>
    <vendor>НP</vendor>
    <vendorCode>CH366C</vendorCode>
    <model>Deskjet D2663</model>
    <description>Серия принтеров для людей, которым нужен надежный, простой в использовании 
    цветной принтер для повседневной печати. Формат А4. Технология печати: 4-цветная термальная струйная. 
    Разрешение при печати: 4800х1200 т/д.
    </description>
    <sales_notes>Необходима предоплата.</sales_notes>
    <manufacturer_warranty>true</manufacturer_warranty>
    <seller_warranty>P3Y</seller_warranty>
    <country_of_origin>Япония</country_of_origin>
    <barcode>1234567890120</barcode>
    <cpa>1</cpa>
    <rec>123123,1214,243</rec>
    <expiry>P5Y</expiry>
    <weight>2.07</weight>
    <dimensions>100/25.45/11.112</dimensions>
    <param name="Максимальный формат">А4</param>
    <param name="Технология печати">термическая струйная</param>
    <param name="Тип печати">Цветная</param>
    <param name="Количество страниц в месяц" unit="стр">1000</param>
    <param name="Потребляемая мощность" unit="Вт">20</param>
    <param name="Вес" unit="кг">2.73</param>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

For product offers belonging to the Clothing and shoes category, this element is mandatory. For all other categories, it is optional.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

local_delivery_cost

Cost of delivering this product within your region.

Optional element.

typePrefix

Group of products or categories.

Optional element.

vendor

Manufacturer.

Required element.

vendorCode

Product code (specify the manufacturer's code).

Optional element.

model

Model.

Required element.

description

Description of the product offer.

Optional element.

sales_notes

This element is used for indicating information about the minimum order amount, minimum product lot, or prepayment requirements. It is also used for describing special offers, discounts, and sales. The text may be up to 50 characters in length.

Optional element.

manufacturer_warranty

This element indicates products that have an official manufacturer's warranty.

Possible values:

1) false — Product does not have an official warranty.

2) true — Product has an official warranty.

3) Length of guarantee. The format must conform to ISO 8601, such as: P1Y2M10DT2H30M. This represents 1 year, 2 months, 10 days, 2 hours and 30 minutes.

Optional element.

seller_warranty

This element indicates products that have a seller's guarantee.

Optional element.

Possible values:

1) false — Product does not have a seller's guarantee.

2) true — Product is guaranteed by the seller.

3) Length of guarantee. The format must conform to ISO 8601, such as: P3Y. This represents 3 years.

country_of_origin

This element indicates the country where the product was manufactured. A list of countries that can be specified in this element is available at: http://partner.market.yandex.ru/pages/help/Countries.pdf.

Note. If you want to participate in the Market Ordering program, you should preferably specify this element in the YML file.

Optional element.

downloadable

This element indicates a product that can be downloaded.

Optional element.

adult

This element is mandatory for designating products that are related to satisfying sexual needs or that pertain to sexual interest in any way.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18. Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

barcode

The product's barcode as specified by the manufacturer.

Optional element. The <offer> element may contain multiple <barcode> elements.

cpa

Use this element to manage product offer participation in the Market Ordering program.

Optional element.

rec

This element designates products that are recommended to purchase together with the current product.

Optional element.

expiry

This element is used for defining the service life or the date of expiration.

The value must be in ISO 8601 format:

— for the shelf life or service life: P1Y2M10DT2H30M. This represents 1 year, 2 months, 10 days, 2 hours and 30 minutes.

— for the use-by date or expiration date: YYYY-MM-DDThh:mm.

Optional element.

weight

This element indicates the product weight. Weight is defined in kilograms including packaging.

Element format: a positive number with accuracy of 0.001, using a dot as the decimal separator.

If a more precise value is entered, it is automatically rounded off in the following way:

— if the fourth number after the decimal point is less than 5, the third number remains and all the following numbers are removed.

— if the fourth number after the decimal point is greater than or equal to 5, the third number is increased by one and all the following numbers are removed.

Optional element.

dimensions

This element indicates the product dimensions (length, width, height) including packaging. Dimensions are defined in centimeters.

Element format: three positive numbers with accuracy of 0.001, using a dot as the decimal separator. The numbers must be separated by the slash symbol “/”, without spaces.

If a more precise value is entered, it is automatically rounded off in the following way:

— if the fourth number after the decimal point is less than 5, the third number remains and all the following numbers are removed.

— if the fourth number after the decimal point is greater than or equal to 5, the third number is increased by one and all the following numbers are removed.

Optional element.

param

This element is intended for defining product characteristics. Each parameter is described using a separate <param> element.

Optional element. The <offer> element may contain multiple <param> elements.

Books (book)

Example:
<offer id="12342" type="book" available="true" bid="17">
    <url>http://best.seller.ru/product_page.asp?pid=14345</url>
    <price>80</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <author>Александра Маринина</author>
    <name>Все не так. В 2 томах. Том 1</name>
    <publisher>Эксмо</publisher>
    <series>А. Маринина — королева детектива</series>
    <year>2007</year>
    <ISBN>978-5-699-23647-3</ISBN>
    <volume>2</volume>
    <part>1</part>
    <language>rus</language>
    <binding>70x90/32</binding>
    <page_extent>288</page_extent>
    <description>Все прекрасно в большом патриархальном семействе
    Руденко. Но — увы! — впечатление это обманчиво: каждого
    из многочисленных представителей семьи обуревают свои потаенные 
    страсти и запретные желания.</description>
    <downloadable>false</downloadable>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

local_delivery_cost

Cost of delivering this product within your region.

Optional element.

author

Author of the work.

Optional element.

name

Title of the work.

Required element.

publisher

Publisher.

Optional element.

series

Series.

Optional element.

year

Year of publication.

Optional element.

ISBN

The book's code; if there are several, separate them with commas.

The ISBN and SBN formats are checked for validity. Validation checks the length of the code as well as the check digit — the last number in the code must fit the other numbers according to a special formula. When the ISBN is divided into hyphenated parts (such as 978-5-94878-004-7), the code is verified against additional requirements for the number of digits in each part.

Optional element.

volume

Number of volumes.

Optional element.

part

Volume number.

Optional element.

language

Language of the work.

Optional element.

binding

Binding (hardcover, paperback).

Optional element.

page_extent

Total number of pages in the book; must be a positive integer.

Optional element.

table_of_contents

Contents. Information about names of works for a collection of stories or poetry.

Optional element.

description

Summary of the book.

Optional element.

downloadable

This element indicates a product that can be downloaded.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18. Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

Audiobooks (audiobook)

Example:
<offer id="12342" type="audiobook" available="true" bid="17">
    <url>http://best.seller.ru/product_page.asp?pid=14345</url>
    <price>200</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
    <author>Владимир Кунин</author>
    <name>Иваnов и Rабинович, или Аj'гоу ту 'Хаjфа!</name>
    <publisher>1С-Паблишинг, Союз</publisher>
    <year>2008</year>
    <ISBN>978-5-9677-0757-5</ISBN>
    <language>ru</language>
    <performed_by>Николай Фоменко</performed_by>
    <performance_type>начитана </performance_type>
    <storage>CD</storage>
    <format>mp3</format>
    <description>Перу Владимира Кунина принадлежат десятки сценариев
    к кинофильмам, серия книг про КЫСЮ и многое, многое другое.</description>
    <downloadable>true</downloadable>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

author

Author of the work.

Optional element.

name

Title of the work.

Required element.

publisher

Publisher.

Optional element.

series

Series.

Optional element.

year

Year of publication.

Optional element.

ISBN

The book's code; if there are several, separate them with commas.

The ISBN and SBN formats are checked for validity. Validation checks the length of the code as well as the check digit — the last number in the code must fit the other numbers according to a special formula. When the ISBN is divided into hyphenated parts (such as 978-5-94878-004-7), the code is verified against additional requirements for the number of digits in each part.

Optional element.

volume

Volume number.

Optional element.

part

Part number.

Optional element.

language

Language of the work.

Optional element.

table_of_contents

Contents. Information about names of works for a collection of stories or poetry.

Optional element.

performed_by

Performer. If there are several, they are separated by commas.

Optional element.

performance_type

Type of audiobook (radio play, reading of a work, ...).

Optional element.

storage

The media format of the audiobook.

Optional element.

format

Audiobook format.

Optional element.

recording_length

The length of the recording is set in the format mm.ss (minutes.seconds).

Optional element.

description

Summary of the book.

Optional element.

downloadable

This element indicates a product that can be downloaded.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18.

Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

Music and video productions (artist.title)

Example (music):
<offer id="12345" type="artist.title" available="true" bid="11">
    <url>http://best.seller.ru/product_page.asp?pid=12946</url>
    <price>15</price>
    <currencyId>USD</currencyId>
    <categoryId>2</categoryId>
    <picture>http://best.seller.ru/product_page.asp?pid=14345.jpg</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <artist>Pink Floyd</artist>
    <title>Dark Side Of The Moon, Platinum Disc</title>
    <year>1999</year>
    <media>CD</media>
    <description>Dark Side Of The Moon, поставивший мир на уши
    невиданным сочетанием звуков, — это всего-навсего девять 
    треков, и даже не все они писались специально для альбома. 
    Порывшись по сусекам, участники Pink Floyd мудро сделали 
    новое из хорошо забытого старого — песен, которые 
    почему-либо не пошли в дело или остались незаконченными. 
    Одним из источников вдохновения стали саундтреки 
    для кинофильмов, которые группа производила в больших количествах.</description>
    <barcode>2345678901234</barcode>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

artist

Performer.

Optional element.

title

Title.

Required element.

year

Year of release.

Optional element.

media

Media format.

Optional element.

description

Description of the product offer.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18.

Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

barcode

The product's barcode as specified by the manufacturer.

Optional element. The <offer> element may contain multiple <barcode> elements.

Example (video):
<offer id="12344" type="artist.title" available="true" bid="56">
    <url>http://best.seller.ru/product_page.asp?pid=92347</url>
    <price>93</price>
    <currencyId>RUR</currencyId>
    <categoryId>2</categoryId>
    <picture>http://best.seller.ru/img/device92347.jpg</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <title>Свадьба Мюриэл</title>
    <year>1999</year>
    <media>DVD</media>
    <starring>Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)</starring>
    <director>П Дж Хоген</director>
    <originalName>Muriel's wedding</originalName>
    <country>Австралия</country>
    <description>Гадкий утенок из провинциального городка покидает свое 
    гнездо, и в компании своей подруги отправляется искать веселой жизни в большой 
    и загадочный город. Фильм о мечтах и реальности, дружбе и юности молодой девушки, 
    приключения которой повторяют судьбы Золушки и героини Джулии Робертс 
    из ставшего классикой фильма Красотка...</description>
    <barcode>3456789012345</barcode>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

title

Title of the film.

Required element.

year

Year of release.

Optional element.

media

Media format.

Optional element.

starring

Actors.

Optional element.

director

Director.

Optional element.

originalName

Original title.

Optional element.

country

Country.

Optional element.

description

Description of the product offer.

Optional element.

adult

This element is mandatory for designating products that are related to satisfying sexual needs or that pertain to sexual interest in any way.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18.

Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

barcode

The product's barcode as specified by the manufacturer.

Optional element. The <offer> element may contain multiple <barcode> elements.

Tours (tour)

Example:
<offer id="12341" type="tour" available="true" bid="71">
    <url>http://best.seller.ru/product_page.asp?pid=12344</url>
    <price>958</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <picture>http://best.seller.ru/img/device12345.jpg</picture>
    <store>false</store>
    <pickup>true</pickup>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <worldRegion>Африка</worldRegion>
    <country>Египет</country>
    <region>Хургада</region>
    <days>7</days>
    <dataTour>2012-01-01 12:00:00</dataTour>
    <dataTour>2012-01-08 12:00:00</dataTour>
    <name>Hilton</name>
    <hotel_stars>5*****</hotel_stars>
    <room>SNG</room>
    <meal>ALL</meal>
    <included>авиаперелет, трансфер, проживание, питание, страховка</included>
    <transport>Авиа</transport>
    <description>Отдых в Египте.</description>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

worldRegion

Part of the world.

Optional element.

country

Country.

Optional element.

region

Resort or city.

Optional element.

days

Number of days in the tour.

Required element.

dataTour

Arrival days. Preferred format: YYYY-MM-DD hh:mm:ss. Recommended formats.

Optional element. The <offer> element may contain multiple <dataTour> elements.

name

Name of the hotel (in some cases, name of the tour).

Required element.

hotel_stars

The hotel's number of stars.

Optional element.

room

Type of room (SNG, DBL, ...).

Optional element.

meal

Type of meals (All, HB, ...).

Optional element.

included

What is included in the tour price.

Required element.

transport

Transportation.

Required element.

description

Tour description.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18.

Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

Tickets to an event (event-ticket)

Example:
<offer id="1234" type="event-ticket"  available="true" bid="13"> 
    <url>http://best.seller.ru/product_page.asp?pid=57384</url>
    <price>1000</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId> 
    <picture>http://best.seller.ru/product_page.asp?pid=72945.jpg</picture>
    <store>false</store>
    <pickup>false</pickup>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Дмитрий Хворостовский и Национальный филармонический
 оркестр России. Дирижер — Владимир Спиваков.</name>
    <place>Московский  международный Дом музыки</place>
    <hall plan="url плана зала">Большой  зал<hall>
    <hall_part>Партер р. 1-5<hall_part>
    <date>2012-02-25 12:03:14</date> 
    <is_premiere>0<is_premiere>
    <is_kids>0</is_kids>
    <description>Концерт Дмитрия Хворостовского и Национального филармонического
    оркестра России</description>
    <age>6</age>
</offer>

Elements in <offer>:

Elements

Description

url

URL of the product page. The maximum length of the URL is 512 characters.

This element is optional for offline stores.

price

The price for purchasing this product. The price of the product offer is rounded off and the display format depends on the user settings.

Required element.

currencyId

ID of the product price's currency (RUR, USD, UAH, KZT). To correctly display the price in a national currency, use the currency ID (such as UAH) with the price value.

Required element.

categoryId

Product category ID assigned by the store (a number up to 18 digits long). A product offer can only belong to a single category.

Required element. The <offer> element can only contain one <categoryId> element.

market_category

The product category it should be placed in on Yandex.Market. The category name must be from the list of product categories on Yandex.Market.

Optional element.

picture

Link to a picture of this product offer. It is unacceptable to set a link to a “placeholder”, such as a page that says “No image available” or the store's logo. The maximum length of the URL is 512 characters.

Optional element.

store

This element indicates that the product can be purchased in a retail store.

Possible values:

1) false — It is not possible to purchase the product in a retail store.

2) true — The product can be purchased in a retail store.

Optional element.

pickup

This element indicates that the product can be reserved and picked up by the customer.

Possible values:

1) false — Pick-up is not possible.

2) true — The product can be picked up by the customer.

Optional element.

delivery

This element indicates that the product can be delivered.

Possible values:

1) false — Delivery is not available for this product.

2) true — Delivery is provided under the conditions specified in the Partner interface on the Параметры размещения (Placement parameters) page.

Optional element.

name

Event name.

Required element.

place

Event venue.

Required element.

hall plan

Link to an image of the seating layout.

Optional element.

date

Date and time of the show. Preferred format: YYYY-MM-DD hh:mm:ss. Recommended formats.

Required element.

is_premiere

Indicates the event is a premiere.

Optional element.

is_kids

Indicates the event is for children.

Optional element.

description

Event description.

Optional element.

age

The product's age category. Years are set using the unit attribute with the value year, and months are set using the unit attribute with the value month.

Acceptable values for the parameter when unit="year": 0, 6, 12, 16, 18.

Acceptable values for the parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12.

Optional element.

Attention! 

Elements that were not described in the examples are reserved and are not processed. Yandex reserves the right to change the way offers are output, and does not guarantee that offers will be displayed in the same way as they appear in the examples.

Rate this article
Thank you for your feedback!