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

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

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

name

Короткое название магазина.

Да

company

Полное наименование компании, владеющей магазином. Не публикуется.

Да

url

Адрес сайта магазина, записанный согласно стандарту RFC 3986.

Да

currencies

Список курсов валют магазина. Поддерживаются только рубли.

Да

categories

Список категорий магазина.

Да
delivery Наличие курьерской доставки. Принимает значения true и false.

Указывает на условия общие для магазина. Условия доставки специфичные для товаров указывайте внутри элемента offer.

Нет
delivery-options Количество дней, требуемых на доставку.

Может содержать до 5 элементов option, каждый из которых описывает один из способов курьерской доставки (например, обычная, ускоренная и так далее).

Указывает на условия общие для магазина. Условия доставки специфичные для товаров указывайте внутри элемента offer.

Подробное описание элемента

Нет

offers

Список предложений магазина. Каждое предложение описывается в отдельном элементе offer. Здесь не приводится список всех элементов, входящих в offer, так как он зависит от типа предложения. Для большинства категорий товаров подходят следующие типы описаний:

Да
promos

Блок данных о промокодах для всех пользователей.

Да, если есть промокоды для всех.
Элементы внутри promos
promo

Данные о промокодах.

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

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

Да

start-date

end-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).
Примеры
  • 2023-03-01
  • 2023-03-01 09:00
  • 2023-03-01 09:00:01
  • 2023-03-01 09:00+0500
  • 2023-03-01 09:00:01+0500
Да
url Ссылка на описание акции на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL-адрес формируется по стандарту RFC 3986. Да
promo-code

Текст промокода. Может содержать только цифры и латинские буквы. Длина промокода: от 3 до 15 символов.

Да
discount

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

  • unit="percent" — скидка в процентах, доступные значения: от 3 до 95%;
  • unit="currency" currency="RUR" — скидка в валюте, доступно значение от 100 RUR.
    Примеры
    Скидка 300 руб.
    <discount unit="currency" currency="RUR">300</discount>
    Скидка 10%
    <discount unit="percent">10</discount>
Да
purchase Информация о товарах, участвующих в акции. Может содержать несколько элементов product, но не больше 1 000 000. Да
Элементы внутри purchase
product

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

Один элемент product соответствует одному товару. Максимальное количество элементов product — 1 000 000.

В элементе purchase может быть несколько элементов product.
<purchase>
  <product offer-id="03"/>
  <product offer-id="04"/>
</purchase>
Да

Пример

<yml_catalog date="2023-04-10 06:00+0300">
 <shop>
  <name>BestSeller</name>
  <company>Tne Best inc.</company>
  <url>http://best.seller.ru</url>
  <version>1.0</version>
  <email>example-email@yandex.ru</email>
  <currencies>
   <currency id="RUB" rate="1"></currency>
  </currencies>
  <categories>
   <category id="1">Бытовая техника</category>
   <category id="10" parentId="1">Мелкая техника для кухни</category>
   <category id="101" parentId="10">Расходные материалы</category>
  </categories>
  <promos>
   <promo id="bestpromo00" type="promo code">
    <start-date>2023-01-11 09:00:00</start-date>
    <end-date>2023-12-01 09:00:00</end-date>
    <promo-code>TESTPROMOCODE1</promo-code>
    <discount unit="currency" currency="RUR">100</discount>
    <url>http://best.seller.ru/promos/bestpromo00</url>
    <purchase>
     <product offer-id="1001"></product>
     <product offer-id="1002"></product>
    </purchase>
   </promo>
   <promo id="bestpromo02" type="promo code">
    <start-date>2022-02-01 09:00:00</start-date>
    <end-date>2022-12-01 09:00:00</end-date>
    <promo-code>TESTPROMOCODE2</promo-code>
    <discount unit="percent">10</discount>
    <url>http://best.seller.ru/promos/bestpromo02</url>
    <purchase>
     <product offer-id="1004"></product>
     <product offer-id="1005"></product>
    </purchase>
   </promo>
  </promos>
  <offers>
   <offer id="1000" available="true">
    <url>http://best.seller.ru/9728.html</url>
    <price>900</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Samsung CLT-M504S красный</name>
    <picture>http://best.seller.ru/upload/2b6d0675ad027a19e6377278746437ef3.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Samsung CLT-M504S красный</p>]]>
    </description>
   </offer>
   <offer id="1001" available="true">
    <url>http://best.seller.ru/10752.html</url>
    <price>1650</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Kyocera TK-3130</name>
    <picture>http://best.seller.ru/upload/2eb840e22702d851ef2610623942830b3.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Kyocera TK-3130</p>]]>
    </description>
   </offer>
   <offer id="1002" available="true">
    <url>http://best.seller.ru/21504.html</url>
    <price>1680</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа HP CF237X</name>
    <picture>http://best.seller.ru/upload/312715ab35bdd8f8a288baa874c5a8791.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа HP CF237X</p>]]>
    </description>
   </offer>
   <offer id="1003" available="true">
    <url>http://best.seller.ru/21760.html</url>
    <price>550</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Ricoh Type SP200HE, с чипом</name>
    <picture>http://hananodou.ru/upload/iblock/a14/a14b7e8ee83eefaa18649e3e3da8a36d.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Ricoh Type SP200HE, с чипом</p>]]>
    </description>
   </offer>
   <offer id="1004" available="true">
    <url>http://best.seller.ru/9729.html</url>
    <price>920</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Samsung CLT-Y504S желтый</name>
    <picture>http://best.seller.ru/upload/444bee3b54adbcb384a9ddaeeeeb374b4.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Samsung CLT-Y504S желтый</p>]]>
    </description>
   </offer>
   <offer id="1005" available="true">
    <url>http://best.seller.ru/10753.html</url>
    <price>1270</price>
    <currencyId>RUB</currencyId>
    <categoryId>101</categoryId>
    <name>Заправка картриджа Kyocera TK-400</name>
    <picture>http://best.seller.ru/upload/3aadd586142598ab139325cf5ce0ed771.jpg</picture>
    <description>
     <![CDATA[<p>Заправка картриджа Kyocera TK-400</p>]]>
    </description>
   </offer>
  </offers>
 </shop>
</yml_catalog>