Инструкция по формату YML-фида

Описание формата и справочник тегов:

yml-yandex-old-description.zip
1MB, Uploaded 2 months ago

1. Общие требования к YML-фиду

Фид должен быть оформлен в формате YML (Yandex Market Language) и содержать обязательные теги с корректными значениями. Это необходимо для:
  • Корректной работы событий сайта (например, отслеживание покупок, добавления в корзину).
  • Формирования автоматических рассылок.
  • Отображения актуальных данных о товарах на платформе.
 Проверьте перед подгрузкой:
  • Фид соответствует синтаксису YML (рекомендуется использовать XML-валидаторы).
  • Все обязательные теги заполнены.
  • Значения ключевых тегов совпадают с данными в системе (см. раздел 3).
Тег/атрибут
Описание
Обязательность
Пример значения
id="XXX"
Уникальный идентификатор товара в системе (должен совпадать с externalId в API)
Обязательно
12345
group_id="XXX"
Уникальный идентификатор товара, если это объединение вариантов одной каталожной единицы. В этом случае значение id трактуется как идентификатор варианта (признак обединения вариантов под одним товаром)
Опционально
12345
<name>
Полное наименование товара.
Обязательно
Смартфон Xiaomi Redmi Note 12
<categoryId>
ID категории товара на платформе (должен совпадать с categoryExternalId в API)
Обязательно
123
<url>
Прямая ссылка на страницу товара на сайте
Обязательно
https://example.com/product/123
<price>
Текущая цена товара (в валюте платформы)
Обязательно
149999
<picture>
Ссылка на изображения товара. Если тегов несколько, берется только первое изображение
Обязательно
https://example.com/img1.jpg
<model>
Модель товара - используется вместо названия (только если type равен vendor.model)
Рекомендуется
Redmi Note 12
<old_price>
Старая цена (цена до скидки)
Опционально
139999
<vendor_code>
Артикул производителя
Опционально
RN12-XIAOMI
<barcode>
Штрих-код товара
Опционально
4601234567890
<param>
Дополнительные атрибуты товара. Можно повторить этот тег несколько раз
Опционально
Y
available="true|false"или<available>
Товар в наличии
Опционально
true - в наличии
false - нет в наличии
<count>
Доступное количество товара (необходимо для товарных рекомендаций)
Рекомендуется
<count>7</count>

3. Важные соответствия

Для корректной синхронизации данных убедитесь, что:
  • id товара в фиде строго соответствует externalId в вашей системе.
  • <categoryId> в фиде совпадает с categoryExternalId категории на платформе.
Последствия несовпадения:
  • Товары не отобразятся в правильных категориях.
  • События сайта (например, покупки) не будут привязаны к корректным товарам.
  • Рассылки могут содержать некорректные данные.

4. Пример фида

Данные символы это визуальные разделители в XML-комментариях, которые нужны для описания блоков и тегов:<!-- =============== -->



Пример:
<yml_catalog date="2025-12-24T14:16:02+05:00">
<shop>

<!-- ============================================================================== -->
<!-- НАЗВАНИЕ МАГАЗИНА И КОМПАНИИ                                                  -->
<!-- ============================================================================== -->
<name>FashionStore</name>
<company>FashionStore Inc.</company>

<!-- ============================================================================== -->
<!-- URL МАГАЗИНА - ОСНОВНОЙ АДРЕС САЙТА                                           -->
<!-- ============================================================================== -->
<url>https://fashion-store-example.com</url>

<platform>Custom/Yandex/Market</platform>
<version>2.9.9</version>

<!-- ============================================================================== -->
<!--  КАТЕГОРИИ ТОВАРОВ                                                             -->
<!--  categoryId должен совпадать с categoryExternalId в API системы                -->
<!-- ============================================================================== -->
<categories>
<category id="100">ОДЕЖДА</category>
<category id="101" parentId="100">ПРЕМИУМ БРЕНДЫ</category>
<category id="102" parentId="100">ВСЕ ТОВАРЫ</category>
<category id="103" parentId="100">ТРИКОТАЖ</category>
<category id="104" parentId="100">ЛОНГСЛИВЫ</category>
<category id="105" parentId="100">ТОПЫ И БОДИ</category>
<category id="106" parentId="100">ПЛАТЬЯ</category>
<category id="107" parentId="100">СВИТШОТЫ</category>
<category id="108" parentId="100">КУПАЛЬНИКИ</category>
<category id="109" parentId="100">ХУДИ</category>
<category id="110" parentId="100">АКСЕССУАРЫ</category>
<category id="111" parentId="100">НИЖНЕЕ БЕЛЬЕ</category>
</categories>

<offers>

<!-- ============================================================================== -->
<!--  ТОВАР #1 - КУПАЛЬНИК                                                          -->
<!--  id="50001" - Уникальный идентификатор товара в системе                        -->
<!--  Должен совпадать с externalId в API при интеграции                            -->
<!--  available="true" - товар в наличии (false - нет в наличии)                    -->
<!-- ============================================================================== -->
<offer id="50001" available="true">

<!-- ПРЯМАЯ ССЫЛКА НА СТРАНИЦУ ТОВАРА НА САЙТЕ -->
<url>https://fashion-store-example.com/catalog/swimwear/50001/</url>

<!-- ТЕКУЩАЯ ЦЕНА ТОВАРА (в валюте платформы) -->
<price>4290</price>
<currencyId>RUR</currencyId>

