Комплект товаров

Вы можете передавать в прайс-листе комплекты товаров, со скидкой или без. Комплект показывается на карточке основного товара.

Примечание. Если несколько магазинов продают комплекты с одинаковым главным товаром, на карточке показывается только один, с самой низкой ценой.

Структура

<promos>
   <promo id="идентификатор акции" type="bundle with discount">
      <start-date>начало акции</start-date>
      <end-date>завершение акции</end-date>
      <description>краткое описание</description>
      <url>акция на сайте магазина</url>
      <bundle-price>цена комплекта (со скидкой)</bundle-price>
      <purchase>
        <product offer-id="идентификатор основного предложения" role="primary"/>
        <product offer-id="идентификатор дполнительного предложения" role="secondary"/>
        <product offer-id="идентификатор второго дополнительного предложения" role="secondary"/>
      </purchase>
   </promo>
</promos>

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

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

Тип акции:

  • bundle — комплект без скидки;
  • bundle 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

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

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

bundle-price
Внимание. Только для комплектов со скидкой (type="bundle with discount").

Цена комплекта (со скидкой). Должна быть меньше суммарной стоимости всех товаров (из элементов price).

Обязательный для акции «Комплект со скидкой»

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

Товары, на которые действует акция, атрибут offer-id — идентификатор предложения.

Обязательный
Атрибут role

Основной или дополнительный товар:

  • primary — основной (на его карточке показывается комплект);
  • secondary — дополнительный.

Максимальное количество дополнительных товаров — две штуки.

Обязательный для основного товара (значение primary)

Требования

Ссылка на акцию

Ссылка на акцию (элемент url внутри promo) ведет:

  • В корзину, где уже лежат все товары из комплекта.
  • На страницу, где пользователь может добавить в корзину все товары из комплекта. На странице не должно быть других товаров или комплект должен выделяться среди них.

Если на странице акции непонятно, как добавить комплект в корзину, магазин получит ошибку. За многочисленные ошибки служба качества может отключить показ всех акций.

Количество товаров

Максимальное количество товаров в комплекте — три штуки (один основной товар и два дополнительных).

Пример

Комплект из приставки Playstation и геймпада со скидкой, комплект показывается на карточке приставки.

<!--Товары в прайс-листе-->
<offers>
  <offer id="1">
    <name>Игровая приставка Sony PlayStation 4 Pro</name>
    <price>28000</price>
    ...
  </offer>
  <offer id="2">
    <name>Геймпад Sony Dualshock 4</name>
    <price>3500</price>
    ...
  </offer>
</offers>
<!--Информация об акции-->
<promos>
  <promo id="PromoBundle" type="bundle with discount">
    <description>Playstation и геймпад со скидкой</description>
    <url>http://best.seller.ru/promos/bundle</url>
      <bundle-price>30000</bundle-price>
    <!--Товары, которые входят в комплект-->
    <purchase>
      <!--Основной товар — Playstation-->
      <product offer-id="1" role="primary"/>
      <!--Дополнительный товар — геймпад-->
      <product offer-id="2"/>
    </purchase>
  </promo>
</promos>