Пример YML-файла

Поддержка региональности (стоков)

Ниже приведены отдельные примеры YML-файла с поддержкой региональности (стоков) и без неё.

Без региональности

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-01-01 17:22">
  <shop>
    <categories>
      <category id="1278">Электроника</category>
      <category id="1293" parentId="1278">Смартфоны</category>
      <category id="1345" parentId="1278">Телефоны</category>
      <category id="3761" parentId="1278">Телевизоры</category>
      <category id="1553" parentId="3761">Медиа-плееры</category>
      <category id="3798">Бытовая техника</category>
    </categories>
    <offers>
      <offer id="1637" available="true">
        <url>http://example.com/product/id1637</url>
        <price>226.50</price>
        <oldprice>250</oldprice>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1637_1.jpg</picture>
        <name>Товар 1</name>
        <typePrefix>Тип изделия</typePrefix>
        <param name="Диагональ">6</param>
        <description>Описание товара 1637</description>
        <vendor>Название производителя</vendor>
      </offer>
      <offer id="1638" available="false">
        <url>http://example.com/product/id1638</url>
        <price>545.30</price>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1638_1.jpg</picture>
        <name>Товар 2</name>
        <typePrefix>Тип изделия</typePrefix>
        <param name="Цвет">Белый</param>
        <description>Описание товара 1638</description>
        <vendor>Название производителя</vendor>
      </offer>
    </offers>
  </shop>
</yml_catalog>

С региональностью

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-01-01 17:22">
  <shop>
    <categories>
      <category id="1278">Электроника</category>
      <category id="1293" parentId="1278">Смартфоны</category>
      <category id="1345" parentId="1278">Телефоны</category>
      <category id="3761" parentId="1278">Телевизоры</category>
      <category id="1553" parentId="3761">Медиа-плееры</category>
      <category id="3798">Бытовая техника</category>
    </categories>
    <offers>
      <offer id="1637" available="false">
        <url>http://example.com/product/id1637</url>
        <price>226.50</price>
        <oldprice>250</oldprice>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1637_1.jpg</picture>
        <name>Товар 1</name>
        <param name="Диагональ">6</param>
        <description>Описание товара 1637</description>
        <vendor>Название производителя</vendor>
        <stock id="Москва">
          <available>true</available>
          <price>230.30</price>
          <oldprice>252</oldprice>
          <url>http://example.com/product/id1637</url>
          <picture>http://example.com/images/1637_2.jpg</picture>
        </stock>
        <stock id="Екатеринбург">
          <available>false</available>
          <price>235</price>
          <oldprice>251.60</oldprice>
          <url>http://example.com/product/id1637</url>
          <picture>http://example.com/images/1637_2.jpg</picture>
        </stock>
      </offer>
      <offer id="1638" available="false">
        <url>http://example.com/product/id1638</url>
        <price>545.30</price>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1638_1.jpg</picture>
        <name>Товар 2</name>
        <param name="Цвет">Белый</param>
        <description>Описание товара 1638</description>
        <vendor>Название производителя</vendor>
        <stock id="Москва">
          <available>true</available>
          <price>500</price>
          <oldprice>550</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_2.jpg</picture>
        </stock>
        <stock id="Екатеринбург">
          <available>true</available>
          <price>540.50</price>
          <oldprice>600</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_3.jpg</picture>
        </stock>
      </offer>
    </offers>
  </shop>
</yml_catalog>

