При покупке N товаров M таких же товаров бесплатно

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

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

Структура

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

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

Элемент/атрибутОписаниеОбязательность
Атрибут idИдентификатор акции. Должен быть уникальным для всего прайс-листа. Может содержать только цифры и латинские буквы. Максимальная длина id — 20 символов.
Внимание. Одно предложение может участвовать только в одной акции.
Обязательный
Атрибут type

Тип акции — n plus m.

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

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

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

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

required-quantity

Количество товаров, которое нужно приобрести, чтобы получить подарок. Максимально допустимое значение — 24.

Элемент входит в purchase.

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

Количество товаров, которые покупатель получит в подарок. Максимально допустимое значение — 24.

Элемент входит в purchase.

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

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

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

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

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

Пример

При покупке двух упаковок корма третья упаковка бесплатно:

<promo id="Promo2Plus1" type="n plus m">
  <start-date>2018-02-01 09:00:00</start-date>
  <end-date>2018-03-01 22:00:00</end-date>
  <description>Купи 2 упаковки корма и получи третью в подарок!</description>
  <url>http://best.seller.ru/promos/2plus1</url>
  <purchase>
    <required-quantity>2</required-quantity>
    <free-quantity>1</free-quantity>
    <product offer-id="55"/>
    <product offer-id="66"/>
    <product category-id="1"/>
    <product category-id="2"/>
  </purchase>
</promo>