Feed requirements

Product sales

General requirements for product feeds:

Each product must have a unique ID.
The IDs of the same product must be the same in different feeds, even when the feeds have different types. For example, the same product should have the same ID in your Yandex Market and Google Shopping feeds both.

Retail sales, other business: Yandex Market feed

You can use the Yandex Market feed in YML (Yandex Market Language) format for “Retail” and “Other” type businesses. To learn more about YML, see Yandex Market Help.

Any XML document may contain only one root element. The YML format uses the <yml_catalog> element as the root element. The date attribute of the <yml_catalog> element should correspond to the date and time the YML file was generated on the advertiser's side. The date must be in YYYY-MM-DD hh:mm format.

The list of the advertiser's product offerings is contained in the <offers> element. Each product offering is described in a separate <offer> element. Add the <currencies> and <categories> elements in the <shop> element before the list of product offers. To learn more about elements comprising <shop>, see Yandex Market Help.

This is the basic, simpler type of description.

Example:

<offer id="0123456" available="true">
  <url>http://www.reliableappliances.biz/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc&</url>
  <price>1620.00</price>
  <oldprice>1800.00</oldprice>
  <currencyId>RUB</currencyId>
  <categoryId>19</categoryId>
  <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture>
<picture>http://89.123.45.678/catalog/photo/19/7.JPG</picture>
  <store>false</store>
  <pickup>true</pickup>
  <delivery>false</delivery>
  <name>ESET NOD32 Platinum Edition Antivirus</name>
  <vendor>Eset</vendor>
  <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
  <description>ESET NOD32 Platinum Edition Antivirus-2-year license NOD32-ENA-NS (BOX) - 2-1</description>
  <sales_notes>Payment: cash, wire transfer, bank card, credit</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Russia</country_of_origin>
  <age unit="year">18</age>
</offer>

Attributes of the <offer> element


Attribute	Description
`id`	Product ID. Mandatory attribute. The IDs of each product must be unique and not overlap in different feeds.
`available`	Availability of product: `true` — Product is in stock. `false` — Product is not in stock.


Attribute	Description
`id`	Product ID. Mandatory attribute. The IDs of each product must be unique and not overlap in different feeds.
`available`	Availability of product: `true` — Product is in stock. `false` — Product is not in stock.

Child elements of the <offer> element


Element	Description
`name`	Product offering name It's recommended you indicate the vendor or manufacturer name and code in the name of a simplified offer. Required element.
`url`	URL of the product page. Required element.
`picture`	Image link. Required element (for smart banners). Add multiple images from the card of one product. For example, images of the product shown from different angles or in different interiors. YAN allows you to display up to five images in some formats. For more information about the selection and processing of images in smart banners, see Questions and answers.
`price`	The price at which this product is being offered. Recommended element for dynamic ads and smart banners.
`currencyId`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`model`	Model.
`vendor`	Vendor or manufacturer.
`vendorCode`	Product code (enter the vendor code).
`description`	Product offering description.
`categoryId`	Product category ID assigned by the advertiser (an integer of no more than 18 characters). The product offering can belong to only one category. Required element. The `<offer>` element can only contain one `<categoryId>` element.
`market_category`	Product category to be used on Yandex Market.
`store`	Product available in retail stores: `true` — Available. `false` — Not available.
`pickup`	Customer pickup from delivery point: `true` — Available. `false` — Not available.
`delivery`	Delivery by courier: `true` — Available. `false` — Not available.
`oldprice`	The old product price, which must be higher than the new price (`price`).
`sales_notes`	Order information: minimum order price, minimum product consignment, required prepayment. payment options, descriptions of promotions and sales.
`manufacturer_warranty`	Official warranty: `true` — Available. `false` — Not available.
`country_of_origin`	Country of origin.