Promo code discount

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

Requirements

The promo code discount must be at least 5% of the product price (as a percentage or in a currency) or RUB 500.

For example, for a product that costs RUB 1000, the minimum promo code is RUB 50 or a 5% discount. For a product that costs RUB 15,000, the minimum promo code is RUB 500.

Note. Yandex.Market confirms that the product was sold at the old price (or higher) for at least 5 consecutive days in the last 30 days before the promotion.

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

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 percentage or in a currency" currency="currency">discount amount</discount>
      <purchase>
        <product offer-id="offer ID participating in the promo"/>
        ...
        <product category-id="category ID participating in the promo"/>
        ...
      </purchase>
   </promo>
</promos>

Attributes and elements


Element/attribute	Description	Required
Attribute `id`	ID of the promotion. May not be identical to the IDs of loyalty programs or other promotions. It may contain only numbers and Latin letters. The maximum length of `id` is 20 characters. Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.	Required
Attribute `type`	Type of promo — `promo code`.	Required
`start-date` `end-date`	Date and time when the promo starts. Date and time the promo ends. Permissible formats: `YYYY-MM-DD` — Date: year, month, day (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm` / `YYYY-MM-DDThh:mm` — Date and time (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — Date and time with seconds (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mmZ` / `YYYY-MM-DDThh:mmZ` — Date and time (`Z` — time zone, for example, +0300). `YYYY-MM-DD` `hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — Date and time with seconds (`Z` — time zone, for example, +0300). Examples `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`	Optional
`description`	Brief description of the promo. 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. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard.	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 50.	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


Element/attribute	Description	Required
Attribute `id`	ID of the promotion. May not be identical to the IDs of loyalty programs or other promotions. It may contain only numbers and Latin letters. The maximum length of `id` is 20 characters. Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.	Required
Attribute `type`	Type of promo — `promo code`.	Required
`start-date` `end-date`	Date and time when the promo starts. Date and time the promo ends. Permissible formats: `YYYY-MM-DD` — Date: year, month, day (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm` / `YYYY-MM-DDThh:mm` — Date and time (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mm:ss` / `YYYY-MM-DDThh:mm:ss` — Date and time with seconds (time zone of the region where the store is located). `YYYY-MM-DD` `hh:mmZ` / `YYYY-MM-DDThh:mmZ` — Date and time (`Z` — time zone, for example, +0300). `YYYY-MM-DD` `hh:mm:ssZ` / `YYYY-MM-DDThh:mm:ssZ` — Date and time with seconds (`Z` — time zone, for example, +0300). Examples `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`	Optional
`description`	Brief description of the promo. 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. Link may not exceed 2048 symbols. Cyrillic links are permitted. The URL address must conform to the RFC 3986 standard.	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 50.	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

Changing offers and price history

Yandex.Market considers an offer to be new and resets the price history if you changed:

id The offer.
The name of the offer.

Note. The offer may again qualify for a discount in 5 days if all the requirements are met.

Changes in the title that don't affect the meaning are ignored. The history won't be reset if you:

Add or remove spaces. For example, there is no difference between:
iPhone8 64Gb и iPhone 8 64 Gb
Change the case. For example, there is no difference between:
Apple iPhone 8 64 Gb и apple iphone 8 64 gb.
Add or remove punctuation marks (a period, comma, semicolon, colon, hyphen, quotation marks, or parentheses). For example, there is no difference between:
iPhone 8, 64 Gb, "Gold" и iPhone 8 64 Gb Gold.

Examples

Discount of 10% of the item price:

<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>

Discount of 300 rubles:

<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>