Gift with purchase

Specify in the price list which items participate in the promotion and what gifts the customer can receive.

What can be a gift

Another item that is available on Yandex.Market.
An item that is not available on Yandex.Market.
A certificate for a service (must meet the requirements below).

What cannot be a gift

A service that is provided without a certificate.
A certificate for a service which is provided only immediately after purchase.
A discount or cash back on a future purchase.
An item from a product package that is participating in the promotion (buyers will receive it anyway).

Requirements

For gifts

A gift must be valuable to the buyer and to encourage making a purchase.
Examples of good gifts:
- A stroller cover for the purchase of a stroller (if the cover is not automatically included).
- A cable with the purchase of an electric saw.
- A tent with the purchase of a kayak.
Examples of bad gifts:
- A promotional booklet, coupon booklet, or branded bag (with the purchase of any product).
- A pencil with the purchase of a refrigerator.
- Engine oil with the purchase of a smartphone.
Note. If the gift is not something that will interest buyers, the quality control service will send the store an error message and may disable all the store's promotions until the error is corrected.
The model of the gift must be specified exactly. If you offer a choice of several models, specify each of them as a separate gift option (no more than 12).

Gift certificates

Gift certificates can be obtained without additional conditions.

Correct:
```
Certificate for a free massage at the Indian Elephant salon
```
Incorrect:
```
Certificate for a free massage at the Indian Elephant salon upon subscription to our newsletter
```
```
Certificate for a free massage at the Indian Elephant salon upon presentation of your receipt
```
Exception: if the buyer ordered a product from the category “Шины и диски (Tires and wheels)”, you can request that they show their receipt. Be sure to indicate this on your website or inform the buyer when confirming their order.
The gift certificate is not provided by the manufacturer along with the product itself.

Correct: the manufacturer provides a one-year warranty for the product and you give a certificate for an additional year of warranty.

Incorrect: the manufacturer provides a one-year warranty for the product and you give a certificate for the same year of warranty.
The certificate must be transferrable to another person.

Correct:
```
Gift certificate for a haircut at the Scissorhands barber shop
```
Incorrect:
```
Gift certificate for a haircut at the Scissorhands barber shop (only upon presentation of ID)
```
Exception: a gift certificate for insurance of tires and wheels can be issued for a specific individual.
The gift certificate must be for a specific product or service. The gift certificate must not be for a specific monetary sum.

Correct:
```
Gift certificate for 3 hours at the Owl and Cat anti-café
```
Incorrect:
```
Gift certificate for RUB 1000 at the Owl and Cat anti-café
```
The service offered with the gift certificate must be relevant to the buyer.

Correct: upon the purchase of winter tires during the summer, you provide a non-expiring gift certificate for tire installation.

Incorrect: upon the purchase of winter tires during the summer, you provide a gift certificate for tire installation that must be used within 30 days.
The gift certificate must be redeemable in the buyer's city.

Correct: you deliver products to Moscow, Saint Petersburg, Tver and Nizhny Novgorod, and the gift certificate can be used in all four cities.

Incorrect: you deliver products to Moscow, Saint Petersburg, Tver and Nizhny Novgorod, and the certificate can be used only in Moscow.

Structure

<offers>
  offers available on Yandex.Market
</offers>
<gifts>
  gifts not available on Yandex.Market
</gifts>
<promos>
   <promo id="promo ID" type="gift with purchase">
      <start-date>promo start date</start-date>
      <end-date>promo end date</end-date>
      <description>summary</description>
      <url>promo on store's site</url>
      <purchase>
        <required-quantity>number of goods at full price</required-quantity>
        <product offer-id="offer ID participating in promo"/>
        ...
        <product category-id="category ID participating in promotion"/>
        ...
      </purchase>
      <promo-gifts>
        gifts participating in promo
      </promo-gifts>
   </promo>
</promos>

Attributes and elements