<!-- ID КАТЕГОРИИ ТОВАРА - должен совпадать с ID в разделе <categories> выше -->
<categoryId>108</categoryId>

<!-- ССЫЛКИ НА ИЗОБРАЖЕНИЯ ТОВАРА -->
<!-- ВАЖНО: Если тегов несколько, обычно берется только первое изображение -->
<picture>https://fashion-store-example.com/upload/images/swimwear_1_main.jpg</picture>
<picture>https://fashion-store-example.com/upload/images/swimwear_1_alt1.jpg</picture>
<picture>https://fashion-store-example.com/upload/images/swimwear_1_alt2.jpg</picture>

<!-- ПОЛНОЕ НАИМЕНОВАНИЕ ТОВАРА -->
<name>Бикини стринги с принтом "Геометрия"</name>

<vendor>FashionStore Brand</vendor>

<!-- АРТИКУЛ ПРОИЗВОДИТЕЛЯ (vendor_code) -->
<vendorCode>FSBW0100101055/ECR</vendorCode>

<manufacturer>FashionStore Manufacturing</manufacturer>
<country_of_origin>Россия</country_of_origin>

<!-- ШТРИХ-КОД ТОВАРА (barcode) -->
<barcode>4650111195857</barcode>
<count>7</count>
<!-- ============================================================================== -->
<!--  ДОПОЛНИТЕЛЬНЫЕ АТРИБУТЫ ТОВАРА (param)                                        -->
<!--  Можно повторять этот тег несколько раз для разных характеристик               -->
<!-- ============================================================================== -->
<param name="Цвет">принт бежевый</param>
<param name="Размер">S</param>
<param name="Номер карточки">FSBW0100101055/ECR</param>
<param name="Название карточки">Бикини стринги с принтом "Геометрия"</param>
<param name="Элемент каталога">50001</param>

<weight>0.4</weight>
<dimensions>40/30/3</dimensions>
</offer>

<!-- ============================================================================== -->
<!--  ТОВАР #2 - ЛОНГСЛИВ                                                           -->
<!-- ============================================================================== -->
<offer id="50002" available="true">
<url>https://fashion-store-example.com/catalog/longslivy/50002/</url>
<price>4590</price>

<!-- СТАРАЯ ЦЕНА (цена до скидки) - old_price -->
<oldprice>5490</oldprice>

<currencyId>RUR</currencyId>
<categoryId>104</categoryId>
<picture>https://fashion-store-example.com/upload/images/longsleeve_white_main.jpg</picture>
<picture>https://fashion-store-example.com/upload/images/longsleeve_white_alt1.jpg</picture>
<picture>https://fashion-store-example.com/upload/images/longsleeve_white_alt2.jpg</picture>
<name>Лонгслив приталенный WHITE</name>
<vendor>FashionStore Brand</vendor>
<vendorCode>FS.03.3.4101WH</vendorCode>
<description>Параметры модели: рост 170 см, обхват груди 84 см, обхват талии 60 см, обхват бедер 90 см. На модели представлен размер S.</description>
<manufacturer>FashionStore Manufacturing</manufacturer>
<country_of_origin>Россия</country_of_origin>
<barcode>4660522474111</barcode>
<!-- КОЛИЧЕСТВО ТОВАРА НА СКЛАДЕ -->
<count>7</count>
<param name="Цвет">Белый</param>
<param name="Размер">M</param>
<param name="Номер карточки">FS.03.3.4101WH</param>
<param name="Название карточки">Лонгслив приталенный WHITE</param>
<param name="Элемент каталога">50002</param>
<weight>0.45</weight>
<dimensions>42/32/4</dimensions>
</offer>

<!-- ============================================================================== -->
<!--  ТОВАР #3 - РУБАШКА                                                            -->
<!-- ============================================================================== -->
<offer id="50003" available="true">
<url>https://fashion-store-example.com/catalog/all_products/50003/</url>
<price>5990</price>
<oldprice>7990</oldprice>
<currencyId>RUR</currencyId>
<categoryId>102</categoryId>
<picture>https://fashion-store-example.com/upload/images/shirt_blue_main.jpg</picture>
<picture>https://fashion-store-example.com/upload/images/shirt_blue_alt1.jpg</picture>
<name>Рубашка свободного кроя из тенсела SKY BLUE</name>
<vendor>FashionStore Brand</vendor>
<vendorCode>FS.06.4.0424/SBL</vendorCode>
<description>Свободная рубашка голубого оттенка из мягкого тенсела. Широкие манжеты и удобный крой. Идеальна для casual-образов. Параметры модели: рост 170 см, обхват груди 84 см, обхват талии 60 см, обхват бедер 90 см. На модели представлен размер S.</description>
<manufacturer>FashionStore Manufacturing</manufacturer>
<country_of_origin>Россия</country_of_origin>
<barcode>4660522473555</barcode>
<count>7</count>
<param name="Цвет">Голубой</param>
<param name="Размер">L</param>
<param name="Номер карточки">FS.06.4.0424/SBL</param>
<param name="Название карточки">Рубашка свободного кроя из тенсела SKY BLUE</param>
<param name="Элемент каталога">50003</param>
<weight>0.55</weight>
<dimensions>44/34/5</dimensions>
</offer>

</offers>
</shop>
</yml_catalog>