Simplified description of the offer (YML, CSV, and XLS formats)

Simplified and custom types of descriptions are suitable for most types of product offers.

Both types of descriptions are equally useful and provide the same degree of binding to product profiles and postings on Yandex.Market. However, the simplified type is more flexible, since the model and vendor elements are optional for it, whereas for the custom type they are mandatory.

Examples for different formats

Example in YML format

Example of a single offer:

<offer id="12341" available="true" bid="80" cbid="90" fee="325">
  <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>
  <outlets> 
    <outlet id="1" instock="50"/>
    <outlet id="2" instock="20"/>
  </outlets>
  <vendor>Brand</vendor>
  <name>Мороженица Brand 3811</name>>
  <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>
  <cpa>1</cpa>
  <rec>789,120</rec>
</offer>

Download an example of a completely filled out price list

Example for CSV format

Download an example price list

Example for XLS format

Download an example price list

List of elements

Elements that are specific to this type of description are used for generating the title of the product offer on Yandex.Market and affect how it is linked to the product profile. We recommend that you read the section Offer Title: vendor, name, model, typePrefix for detailed information about how product offer titles are created.

Attention. The text values of the elements (typePrefix, market_category, name, model, sales_notes, description, etc.) must be indicated in Russian.
Elements for the simplified description Description Required

name

Name of the product offer.

Required element.

model

Model.

Optional element.

vendor

Manufacturer.

Optional element.

vendorCode

Vendor code of given product

Optional element.

Standard elements Description Required

id

Product ID. It may contain only numbers and Latin letters. Maximum length: 20 characters.

In YML this is an offer attribute.

Detailed element description.

Required element.

cbid

Bid amount for product profile.

This is an offer attribute.

Detailed element description.

Optional element.

bid

Bid amount for positioning the posting in the remaining places (except for the product profile).

This is an offer attribute.

Detailed element description.

Optional element.

fee

Commission fee amount for a product offer participating in the “Yandex.Market Quick Order” program.

This is an offer attribute.

Detailed element description.

Optional element.

url

URL of product page on store's site. Maximum link length: 512 characters. Cyrillic links are permitted.

Required element for internet stores.

price

Price to purchase product. The price of the product is rounded off and displayed in the format set by the user.

If the price list is sent in YML format, then the bottom of the price range (“from”) can be indicated using the from="true" attribute for the following 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: <price from="true">2000</price>

Required element.

oldprice

The old price for the product, which has to be higher than the new price (price). The oldprice parameter is necessary in order to automatically calculate the discount.

Note. Sales and discount information is updated on Yandex.Market every 40 to 80 minutes.

Optional element.

currencyId

Product currency identifier (RUB, USD, UAH, KZT, BYN). To correctly display prices in the national currency, use the ID with the corresponding price value (such as UAH with the price in hryvnias).

Required element.

categoryId

Attention. Only used in YML format.

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.

category

Attention. Only used with XLS, CSV formats.

Name of the product category. A product offer can only belong to a single category.

Required element.

picture

URL link to the product image.

We recommend that you review the link and image requirements.

Required for some of the categories; see the detailed description of the element

delivery

Indicates if the product can be delivered via courier.

Possible values:

  • true — the product can be delivered by courier.

  • false — the product can't be delivered by courier (the customer must pick it up).

Attention. The delivery element must be set to the false value if the product cannot be sold remotely (jewelry, medication, and alcohol).

If the element is not specified, then a value is assigned by default. See detailed element description.

Optional element.

delivery-options

Attention. Only used in YML format.

Terms of courier delivery service for this product in your region (types of delivery, time frame, cost).

If this element is not used, then the delivery terms for your region must be set in your personal account.

Detailed element description.

Optional element.

local_delivery_days

Attention. Only used with XLS, CSV formats.

Time frame (in days) for this product to be delivered by courier in your region.

Delivery on the same day as when the order is placed (today): value 0, delivery on the next day (tomorrow): value 1, etc. You can also specify a “range” of days, such as: 2–4.

Attention. When you enter a period “from — to” the difference between the minimum and maximum delivery period should not exceed three days.

The maximum value that you can use on Yandex.Market is 31 days. The status “Custom” is displayed for a value of 32 or more (or a value that is not specified).

If this element is not used, then the delivery terms for your region must be set in your personal account.

Optional element.

local_delivery_cost

Attention. Only used with XLS, CSV formats.

Cost to deliver this product by courier in your region.

If this element is not used, then the delivery terms for your region must be set in your personal account.

Optional element.

pickup

Option to get order from pickup point.

Possible values:

  • true — can get product from a “pickup point”.

  • false — the product is not available for pickup.

If the element is not specified, then a value is assigned by default. See detailed element description.

Optional element.

available

Product status:

true — “ready for shipment”

The product will be delivered by courier or to the place of customer pickup within the specified time. Yandex.Market will display the delivery times published in your personal account.

