Скидка по промокоду

Укажите в прайс-листе текст промокода и размер скидки.

Примечание. Маркет проверяет, что товар продавался до акции по старой цене (или дороже) как минимум 5 дней подряд:
  • за последние 60 дней — для категории «Одежда, обувь и аксессуары»;
  • за последние 30 дней — для остальных категорий;
  • за все время — если товар размещается меньше 30 (60) дней.

Если это не выполняется, предложение показывается без акции.

  1. Структура
  2. Описание атрибутов и элементов
  3. Изменение предложений и история цен
  4. Примеры

Структура

<promos>
   <promo id="идентификатор акции" type="promo code">
      <start-date>начало акции</start-date>
      <end-date>завершение акции</end-date>
      <description>краткое описание</description>
      <url>акция на сайте магазина</url>
      <promo-code>промокод</promo-code>
      <discount unit="скидка в процентах или валюте" currency="валюта">размер скидки</discount>
      <purchase>
        <product offer-id="идентификатор предложения, участвующего в акции"/>
        ...
        <product category-id="идентификатор категории, участвующей в акции"/>
        ...
      </purchase>
   </promo>
</promos>

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

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

Тип акции — promo code.

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

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

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

Необязательный
promo-code

Текст промокода. Максимальная длина — 20 символов.

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

Размер скидки в процентах от стоимости или в валюте. Тип скидки указывается в атрибутах:

  • unit="percent" — скидка в процентах, доступные значения: от 5 до 95 процентов;
  • unit="currency" currency="RUR" — скидка в валюте, доступные значения: кратные 100.
Обязательный
purchase

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

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

product

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

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

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

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

Изменение предложений и история цен

Маркет считает предложение новым и обнуляет историю цен, если вы поменяли:

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

Не учитываются изменения в заголовке, которые не влияют на смысл. История не обнулится, если вы:

  • Добавите или удалите пробелы. Например, нет разницы между:

    iPhone8 64Gb и iPhone 8 64 Gb
  • Измените регистр. Например, нет разницы между:

    Apple iPhone 8 64 Gb и apple iphone 8 64 gb.
  • Добавите или удалите знаки препинания (точку, запятую, точку с запятой, двоеточие, дефис, кавычки или скобки). Например, нет разницы между:

    iPhone 8, 64 Gb, "Gold" и iPhone 8 64 Gb Gold.

Примеры

Скидка 10% от стоимости товара:

<promo id="Promo10" type="promo code">
  <start-date>2018-02-01 09:00:00</start-date>
  <end-date>2018-03-01 22:00:00</end-date>
  <description>Скидка 10% по уникальному промокоду!</description>
  <url>http://best.seller.ru/promos/10</url>
  <promo-code>HAPPYNEWBENEFIT</promo-code>
  <discount unit="percent">10</discount>
  <purchase>
    <product offer-id="55"/>
    <product offer-id="66"/>
    <product category-id="1"/>
    <product category-id="2"/>
  </purchase>
</promo>

Скидка 300 рублей:

<promo id="Promo300" type="promo code">
  <start-date>2018-02-01 09:00:00</start-date>
  <end-date>2018-03-01 22:00:00</end-date>
  <description>Скидка 300 рублей по уникальному промокоду!</description>
  <url>http://best.seller.ru/promos/300</url>
  <promo-code>HAPPYNEWBENEFIT</promo-code>
  <discount unit="currency" currency="RUR">300</discount>
  <purchase>
    <product offer-id="77"/>
    <product offer-id="88"/>
  </purchase>
</promo>