delivery-options
Use the delivery-options
element in a price list in YML format to indicate the cost and terms of courier delivery for your region. This data will be displayed on Yandex.Market next to each of your store's product offers.
-
When you use the
delivery-options
element, theavailable
attribute does not affect the courier delivery period and the product status. -
If you choose to inform customers about your delivery terms using the
delivery-options
element, please make sure that Use data from the price list option is checked on the page.
How to indicate data in the element
The delivery-options
element is structured as follows:
<delivery-options>
<option cost=" " days=" " order-before=" "/>
</delivery-options>
Indicate the following data in the option
element attributes:
-
cost
attribute — delivery cost -
days
attribute — delivery period in business days -
order-before
attribute (optional) — time by which an order must be placed in order to receive it by the stated delivery period.
The delivery-options
element may consist of up to five option
elements for indicating various delivery types and conditions (for example, regular, express, etc.).
cost
attribute — delivery cost
-
You can only specify whole integers as values for this attribute.
-
You can indicate the cost in the offer currency in
delivery-options
at theoffer
level. At theshop
level — in the price list main currency. -
Indicate the value "0" for free delivery.
-
Option A. Indicate the maximum delivery cost in order to prevent errors.
-
Option B. Indicate the delivery cost for the main city districts in the price list, and for the other districts create separate groups in your personal account and specify your own shipment rates for them. (You can break down you delivery fees by neighborhood and district for major cities.)
days
attribute — delivery period
- Specific delivery period
-
If your store is able to offer same day delivery, then specify the value "0":
days="0"
. If your store can offer next day delivery, then specify the value "1," etc. The maximum value for the delivery period that can be displayed in Yandex.Market is 31 days.You can specify both a specific number of days or a “range” of days. For example, you can specify a delivery period of between 2 to 4 days by writing:
days="2-4"
.Attention. When you specify a “range” for your delivery window, you cannot indicate more than three days. - Undefined delivery period (products that are “made to order”)
-
If the exact delivery period is unknown, use a value of "32" or more for the
days
attribute (or leave the value blank). These products will be assigned the label “Custom” on Yandex.Market.Attention. The store must deliver products that are “made to order” within two months. The exact delivery period must be negotiated with the customer.
The principles governing the calculation and display of the delivery period on Yandex.Market are described in the section How Yandex.Market calculates and displays delivery terms to users.
order-before
attribute — order time
Specify the shipping cut-off time (in your store's time zone) so that customers will know when they must order by to receive the product by the promised delivery date. Use only whole integers between "0" and "24" for the value.
For example, the time 6:00 PM would be indicated as order-before="18"
. If the delivery period is two days, then at times before 6:00 PM users will see that the delivery period is two days, and at times after 6:00 PM they will see the delivery period as three days.
If the attribute is not specified, the default value of "13" is used.
How to use the element in the price list
General delivery terms for all products
The general delivery terms must be indicated in the delivery-option
element in the shop
element (which must come after the categories
element). These terms apply to all offers in your store with the exception of offers with individual delivery terms.
delivery-options
must be specified for the shop
element. If this element is not specified, then you will receive an error when the price list is verified.<shop>
...
<categories> ... </categories>
<delivery-options>
...
</delivery-options>
<offers>
...
</offers>
</shop>
Individual product delivery terms
If your offer includes individual product delivery terms, then they should be indicated in the delivery-options
element in the corresponding offer
element:
<shop>
<delivery-options>
...
</delivery-options>
<offers>
<offer id="1">
<delivery-options>
...
</delivery-options>
</offer>
<offer id="2">
...
</offer>
</offers>
</shop>
In this example the first offer with id="1"
has individual delivery terms, whereas the second offer with id="2"
has general delivery terms that are indicated within the shop
element. Higher priority is always given to the delivery-options
included in an offer
.
How data from thedelivery-options
element is displayed in Yandex.Market
- Delivery period
-
Yandex.Market shows the delivery period in days while taking the business hours of the delivery service and the time that the order was placed (in the
order-before
attribute) into consideration. If the period is not specified (empty value or value greater than 32), the customer will see the message “Custom”.For detailed information, see the section How Yandex.Market calculates and displays delivery terms to users.
- Delivery methods
-
If the store offers several kinds of delivery methods (several
option
elements), then the delivery option with the lowest cost will be considered to be the main one. The user will see the other delivery methods in the additional information section.
Usage examples
Specific delivery period
The store delivers all products on the next day regardless of the time when the order is placed. The delivery cost is 300 rubles.
<shop>
<delivery-options>
<option cost="300" days="1"/>
</delivery-options>
<offers>
...
</offers>
</shop>
Delivery within several days
The store delivers all products within three days, and the delivery cost is 300 rubles.
<shop>
<delivery-options>
<option cost="300" days="1-3"/>
</delivery-options>
<offers>
...
</offers>
</shop>
If the delivery period varies greatly, for example from two to seven days, then the days
attribute should specify the maximum period and an interval of not more than three days (allowed periods: 1–3, 2–4, 3–5, 4–6, etc.). Thus, you should specify days="5-7"
for a delivery period of 2‒7 days:
<shop>
<delivery-options>
<option cost="300" days="5-7"/>
</delivery-options>
<offers>
...
</offers>
</shop>
Individual product delivery terms
The store delivers all products within a day, and the delivery cost is 300 rubles. However, there is an active promotion for a certain product: next day delivery costs 150 rubles.
<shop>
<delivery-options>
<option cost="300" days="2"/>
</delivery-options>
<offers>
<offer>
<delivery-options>
<option cost="150" days="1"/>
</delivery-options>
</offer>
</offers>
</shop>
The customer will see the following for the offer promotion on Yandex.Market: “150 rubles, tomorrow”. For the other offers: “300 rubles, 2 days”.
The delivery period depends on the time when the order is placed
The store delivers all products on the next day if the order is placed before 2:00 PM on the current day. If the order is placed after 2:00 PM, then products will be delivered on the day after tomorrow.
<shop>
<delivery-options>
<option cost="300" days="1" order-before="14"/>
</delivery-options>
<offers>
...
</offers>
</shop>
The information will be displayed as follows in Yandex.Market:
-
before 2:00 PM — “300 rubles, tomorrow”
-
after 2:00 PM — “300 rubles, 2 days”
Several delivery methods
The usual delivery period is four days if the customer places an order before 6:00 PM, meaning that the delivery cost is 300 rubles. The store offers express same day delivery for 500 rubles if the order is placed before 3:00 PM.
<shop>
<delivery-options>
<option cost="300" days="4" order-before="18"/>
<option cost="500" days="0" order-before="15"/>
</delivery-options>
<offers>
...
</offers>
</shop>
For this example, the information will be displayed as follows in Yandex.Market:
-
before 3:00 PM — “ 300 rubles, 4 days”, and in the additional information section — “500 rubles, today”
-
between 3:00 PM and 6:00 PM — “300 rubles, 4 days”, and in the additional information section — “500 rubles, tomorrow”
-
after 6:00 PM — “300 rubles, 5 days”, and in the additional information section — “500 rubles, tomorrow”
Undefined delivery period (“custom”)
The store delivers all products with the exception of sofas on the next day for 300 rubles. The delivery fee for sofas is 500 rubles, though for this item no delivery period is specified since this product is made to order.
<shop>
<delivery-options>
<option cost="300" days="1"/>
</delivery-options>
<offers>
<offer>
<delivery>true</delivery>
<delivery-options>
<option cost="500" days=""/>
</delivery-options>
</offer>
</offers>
</shop>
The following will be displayed for all offers with the exception of sofas on Yandex.Market: “300 rubles, tomorrow”. And the following is displayed for sofas: “500 rubles, custom”.
This product is not delivered by courier
The store delivers all products on the next day with the exception of bulky items, which the customer must pick up.
<shop>
<delivery-options>
<option cost="300" days="1"/>
</delivery-options>
<offers>
<offer id="1">
<delivery>false</delivery>
<pickup>true</pickup>
</offer>
</offers>
</shop>
The following will be displayed for all offers (not including exceptions) on Yandex.Market: “300 rubles, tomorrow”. For a product without courier service (id="1")
: “Customer pickup”.
For more detailed information about the delivery
and pickup
elements, see the delivery, pickup, store section.