false — “Custom”
The exact time of delivery by courier or to the place of customer pickup is unknown. The delivery period will be negotiated with the buyer on an individual basis (the maximum permitted delivery period is two months). These delivery terms are not shown on Yandex.Market. Rather, the message "Custom" is shown.
Attention. This element is used in addition to the data that is configured in your personal account. This element is not used when the delivery terms of the local courier service are configured in the price list (in any format).

In YML this is an offer attribute. If the element is not specified, the default value "true" is used.

Подробное описание элемента.
Optional element.

store

The product can be purchased in a retail location.

Possible values:

  • true means that the product can be purchased in retail stores.

  • false —the product cannot be purchased in retail stores.

If the element is not specified, then a value is assigned by default. See detailed element description.

Optional element.

outlets
Attention. Only used in YML format.

This element includes the following information:

  • quantity of this item available at sales point (distribution point or retail location).

  • whether or not the item can be reserved.

Optional element.

description

Description of the product. Maximum text length is 3,000 characters (including punctuation marks). The description must not include the following:

  • usage, installation or assembly instructions

  • the use of the following words: "discount," "cheap," "gift" (with the exception of product descriptions in gift categories), "free," "sale," "special price," "only," "new," "similar," "compare to," "order," and “hit”

  • phone numbers, email addresses, postal addresses, ICQ numbers, instant messenger usernames, or any URL links

The following xhtml tags may be used in YML format: <h3>...</h3>, <ul><li>...</li></ul>, <p>...</p>, <br/> provided that:

  • they are enclosed in a CDATA section in the format: <![CDATA[Text with xhtml markup]]>

  • the general rules of the XHTML standard are observed.

Detailed element description.

Optional element.

sales_notes

This element includes the following information:

  • minimum order amount, minimum product configuration, and required prepayments (the element is mandatory if these conditions exist).

  • payment types, sale and clearance information (this element is mandatory).

The text may be up to 50 characters in length.

min-quantity

Minimum number of identical products in one 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 element.

step-quantity

The number of products that the buyer can add to the minimum order in their Yandex.Market shopping cart. This element is used in addition to the min-quantity element, and it only applies to the following categories: “Car tires” , “Truck tires”, “Motorcycle tires”, “Wheel rims” .

If the element is not specified, the default value "1" is used.

Optional element.

manufacturer_warranty

This element is used for 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.

Optional element.

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 “Yandex.Market Quick Order” program, then it is recommended that you specify this element.

Optional element.

adult

This element is mandatory for products of a sexual nature or that pertain to sexual interest in any way.

Optional element.

age

Product's age category.

In XLS and CSV formats:
You can only specify years. Acceptable values include: 0, 6, 12, 16, and 18.
YML format:
  • Years are indicated using the attribute unit with the value year. Acceptable values for the age parameter when unit="year": 0, 6, 12, 16, and 18.

  • Months are indicated using the attribute unit with the value month. Acceptable values for the age parameter when unit="month": 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12.

Optional element.

barcode

Product's barcode as specified by the manufacturer. In YML format, the offer element can contain several barcode elements.

Optional element.

cpa

You can use this element to manage the participation of your offers in the “Yandex.Market Quick Order” program. Acceptable values include:

  • 1 — the product can be ordered directly on Yandex.Market.

  • 0 — the product cannot be ordered on Yandex.Market (it is only available on the store site).

If a value is not indicated, then it is assumed by default that the product can be ordered on Yandex.Market.

Attention.

The element must have a value of "0" if:

  • The product cannot be ordered remotely (jewelry and medication).

  • The product price is less than the minimum order amount.

Detailed element description.

Optional element.

param

Attention. Only used in YML format.

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

In YML format, an offer element can contain several param elements.

Detailed element description.

For some categories this is a required element.

See detailed element description.

expiry

This element is used to indicate the product's period of use or expiration date.

The value must be in ISO 8601 format:

— to indicate the duration of the service life: P1Y2M10DT2H30M. This represents 1 year, 2 months, 10 days, 2 hours and 30 minutes.

— to indicate the expiration date/end of service life: 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 accurate to the third decimal place (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 character after the separator is less than 5, then the third character is saved and all subsequent ones are reset.

  • If the fourth character after the separator is greater than or equal to 5, then the third character is incremented to one and all subsequent characters are reset.

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 character after the separator is less than 5, then the third character is saved and all subsequent ones are reset.

  • If the fourth character after the separator is greater than or equal to 5, then the third character is incremented to one and all subsequent characters are reset.

Optional element.

downloadable

This element indicates a product that can be downloaded. If the parameter value is specified as true, then the product offer is shown in all regions regardless of the delivery regions specified by the store on the General settings page.

Optional element.

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 items that are variants of a particular model; the elements should all have the same value. This element value must be an integer with no more than 9 digits.

This is an offer attribute.

Optional element.

rec

Attention. Only used in YML format.

The element is designed to notify users about recommended products.

Detailed element description.

Optional element.