delivery-options

The delivery-options element structure:

   <option cost="cost" days="term" order-before="if you order before"/

One option element provides information about one type of courier delivery:

• cost — cost of delivery.

• days — delivery period in business days.

• order-before (optional) — time by which an order must be placed to receive it within the specified 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.). If the store has several types of delivery, each of them in the option element should differ in both time and price. If the store has only one type of delivery, use only one option element.

The cost attribute: cost of delivery.

• You can only specify integers as values for this attribute.

• The delivery-options element can be used in a price list twice (see the section below), therefore in delivery-options at the offer level specify the delivery cost in the offer currency. At the shop level, in the price list main currency.

• For free delivery, set the value to 0.

If the product delivery cost varies depending on the district in the city:

• Option A Specify the maximum delivery cost to avoid errors.

• Option B. Specify 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 set your owndelivery rates for them. (You can break down you delivery fees by neighborhood and district for major cities.)

The days attribute: delivery period.

Specific delivery period

If your store can offer same-day delivery, set the value to 0: days="0". If your store can offer next-day delivery, set the value to 1, and so on. The maximum value for the delivery period that can be displayed on Yandex.Market is 31 days.

You can specify both a specific number of days and a “range” of days. For example, you can specify a delivery period from 2 to 4 days as follows: 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, set the value to 32 or more in the days attribute (or leave it empty). 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.

The 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 integers between 0 and 24 as the value.

For example, the time 6:00 PM is displayed 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 "13" is used.

General delivery terms for all products

The general delivery terms must be specified in the delivery-option element within 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.

<shop>
  ...
  <categories> ... </categories>
  <delivery-options>
    ...
  </delivery-options>
  <offers>
    ...
  </offers>
</shop>

Individual product delivery terms

If your offer has individual product delivery terms, then they should be specified in the delivery-options element as part of 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 specified within the shop element. The delivery-options element that is part of the offer element is always of higher priority.

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, the days attribute should specify the maximum period and an interval of no more than three days (allowed periods: 1–3, 2–4, 3–5, 4–6, etc.). So, for a delivery period of 2-7 days, you should specify days="5-7":

<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: the 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 on 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 on 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 no delivery period is specified, as 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 (excluding 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 section delivery, pickup, store.

One type of delivery in two elements option

Example of an incorrect offer:

<delivery-options>
  <option cost="0" days="1-2" order-before="15"/>
  <option cost="0" days="2-3"/>
</delivery-options>

In this case, before 3:00 PM two types of free delivery will be shown for the store's offers: one for a delivery period of 1-2 days, the other for a delivery period of 2-3 days. After 3:00 PM, two types of delivery with the same terms and conditions will be displayed: free of charge, 2-3 days. In fact, the store offers the same free delivery, the period of which depends on the time of placing an order.

Correct:

<delivery-options>
  <option cost="0" days="1-2" order-before="15"/>
</delivery-options>

You only need to use one option element and set the time in the order-before attribute. After 3:00 PM, Yandex.Market will automatically change the delivery period to 2-3 days.

Different types of delivery do not differ in period or price

Example of an incorrect offer:

<delivery-options>
  <option cost="400" days="0-3"/>
  <option cost="200" days="0-3"/>
</delivery-options>

In this case, two types of delivery will be displayed on Yandex.Market for the store's offers: with different prices but the same delivery period (0-3 days). In fact, the store offers express delivery within a period of 0-1 day (today or tomorrow) and the standard delivery period of 2-3 days.

Correct:

<delivery-options>
  <option cost="400" days="0-1"/>
  <option cost="200" days="2-3"/>
</delivery-options>

Do not specify a period common for all delivery types; you should specify a different period for each delivery type.