id, type, and available elements
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.
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:
Simplified description type: the
type
element is not specified.Custom description type:
type
is set tovendor.model
.
Custom description types should be used for the following product categories:
Лекарства (Medications):
type
is set tomedicine
.Книги (Books):
type
is set tobooks
.Аудиокниги (Audiobooks):
type
is set toaudiobooks
.Музыкальная и видеопродукция (Music and videos):
type
is set toartist.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.
- 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 valuefalse
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.
- 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 valuefalse
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.
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.
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.