Прайс-лист онлайн-магазина

Используйте прайс-лист для Маркета в формате YML с небольшими доработками, описанными ниже.

Описание одного товара, offer

  • Подходит упрощенный и произвольный тип описания.

  • Можно добавить дополнительный элемент private-label.

  • Штрихкод, необязательный для Маркета, является обязательным для Суперчека.

Элемент Описание Обязательность

private-label

Товар собственной торговой марки. Возможные значения: true, false. Значение по умолчанию: false. Необязательно

barcode

Штрихкод товара от производителя в одном из форматов: EAN-13, EAN-8, UPC-A, UPC-E. Элемент offer может содержать несколько элементов barcode.

Если у товара нет штрихкода производителя, укажите ваш внутренний штрихкод или артикул.

Внимание. Внутренний штрихкод или артикул не должен изменяться, иначе предложение перестанет публиковаться в приложении.

Обязательно

Промоакции

В Суперчеке работают все промоакции Маркета, а также собственная промоакция «Несколько товаров дешевле».

Пример промоакции «Несколько товаров дешевле»

<promo id="low-price" type="n prices">
  <start-date>2018-12-04T19:21:12+0000</start-date>
  <end-date>2018-12-05T19:21:12+0000</end-date>
  <description>Чем больше товаров покупаешь, тем ниже цена!</description>
  <url>https://www.example-shop.ru/low-price.html</url>
  <purchase>
    <product offer-id="1230002">
      <prices>
        <price quantity="2">77.1</price> <!--При покупке 2 товаров цена за каждый 77.1-->
        <price quantity="3">65.3</price> <!--При покупке 3 товаров цена за каждый 65.3-->
        <price quantity="4">50.2</price> <!--При покупке 4 товаров цена за каждый 50.2-->
      </prices>
    </product>
  </purchase>
</promo>

Описание элементов в promo

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

Тип акции — n prices.

Обязательно

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

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

Обязательно

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

Информация о товаре, на который действует акция. Один элемент product соответствует одному товару. В элементе purchase может быть несколько элементов product.

Внимание. В акции не могут участвовать категории (только отдельные товары).
Обязательно
Элементы, входящие в product
Атрибут offer-id Идентификатор товара. Обязательно
prices Информация о ценах. Обязательно
Элементы, входящие в prices
price

Цена за каждый товар при покупке того количества, которое указано в атрибуте quantity.

Обязательно