С групповыми товарами

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2018-09-25 17:22">
  <shop>
    <categories>
      <category id="1278">Электроника</category>
      <category id="1293" parentId="1278">Смартфоны</category>
      <category id="1345" parentId="1278">Телефоны</category>
      <category id="3761" parentId="1278">Телевизоры</category>
      <category id="1553" parentId="3761">Медиа-плееры</category>
      <category id="3798">Бытовая техника</category>
    </categories>
    <offers>
      <offer id="1637" available="true" group_id="12345">
        <url>http://example.com/product/id1637</url>
        <price>226.50</price>
        <oldprice>250</oldprice>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1637_1.jpg</picture>
        <name>Товар 1</name>
        <param name="Цвет">Чёрный</param>
        <description>Описание товара 1637</description>
        <vendor>Название производителя</vendor>
        <model>Модель товарного предложения</model>
      </offer>
      <offer id="1638" available="false" group_id="12345">
        <url>http://example.com/product/id1638</url>
        <price>545.30</price>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1638_1.jpg</picture>
        <name>Товар 2</name>
        <param name="Цвет">Белый</param>
        <description>Описание товара 1638</description>
        <vendor>Название производителя</vendor>
        <model>Модель товарного предложения</model>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Групповые товары и региональность

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2018-09-25 17:22">
  <shop>
    <categories>
      <category id="1278">Электроника</category>
      <category id="1293" parentId="1278">Смартфоны</category>
      <category id="1345" parentId="1278">Телефоны</category>
      <category id="3761" parentId="1278">Телевизоры</category>
      <category id="1553" parentId="3761">Медиа-плееры</category>
      <category id="3798">Бытовая техника</category>
    </categories>
    <offers>
      <offer id="1637" available="false" group_id="12345">
        <url>http://example.com/product/id1637</url>
        <price>226.50</price>
        <oldprice>250</oldprice>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1637_1.jpg</picture>
        <name>Товар 1</name>
        <param name="Цвет">Чёрный</param>
        <description>Описание товара 1637</description>
        <vendor>Название производителя</vendor>
        <model>Модель товарного предложения</model>
        <stock id="Москва">
          <available>true</available>
          <price>230.30</price>
          <oldprice>252</oldprice>
          <url>http://example.com/product/id1637</url>
          <picture>http://example.com/images/1637_2.jpg</picture>
        </stock>
        <stock id="Екатеринбург">
          <available>false</available>
          <price>235</price>
          <oldprice>251.60</oldprice>
          <url>http://example.com/product/id1637</url>
          <picture>http://example.com/images/1637_2.jpg</picture>
        </stock>
      </offer>
      <offer id="1638" available="false" group_id="12345">
        <url>http://example.com/product/id1638</url>
        <price>545.30</price>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1638_1.jpg</picture>
        <name>Товар 2</name>
        <param name="Цвет">Белый</param>
        <description>Описание товара 1638</description>
        <vendor>Название производителя</vendor>
        <model>Модель товарного предложения</model>
        <stock id="Москва">
          <available>true</available>
          <price>500</price>
          <oldprice>550</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_2.jpg</picture>
        </stock>
        <stock id="Екатеринбург">
          <available>true</available>
          <price>540.50</price>
          <oldprice>600</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_3.jpg</picture>
        </stock>
      </offer>
    </offers>
  </shop>
</yml_catalog>

примечание

При использовании региональности (стоков) атрибут available у каждого <offer> обязан быть false. Актуальное наличие задаётся внутри каждого <stock>.

Фрагмент с региональностью
<offer id="1638" available="false">
  <!-- другие параметры -->
  <stock id="Москва">
    <available>true</available>
    <!-- другие параметры -->
  </stock>
</offer>

Обязательные элементы YML

Элемент	Описание
xml header	Стандартный XML-заголовок. Должен начинаться с первой строки, с нулевого символа.
yml_catalog	Единственный корневой элемент. Атрибут `date` в формате YYYY-MM-DD hh:mm.
shop	Содержит `categories` и `offers`.
categories	Объявление всех категорий магазина. Иерархия должна совпадать с меню сайта.
category	Атрибут `id` должен иметь числовое значение. Если указан `parentId`, его значение также должно быть числовым. Глубина вложенности не более 15 уровней.
offers	Список товарных предложений.
offer	Атрибуты: `id`, `available` (`true`/`false`). Для групп: `group_id` — целое число.
name	Название товарного предложения.
url	Полная ссылка на карточку товара.
picture	Полная ссылка на изображение (JPEG/PNG/WebP), до 400×400 или до 1 МБ.
price	Цена, дробная часть через точку.
categoryId	Числовой идентификатор категории, указанный в `categories`. Можно передать несколько элементов, первый — основная категория.
description	Описание. Для HTML используйте CDATA. До 200 символов.

Дополнительные параметры

Элемент	Описание
oldprice	Старая цена, дробная часть через точку.
vendor	Производитель или бренд.
model	Модель товарного предложения.
param name	До 200 дополнительных параметров. Макс. 300 символов. Примеры: `addedDate` в формате YYYY-MM-DD; `Размер` со значением `S`.
typePrefix	Тип изделия.

Без региональности​

С региональностью​

С групповыми товарами​

Групповые товары и региональность​

Обязательные элементы YML​

Дополнительные параметры​