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.

Attention.

  • When you use the delivery-options element, the available 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 Connections and setup → Shipping options page.

  1. How to indicate data in the element
  2. How to use the element in the price list
  3. How data from thedelivery-options element is displayed in Yandex.Market
  4. Usage examples

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 the offer level. At the shop level — in the price list main currency.

    Note. The delivery-options element can be used in the price list twice (see the section below).

  • Indicate the value "0" for free delivery.

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

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

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

  1. Specific delivery period
  2. Delivery within several days
  3. Individual product delivery terms
  4. The delivery period depends on the time when the order is placed
  5. Several delivery methods
  6. Undefined delivery period (custom)
  7. This product is not delivered by courier

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.

Note. Information about customer pickup is displayed only if the store has configured customer pickup. If a customer pickup option is not configured and there is no courier delivery option, the offer will not be shown on Yandex.Market, since it is not clear how the buyer will be able to receive the product.