id, type, and available elements

Note. In YML format, the id, type, available elements are attributes of the offer element.

id — offer ID

The id element specifies the offer's identifier. The ID may contain only numbers and Latin letters. The maximum length of id is 20 characters.

Attention.

It is a must to specify the ID. The offer identifier must be:

  • Unique among all the store's offers and price lists.

  • Remain constant for the same offer in all versions of a single price list.

If two or more offers have the same id specified, the identifier will be assigned only to the first of these offers. For the others, a warning message about a missing ID will be displayed during verification.

type — offer type

The type element specifies the offer type.

The following description types are fit for the majority of product categories:

Custom description types should be used for the following product categories:

  • Лекарства (Medications): type is set to medicine.

  • Книги (Books): type is set to books.

  • Аудиокниги (Audiobooks): type is set toaudiobooks.

  • Музыкальная и видеопродукция (Music and videos): type is set to artist.title.

available — Unknown delivery period

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 a user purchases an item from your store and that item doesn't have a set delivery period, within an hour you must confirm their order. The confirmation must specify the product cost and delivery cost, but specifying a delivery date is not required. You may state a time period (no more than 60 days) in which a delivery date must be agreed upon and the order must be delivered.

The element's use depends on how you specify the delivery period for your region.

The delivery period for your region is specified in the price list

In this case you can set the label “up to 60 days” or “pre-order” using the same elements that are used to set the delivery period: delivery-options in YML, local_delivery_days in CSV, and Срок доставки (“Delivery period”) in XLS. The available / Статус товара (“Product status”) element will not operate in your local region.

However, the element will operate in other regions. This may be necessary if you can't deliver a product to another region within the period set in your personal account.

Example

A store is located in Moscow:

  • Its price list shows a delivery period of 5 days (this is the period for the store's local region, Moscow).

  • In the store account, the delivery period to Nizhny Novgorod is set as 10 days.

The store delivers all its products to Nizhny Novgorod within that delivery period, except for the “Bogatyr”-model cabinet. For this cabinet, the store indicates “Special order” (available with the value false in YML and CSV). Yandex.Market will display the information as follows:

  • Delivery in Moscow for all products (including the cabinet): 5 days.
  • Delivery to Nizhny Novgorod, for all products except the cabinet: 10 days.
  • For delivery of the cabinet to Nizhny Novgorod, information stating a delivery period of “up to 60 days” will be displayed.
The delivery period for your local region is entered in your store account

In this case, the available / Статус товара (“Product status”) element will operate simultaneously for all regions. Use it if you can't deliver a specific product within the periods that you indicated in your store account.

Example

A store is located in Moscow: In its store account, the following delivery periods have been set:

  • Five days for its local region (Moscow and Moscow Oblast).

  • Ten days to Nizhny Novgorod.

The store is unable to deliver the “Bogatyr” cabinet in those periods and so, for that product, indicates “Special order” (available with the value false in YML and CSV). Yandex.Market will display:

  • Delivery in Moscow and Moscow Oblast, for all products except the cabinet: 5 days.

  • Delivery to Nizhny Novgorod, for all products except the cabinet: 10 days.
  • For delivery of the cabinet in Moscow and to Nizhny Novgorod, information stating a delivery period of “up to 60 days” will be displayed.