Подарок на выбор

Указывайте в прайс-листе, какие товары участвуют в акции и какие подарки может получить покупатель.

  1. Требования
  2.  Структура
  3. Описание атрибутов и элементов
  4. Пример

Требования

Общие требования к подаркам

Подарком может быть:

  • другой товар, который размещается на Маркете;
  • товар, который не размещается на Маркете;
  • сертификат на услугу, например, на шиномонтаж (проверьте, что сертификат удовлетворяет требованиям).

Подарком не может быть:

  • услуга, которая оказывается только сразу после покупки (например, шиномонтаж);
  • скидка или кэшбэк на следующие покупки.
Дополнительные требования к сертификатам
  • Подарок по сертификату можно получить без дополнительных условий.

    Правильно:

    Сертификат на бесплатный массаж в салоне "Индийский слон"

    Неправильно:

    Сертификат на бесплатный массаж в салоне "Индийский слон" при подписке на нашу рассылку
    Сертификат на бесплатный массаж в салоне "Индийский слон" при предъявлении чека

    Исключение: если покупатель заказал товар из категории «Шины и диски», вы можете попросить его предъявить чек. Не забудьте написать об этом на сайте или сообщить покупателю при подтверждении заказа.

  • Сертификат можно передавать другому человеку.

    Правильно:

    Сертификат на стрижку в парикмахерской "Руки-ножницы"
    Неправильно:
    Сертификат на стрижку в парикмахерской "Руки-ножницы" (только при предъявлении паспорта)
  • Сертификат должен быть на конкретную услугу или товар. Подарком не может быть сертификат на какую-то сумму.

    Правильно:

    Сертификат на 3 часа в антикафе "Сова и кот"

    Неправильно:

    Сертификат на 1000 рублей в антикафе "Сова и кот"
  • Сертификат можно использовать в городе покупателя.

    Правильно: вы доставляете товар в Москву, Санкт-Петербург, Тверь и Нижний Новгород, сертификат можно использовать во всех городах.

    Неправильно: вы доставляете товар в Москву, Санкт-Петербург, Тверь и Нижний Новгород, а сертификат можно использовать только в Москве.

 Структура

<offers>
  предложения, которые размещаются на Маркете
</offers>
<gifts>
  подарки, которые не размещаются на Маркете
</gifts>
<promos>
   <promo id="идентификатор акции" type="gift with purchase">
      <start-date>начало акции</start-date>
      <end-date>завершение акции</end-date>
      <description>краткое описание</description>
      <url>акция на сайте магазина</url>
      <purchase>
        <required-quantity>количество товаров за полную стоимость</required-quantity>
        <product offer-id="идентификатор предложения, участвующего в акции"/>
        ...
        <product category-id="идентификатор категории, участвующей в акции"/>
        ...
      </purchase>
      <promo-gifts>
        подарки, участвующие в акции
      </promo-gifts>
   </promo>
</promos>

Описание атрибутов и элементов

Элемент/атрибутОписаниеОбязательность
Элементы, входящие в shops
giftsТовары, которые могут быть подарками, но которые не размещаются на Маркете (их нет в элементе offers).Обязательный
promosОписание акций. Каждая акция описывается в отдельном элементе promo.Обязательный
Элементы, входящие в gifts
gift

Описание одного подарка. Структура элемента:

<gifts>
  <gift id="id товара">
    <name>название товара</name>
    <picture>ссылка на изображение</picture>
  </gift>
  ...
</gifts>
Обязательный
Элементы, входящие в promo
Атрибут idИдентификатор акции. Должен быть уникальным для всего прайс-листа. Может содержать только цифры и латинские буквы. Максимальная длина id — 20 символов.
Внимание. Одно предложение может участвовать только в одной акции.
Обязательный
Атрибут type

Тип акции — gift with purchase.

Обязательный

start-date

end-date

Дата и время начала акции.

Дата и время завершения акции.

Допустимые форматы:
  • YYYY-MM-DD — дата: год, месяц, день (часовой пояс региона, в котором находится магазин);
  • YYYY-MM-DD hh:mm / YYYY-MM-DDThh:mm — дата и время (часовой пояс региона, в котором находится магазин);
  • YYYY-MM-DD hh:mm:ss / YYYY-MM-DDThh:mm:ss — дата и время c секундами (часовой пояс региона, в котором находится магазин);
  • YYYY-MM-DD hh:mmZ / YYYY-MM-DDThh:mmZ — дата и время (Z — часовой пояс, например, +0300);
  • YYYY-MM-DD hh:mm:ssZ / YYYY-MM-DDThh:mm:ssZ — дата и время c секундами (Z — часовой пояс, например, +0300).
Примеры
  • 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
Необязательные
description

Краткое описание акции. Максимум 500 символов. Можно использовать xhtml-разметку, но только в виде блока символьных данных CDATA.

Необязательный
url

Ссылка на описание акции на сайте магазина.

Необязательный
purchase

Информация о товарах, участвующих в акции.

Обязательный

promo-gifts

Подарки, участвующие в акции. Максимальное число подарков на выбор — 12.

Обязательный

Элементы, входящие в purchase
required-quantity

Количество товаров, которое нужно приобрести, чтобы получить подарок. По умолчанию нужно приобрести один товар.

Необязательный
product

Товары и/или категории, на которые действует акция. Атрибуты:

  • offer-id — идентификатор предложения;
  • category-id — идентификатор категории.

Один элемент product соответствует одному товару / одной категории. В элементе purchase может быть несколько элементов product.

Обязательный
Элементы, входящие в promo-gifts
promo-gift

Возможные атрибуты:

  • offer-id — идентификатор подарка, который есть в offers;
  • gift-id — идентификатор подарка, который есть в gifts.
Обязательный

Пример

<!--Товары, которые размещаются на Маркете-->
<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>
  <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>
<!--Информация об акции-->
<promos>
  <promo id="PromoGift" type="gift with purchase">
    <description>Купи iPhone и получи чехол в подарок.</description>
    <url>http://best.seller.ru/promos/gift</url>
    <!--Товары, участвующие в акции-->
    <purchase>
      <product offer-id="1"/>
      <product offer-id="2"/>
    </purchase>
    <!--Подарки на выбор-->
    <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>