Promo code discount

Specify the promo code text and the discount amount in the price list.

Note. Yandex.Market verifies that the item was sold at the old price or higher before the promotion:
  • For 60 days in the “Clothing, shoes and accessories” category.
  • For 30 days in all other categories.

If this is not the case, the offer is displayed without the promotion.

  1. Structure
  2. Attributes and elements
  3. Examples

Structure

<promos>
   <promo id="promo ID" type="promo code">
      <start-date>promo start date</start-date>
      <end-date>promo end date</end-date>
      <description>summary</description>
      <url>promo on the store's site</url>
      <promo-code>promo code</promo-code>
      <discount unit="discount as a percent or currency amount" currency="currency">discount amount</discount>
      <purchase>
        <product offer-id="offer ID participating in promo"/>
        ...
        <product category-id="category ID participating in promo"/>
        ...
      </purchase>
   </promo>
</promos>

Attributes and elements

Element/attributeDescriptionRequired
Attribute idID of the promotion. Must be unique for the entire price list. It may contain only numbers and Latin letters. The maximum length of id is 20 characters.
Attention. Each offer can only participate in one promotion.
Required
Attribute type

Type of promo — promo code.

Required
start-date

Date and time when the promo starts. Allowed formats: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD.

The date and time are the same for all time zones.

Example

The store sells products in Moscow and delivers to Yekaterinburg; date and time of the promo: from 10 AM on March 8 to 10 AM on March 9.

For users in Moscow, the promo will run from 10 AM on March 8 to 10 AM on March 9 (Moscow time).

For users from Yekaterinburg, it will be from 10 AM on March 8 to 10 AM on March 9 in the Ural time zone.

Optional
end-date

Date and time the promotion ends. Allowed formats: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD.

The date and time are the same for all time zones (see the example above).

Optional
description

Brief description of the promo in Russian. Maximum of 500 characters. You can use XHTML markup, but only as a CDATA block of character data.

Optional
url

Link to the promotion description on the store's website.

Optional
promo-code

The text of the promo code. Maximum length: 20 characters.

Required
discount

The discount amount as a percentage of the price or in a currency. The discount type is specified in the attributes:

  • unit="percent" — The discount as a percent. Acceptable values: 5–95 percent.
  • unit="currency" currency="RUR" — The discount in the currency. Acceptable values: multiples of 100.

This element is in purchase.

Required
purchase

Information about items participating in the promotion.

Required

product

Items and/or categories that the promotion applies to. Attributes:

  • offer-id — Offer ID.
  • category-id — Category ID.

Each product element corresponds to a single item or category. A purchase element may contain multiple product elements.

Required

Examples

Discount of 10% of the item price:

<promo id="Promo10" type="promo code">
  <start-date>2018-02-01 00:00:00</start-date>
  <end-date>2018-03-01 00: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>

Discount of 300 rubles:

<promo id="Promo300" type="promo code">
  <start-date>2018-02-01 00:00:00</start-date>
  <end-date>2018-03-01 00: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>