Пример YML

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2019-02-05 17:22">
    <shop>
    <name>Отборные продукты</name>
    <company>ООО Отборные продукты</company>
    <url>http://example-shop.ru</url>
    <currencies>
      <currency id="RUR" rate="1"/>
    </currencies>    
    <categories>
      <category id="20959">Личная гигиена</category>
      <category id="24048" parentId="20959">Дезодоранты</category>
      <category id="20960">Молочные продукты</category>
      <category id="24049" parentId="20959">Молоко</category>
      <category id="20961">Свежие фрукты и овощи</category>
      <category id="20962">Алкогольные напитки</category>
      <category id="24050" parentId="20962">Пиво</category>
      <category id="20963">Безалкогольные напитки</category>
    </categories>
    <offers>
      <!--Дезодорант-->
      <offer id="50736">
        <name>Антиперспирант женский Цветочный бриз Каждый День, 50мл</name>
        <url>http://example-shop.ru/product_page.asp?pid=12348</url>
        <price>100</price>
        <oldprice>120.0</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>24048</categoryId>
        <vendor>Каждый День</vendor>
        <picture>http://example-shop.ru/img/large_12348.jpg</picture>
        <description>50 мл</description>
        <barcode>4690363024544</barcode>
        <param name="volume" unit="мл">50</param>
        <country_of_origin>Россия</country_of_origin>
        <private-label>true</private-label>
      </offer>
 
      <!--Молоко-->
      <offer id="50737">
        <name>Молоко Простоквашино отборное 3,4-4,5% 0,93 л</name>
        <vendor>Простоквашино</vendor>
        <url>http://example-shop.ru/product_page.asp?pid=12345</url>
        <price>99.95</price>
        <currencyId>RUR</currencyId>
        <categoryId>24049</categoryId>
        <picture>http://example-shop.ru/img/model_12345.jpg</picture>
        <description>4,5% 0,93 л</description>
        <param name="volume" unit="л">0,93</param>
        <country_of_origin>Россия</country_of_origin>
        <barcode>4607053473537</barcode>
      </offer>

      <!--Фрукты, овощи по весу-->
      <offer id="50738">
        <name>Яблоки голден, Россия, 1кг</name>
        <url>http://example-shop.ru/product_page.asp?pid=12995</url>
        <price>125.6</price>
        <country_of_origin>Россия</country_of_origin>
        <currencyId>RUR</currencyId>
        <categoryId>20961</categoryId>
        <picture>http://example-shop.ru/img/model_12995.jpg</picture>
        <param name="weight" unit="кг">1</param>
      </offer>

      <!--Фрукты, овощи поштучно-->
      <offer id="50738">
        <name>Лимоны Турция, 3шт</name>
        <url>http://example-shop.ru/product_page.asp?pid=12225</url>
        <country_of_origin>Турция</country_of_origin>
        <price>25.00</price>
        <currencyId>RUR</currencyId>
        <categoryId>20961</categoryId>
        <picture>http://example-shop.ru/img/model_12225.jpg</picture>
        <description>3шт</description>
        <param name="штук в упаковке" unit="шт">3</param>
        <barcode>2000036912123</barcode>
      </offer>

      <!--Фрукты, овощи в фасовке-->
      <offer id="50739">
        <name>Шпинат фасованный, Россия, 150г</name>
        <url>http://example-shop.ru/product_page.asp?pid=12115</url>
        <country_of_origin>Россия</country_of_origin>
        <price>23.50</price>
        <currencyId>RUR</currencyId>
        <categoryId>20961</categoryId>
        <picture>http://example-shop.ru/img/model_12115.jpg</picture>
        <param name="weight" unit="г">150</param>
      </offer>

      <!-- Алкоголь -->
      <offer id="50740" type="alco">
        <name>Пиво Мишенька под Вишенкой, Волковская пивоварня, 0.5л, 6.2%</name>
        <vendor>Волковская пивоварня</vendor>
        <url>http://example-shop.ru/product_page.asp?pid=12005</url>
        <country_of_origin>Россия</country_of_origin>
        <price>45.50</price>
        <oldprice>51.0</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>24048</categoryId>
        <picture>http://example-shop.ru/img/model_12005.jpg</picture>
        <description>0,5 л, 6.2%</description>
        <param name="volume" unit="л">0,5</param>
        <barcode>2000036912551</barcode>
      </offer>

      <!-- Упаковка 24 бутылки газировки -->
      <offer id="50741">
        <name>Газированный напиток COCA-COLA Zero, 0,5 л, 24 штуки</name>
        <vendor>COCA-COLA</vendor>
        <url>http://example-shop.ru/product_page.asp?pid=10245</url>
        <price>789.60</price>
        <currencyId>RUR</currencyId>
        <categoryId>20963</categoryId>
        <picture>http://example-shop.ru/img/model_10245.jpg</picture>
        <param name="volume" unit="л">0,5</param>
        <param name="quantity" unit="шт">24</param>
        <barcode>2000053473537</barcode>
      </offer>
    </offers>

    <!-- Акции -->
    <promos>
      <promo id="1" type="flash discount">
        <start-date>2018-12-01T19:21:12+0000</start-date>
        <end-date>2018-12-05T19:21:12+0000</end-date>
        <description>5 дней скидка на дезодоранты Юнилевер</description>
        <purchase>
          <product offer-id="50736">
            <discount-price currency="RUR">80</discount-price>
          </product>
          <product offer-id="50736">
            <discount-price currency="RUR">80</discount-price>
          </product>
        </purchase>
      </promo>
      <promo id="2" type="n plus m">
        <start-date>2018-12-04T19:21:12+0000</start-date>
        <end-date>2018-12-05T19:21:12+0000</end-date>
        <description>Купи 4 бутылки сока и получи пятую в подарок</description>
        <purchase>
          <required-quantity>4</required-quantity>
          <free-quantity>1</free-quantity>
          <product offer-id="50740"/>
        </purchase>
      </promo>
    </promos>
  </shop>
</yml_catalog>