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

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
<od_price>
Старая цена (цена до скидки)
Опционально
139999
<vendor_code>
Артикул производителя
Опционально
RN12-XIAOMI
<barcode>
Штрих-код товара
Опционально
4601234567890
<param>
Дополнительные атрибуты товара. Можно повторить этот тег несколько раз
Опционально
Y
available="true|false"или<available>
Товар в наличии
Опционально
true - в наличии
false - нет в наличии

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

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