All elements included in offer in a custom type. YML and CSV formats

type

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

In YML it is an attribute for offer.

model

Model and product name.

Required

vendor

Manufacturer.

Required

typePrefix

The product type / category (for example, “мобильный телефон (mobile phone)”, “стиральная машина (washing machine)”, “угловой диван (corner sofa)”).

Optional

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

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.

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.

Optional

purchase_price

Product purchase price. The purchase price is needed to calculate markups and for the configuration of marginality strategies in PriceLabs.

Optional

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.

Required

categoryId

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

Required

category

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.

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.

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

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

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

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

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

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

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.

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.

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>

If the item is not marked down, don't use this item.

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.

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.

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.

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

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.

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

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