При покупке 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

Дата и время начала акции. Допустимые форматы: YYYY-MM-DD hh:mm:ss или YYYY-MM-DD.

Дата и время одинаковы для всех часовых поясов.

Необязательный
end-date

Дата и время завершения акции. Допустимые форматы: YYYY-MM-DD hh:mm:ss или YYYY-MM-DD.

Дата и время одинаковы для всех часовых поясов (см. пример выше).

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

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

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

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

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

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

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

required-quantity

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

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

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

Количество товаров, которые покупатель получит в подарок.

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

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

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

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

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

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

Пример

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

<promo id="Promo2Plus1" type="n plus m">
  <start-date>2018-02-01 12:00:00</start-date>
  <end-date>2018-03-01 12: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>