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>

Download an example of a completely filled out price list

Example for CSV format

Download a sample price list

List and description of elements

Elements specific to custom description Description Required

type

Type of offer description. The value must be vendor.model.

In YML it is an attribute for offer.

Required

model

Model and product name.

Required

vendor

Manufacturer.

Required

typePrefix

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

vendorCode

Product manufacturer's code.

Optional

id

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 offer.

Detailed element description.

Required

cbid

Attention. This element is obsolete. Use the bid element instead.

Optional

bid

Bid amount.

In YML it is an attribute for offer.

Detailed element description.

Optional

url

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

price

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 from="true" attribute.

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: <price from="true">2000</price>

Required

oldprice

The old price of the product should be higher than the current one. Yandex.Market automatically calculates the difference and shows users the discount.

Detailed element description.

Note. Discount information is updated on Yandex.Market every 40 to 80 minutes.

Optional

purchase_price

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.

Detailed element description.

Optional

currencyId

Product price currency: RUR, USD, EUR, UAH, KZT, BYN. The price and currency must match. For example, with USD the price should be specified in dollars, not rubles.

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

categoryId

Attention. Only used in YML format.

Product category ID assigned by the store (an integer up to 18 digits long).

Required

category

Attention. Only used in CSV format.

Name of the product category.

Required

picture

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.

delivery

Availability of courier delivery (for all regions that the store delivers to).

Possible values:

  • true — Courier delivery is available.

  • false – Courier delivery is not available.

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 true). Detailed element description.

Optional

pickup

Availability of customer pickup at pickup points (in all regions that the store delivers to).

Possible values:

  • true — Customer pickup is available.

  • false — Customer pickup is not available.

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 true). Detailed element description.

Optional

delivery-options

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).

Detailed element description.

You can also set up delivery terms for your local region in your store account.

Optional

pickup-options

Attention. Only used in YML format.

Customer pickup conditions in the store's region (timeframe, cost).

Detailed element description.

You can also set up pickup conditions for your local region in your store account.

Optional

local_delivery_days

Attention. Only used in CSV format.

Period (in days) for the product delivery by courier in the store's local region.

Examples of values
  • Delivery on the day of order (today): set the value to 0.

  • Next-day delivery (tomorrow): set the value to 1.

  • Delivery between 2 and 4 days: set the value to 2-4.

    Attention. When you specify a period as a range “from - to”, the difference between the minimum and maximum values should not be more than three days.

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

local_delivery_cost

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

local-pickup-days

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:

  • On the day the order is placed (today): set the value to 0.

  • On the following day (tomorrow): set the value to 1.

  • After a period of two to four days: set the value to 2–4.

    Attention. When you specify a period as a range “from - to”, the difference between the minimum and maximum values should not be more than three days.

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

local-pickup-cost

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

store

Option to purchase a product without a pre-order.

Possible values:

  • true — the product can be purchased without a pre-order.

  • false — the product cannot be purchased without a pre-order.

Detailed element description.

Optional

description

Offer description. Maximum text length is 3,000 characters (including punctuation marks).

The following are not allowed in the description:
  • Phone numbers, email addresses, postal addresses, ICQ numbers, instant messenger usernames, or any URL links.
  • The words “discount”, “sale”, “cheap”, “gift” (except for gift categories), “gratis”, “promotion”, “special price”, “free”, “new”, “equivalent”, “order”, “hit”.
  • Terms of sale of the product, such as information about promotions or prepayment (to be sent in the sales_notes element in YML or Условия продажи “Terms of sale” in XLS).
  • Region where the product is sold.
  • Information about different product modifications (for example, you can't write “variations available”). Create a separate offer for each modification.

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.

Detailed element description.

Optional

sales_notes

  • This element is required if you have any purchase restrictions (for example, the minimum quantity of products or prepayment is mandatory).
  • You can also specify payment options, promotions, and sales. In this case, the element is optional.

The text may be up to 50 characters in length.

Detailed element description.

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.

Detailed element description.

Optional

manufacturer_warranty

Manufacturer's official warranty.

Possible values:

  • true — The product has an official warranty.

  • false — The product has no official warranty.

Optional

country_of_origin

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

adult

The product is of a sexual nature or pertains to sexual interest in any way. Possible values: true, false.

Optional

barcode

Product manufacturer's barcode in one of the following formats: EAN-13, EAN-8, UPC-A, or UPC-E.

In YML, the offer element may contain multiple barcode elements.

Detailed element description.

Optional

param

All important characteristics of the product: color, size, volume, material, weight, age, gender, etc.

In YML, the offer element may contain multiple param elements (one param element stands for one characteristic).

Detailed element description.

For some categories this is a required element.

See detailed element description.

condition
Attention. Only used in YML format.

Use this element for used goods and products marked down due to defects. In the type attribute, indicate the condition of the product:

  • likenew — Like new (the product was not perviously used and was marked down due to defects).
  • used — Used (the product has been used).

In the reason element be sure to specify the reason for the markdown and describe any defects in detail.

Example:

<condition type="likenew">
   <reason>Damaged packaging</reason>
</condition>
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.

  • If the product has a separate credit program, find its ID in your store account and enter it in the attribute id.
    Example
    <credit-template id="20034"/>
  • If the product has a shared credit program, don't fill in the element — the credit program will be displayed for the product by default.
Optional
credit-template-ids
Attention. Only used in CSV format.

Credit program ID.

  • If the product has a separate credit program, find its ID in your store account and enter it in this element.

  • If the product has a shared credit program, don't fill in the element — the credit program will be displayed for the product by default.
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:

  • likenew — Like new.

  • used — Used.

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

expiry

Product's period of use or expiration date.

The value must be in ISO 8601 format:

  • For the product's period of use: P1Y2M10DT2H30M. This represents 1 year, 2 months, 10 days, 2 hours and 30 minutes.

  • For the expiration date: YYYY-MM-DDThh:mm.

Optional

weight

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

dimensions

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

downloadable

The product can be downloaded. If true is specified, the offer is displayed in all regions.

Optional

available

Using the available element with the value false, you can set a label reading up to 60 days instead of setting a specific delivery period (or a “pre-order” label can be set if the Yandex.Market database contains a date when the product will officially start being sold)

If you want to use available, be sure to familiarize yourself with the detailed element description.

In YML it is an attribute for offer.

Optional

age

Product's age category.

In CSV format:
You can only specify years. Acceptable values include: 0, 6, 12, 16, and 18.
In YML format:
  • Years are specified 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 specified 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

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 offer element.

Optional