Пример 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	Идентификатор категории. Можно несколько, первый — основная категория.
description	Описание. Для HTML используйте CDATA. До 200 символов.

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

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

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

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

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

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