Элементы, входящие в shop
Описание элементов внутри shop
|
Элемент |
Описание |
Обязателен |
|
|
Короткое название магазина. |
Да |
|
|
Полное наименование компании, владеющей магазином. Не публикуется. |
Да |
|
|
Адрес сайта магазина, записанный согласно стандарту RFC 3986. |
Да |
|
|
Список курсов валют магазина. Поддерживаются только рубли. |
Да |
|
|
Да |
|
|
|
Наличие курьерской доставки. Принимает значения Указывает на условия, общие для магазина. Условия доставки, специфичные для товаров указывайте внутри элемента |
Нет |
|
|
Количество дней, требуемых на доставку. Может содержать до 5 элементов Указывает на условия, общие для магазина. Условия доставки, специфичные для товаров указывайте внутри элемента |
Нет |
|
|
Список предложений магазина. Каждое предложение описывается в отдельном элементе |
Да |
|
|
Блок данных о промокодах для всех пользователей. |
Да, если есть промокоды для всех. |
Элементы внутри promos
|
|
Данные о промокодах. |
Да, если есть промокоды для всех. |
Элементы внутри promo
|
Атрибут |
Идентификатор промокода. Не может совпадать с идентификаторами программ лояльности и других акций. Может содержать только цифры, латинские буквы и кириллицу. Максимальная длина Внимание Конкретное предложение может участвовать только в одной акции или программе лояльности. Если предложение указано в разных акциях и программах, для него случайным образом будет выбрана одна. |
Да |
|
Атрибут |
Тип акции — |
Да |
|
|
Дата и время начала акции. Должна быть меньше даты завершения акции ( Дата и время завершения акции. Допустимые форматы:
Примеры
|
Да |
|
|
Ссылка на описание акции на сайте магазина. Максимальная длина ссылки — 2048 символов. Допускаются кириллические ссылки. URL-адрес формируется по стандарту RFC 3986. |
Да |
|
|
Текст промокода. Может содержать только цифры и латинские буквы. Длина промокода: от 3 до 15 символов. |
Да |
|
|
Размер скидки в процентах от стоимости или в валюте. Тип скидки указывается в атрибутах:
Примеры Скидка 300 руб. Скидка 10% |
Да |
|
|
Информация о товарах, участвующих в акции. Может содержать несколько элементов |
Да |
Элементы внутри 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>
Описание
Короткое название магазина.
Обязателен
Да
Описание
Полное наименование компании, владеющей магазином. Не публикуется.
Обязателен
Да
Описание
Адрес сайта магазина, записанный согласно стандарту RFC 3986.
Обязателен
Да
Описание
Список курсов валют магазина. Поддерживаются только рубли.
Обязателен
Да
Описание
Обязателен
Да
Описание
Список предложений магазина. Каждое предложение описывается в отдельном элементе offer. Здесь не приводится список всех элементов, входящих в offer, так как он зависит от типа предложения. Для большинства категорий товаров подходят следующие типы описаний:
Обязателен
Да
Описание
Блок данных о промокодах для всех пользователей.
Обязателен
Да, если есть промокоды для всех.
Описание
Данные о промокодах.
Обязателен
Да
Описание
Дата и время начала акции. Должна быть меньше даты завершения акции (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
Обязателен
Да
Описание
Текст промокода. Может содержать только цифры и латинские буквы. Максимальная длина — 20 символов.
Обязателен
Да
Описание
Размер скидки в процентах от стоимости или в валюте. Тип скидки указывается в атрибутах:
-
unit="percent"— скидка в процентах, доступные значения: от 5 до 95 процентов; -
unit="currency" currency="RUR"— скидка в валюте, доступно значениеRUR.
Скидка 300 руб.
<discount unit="currency" currency="RUR">300</discount>
Скидка 10%
<discount unit="percent">10</discount>
Обязателен
Да
Описание
Информация о товарах, участвующих в акции. Может содержать несколько элементов product, но не больше 1 000 000.
Обязателен
Да
Описание
Товары, на которые действует акция. Содержит обязательный атрибут offer-id — идентификатор предложения.
Один элемент product соответствует одному товару. Максимальное количество элементов product — 1 000 000.
В элементе purchase может быть несколько элементов product.
<purchase>
<product offer-id="03"/>
<product offer-id="04"/>
</purchase>
Обязателен
Да