Element/attribute	Description	Required
Elements in `shops`
`gifts`	Items that can be gifts but are not available on Yandex.Market (they are not in the `offers` element). Attention. Specify the element `gifts` before the element `promos`. This is needed to correctly process information regarding promos.	Optional
`promos`	Description of promotions. Each promotion is described in a separate `promo` element.	Required
Elements in `gifts`
`gift`	Description of one gift. Element structure: `<gifts> <gift id="product id"> <name>product name</name> <picture>link to image</picture> </gift> ... </gifts>`	Required
Elements in `promo`
Attribute `id`	ID of the promotion. May not be identical to the IDs of loyalty programs or other promotions. It may contain only numbers and Latin letters. The maximum length of `id` is 20 characters. Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.	Required
Attribute `type`	Type of promo — `gift with purchase`.	Required
`start-date` `end-date`	Date and time when the promo starts. Date and time the promo ends. Permissible formats: `YYYY-MM-DD` — Date: year, month, day (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm` / `YYYY-MM-DDThh:mm` — Date and time (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — Date and time with seconds (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mmZ` / `YYYY-MM-DDThh:mmZ` — Date and time (`Z` — time zone, for example, +0300). `YYYY-MM-DD` `hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — Date and time with seconds (`Z` — time zone, for example, +0300). Examples `2018-09-01` `2018-09-01 09:00` `2018-09-01 09:00:01` `2018-09-01 09:00+0500` `2018-09-01 09:00:01+0500`	Optional
`description`	Brief description of the promo in Russian. Maximum of 500 characters. You can use XHTML markup, but only as a `CDATA` block of character data.	Optional
`url`	Link to the promotion description on the store's website. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard.	Optional
`purchase`	Information about items participating in the promotion.	Required
`promo-gifts`	Gifts participating in the promo. The maximum number of gifts to choose from is 12.	Required
Elements in `purchase`
`required-quantity`	Number of items (in individual units) that must be purchased to receive gift. Only numeric values may be entered. The maximum value is 24. The default value is 1 (one product).	Optional
`product`	Items and/or categories that the promotion applies to. Attributes: `offer-id` — Offer ID. `category-id` — Category ID. Each `product` element corresponds to a single item or category. A `purchase` element may contain multiple `product` elements.	Required
Elements in `promo-gifts`
`promo-gift`	Acceptable attributes: `offer-id` — ID of a gift that is in `offers`. `gift-id` — ID of a gift that is in `gifts`.	Required


Element/attribute	Description	Required
Elements in `shops`
`gifts`	Items that can be gifts but are not available on Yandex.Market (they are not in the `offers` element). Attention. Specify the element `gifts` before the element `promos`. This is needed to correctly process information regarding promos.	Optional
`promos`	Description of promotions. Each promotion is described in a separate `promo` element.	Required
Elements in `gifts`
`gift`	Description of one gift. Element structure: `<gifts> <gift id="product id"> <name>product name</name> <picture>link to image</picture> </gift> ... </gifts>`	Required
Elements in `promo`
Attribute `id`	ID of the promotion. May not be identical to the IDs of loyalty programs or other promotions. It may contain only numbers and Latin letters. The maximum length of `id` is 20 characters. Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.	Required
Attribute `type`	Type of promo — `gift with purchase`.	Required
`start-date` `end-date`	Date and time when the promo starts. Date and time the promo ends. Permissible formats: `YYYY-MM-DD` — Date: year, month, day (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm` / `YYYY-MM-DDThh:mm` — Date and time (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — Date and time with seconds (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mmZ` / `YYYY-MM-DDThh:mmZ` — Date and time (`Z` — time zone, for example, +0300). `YYYY-MM-DD` `hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — Date and time with seconds (`Z` — time zone, for example, +0300). Examples `2018-09-01` `2018-09-01 09:00` `2018-09-01 09:00:01` `2018-09-01 09:00+0500` `2018-09-01 09:00:01+0500`	Optional
`description`	Brief description of the promo in Russian. Maximum of 500 characters. You can use XHTML markup, but only as a `CDATA` block of character data.	Optional
`url`	Link to the promotion description on the store's website. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard.	Optional
`purchase`	Information about items participating in the promotion.	Required
`promo-gifts`	Gifts participating in the promo. The maximum number of gifts to choose from is 12.	Required
Elements in `purchase`
`required-quantity`	Number of items (in individual units) that must be purchased to receive gift. Only numeric values may be entered. The maximum value is 24. The default value is 1 (one product).	Optional
`product`	Items and/or categories that the promotion applies to. Attributes: `offer-id` — Offer ID. `category-id` — Category ID. Each `product` element corresponds to a single item or category. A `purchase` element may contain multiple `product` elements.	Required
Elements in `promo-gifts`
`promo-gift`	Acceptable attributes: `offer-id` — ID of a gift that is in `offers`. `gift-id` — ID of a gift that is in `gifts`.	Required

Example

<!--Items that are available on Yandex.Market-->
<offers>
  <offer id="1">
    <name>iPhone X 64Gb Space Grey</name>
    ...
  </offer>
  <offer id="2">
    <name>iPhone X 256Gb Silver</name>
    ...
  </offer>
  <offer id="3">
    <name>Чехол iPhone X красный</name>
    ...
  </offer>
  <offer id="4">
    <name>Чехол iPhone X синий</name>
    ...
  </offer>
</offers>
<!--Gifts that are not available on Yandex.Market-->
<gifts>
  <gift id="33">
    <name>Чехол iPhone X Хохлома</name>
    <picture>https://best.seller.ru/promos/33.jpg</picture>
  </gift>
  <gift id="44">
    <name>Чехол iPhone X Гжель</name>
    <picture>https://best.seller.ru/promos/33.jpg</picture>
  </gift>
</gifts>
<!--Promo information-->
<promos>
  <promo id="PromoGift" type="gift with purchase">
    <description>Купи iPhone и получи чехол в подарок.</description>
    <url>http://best.seller.ru/promos/gift</url>
    <!--Items participating in promo-->
    <purchase>
      <product offer-id="1"/>
      <product offer-id="2"/>
    </purchase>
    <!--Gifts to choose from-->
    <promo-gifts>
      <promo-gift offer-id="3"/>
      <promo-gift offer-id="4"/>
      <promo-gift gift-id="33"/>
      <promo-gift gift-id="44"/>
    </promo-gifts>
  </promo>
</promos>