Полный справочник полей
Сводная шпаргалка по всему, что читает сервис, и разбор боевого фида.
Элементы каркаса
| Элемент | Обяз. | Назначение |
|---|---|---|
<yml_catalog> | ✅ | Корень документа. |
<shop> | ✅ | Контейнер магазина. |
<shop><url> | — | Адрес магазина (для абсолютных ссылок). |
<currencies> | — | Не обязателен (валюта берётся из <currencyId> оффера). |
<categories> | ✅* | Дерево категорий. |
<category> | — | id, parentId, url, название. |
<offers> | ✅ | Список товаров. |
<offer> | ✅ | Товар: атрибуты + теги. |
* Формально фид разберётся и без категорий, но роль «Категория» обязательна — без дерева категорийный поиск/фильтр не работает.
Атрибуты <offer>
| Атрибут | Обяз. | По умолчанию |
|---|---|---|
id | ✅ | — (иначе товар пропущен) |
group_id | — | = id |
available | — | «в наличии» |
Прочие атрибуты (например, type) не используются.
Стандартные теги <offer>
| Тег | Значение | Обяз. (для ролей) |
|---|---|---|
<name> | Название | ✅ |
<model> | Название (запасной источник) | — |
<url> | Ссылка | ✅ |
<price> | Цена | ✅ |
<picture> | Изображение(я) | ✅ |
<categoryId> | Категория (+ предки); можно несколько, первый — основной раздел | ✅ |
<oldprice> | Старая цена | — |
<currencyId> | Валюта | — |
<vendor> | Производитель | — |
<description> | Описание (HTML вычищается) | — |
<param name="…"> | Характеристика | — |
| любой другой тег | Поле проекта (работает по настройке в ЛК) | — |
Характеристики <param>
| Часть | Обяз. | Назначение |
|---|---|---|
name | ✅ | Ключ характеристики. |
type | — | Подсказка типа (color / enum / string). |
| значение | ✅ | Строка (или список при повторе/split). |
Роли полей
| Роль | Обяз. |
|---|---|
| Идентификатор | ✅ |
| Название | ✅ |
| Цена | ✅ |
| Ссылка | ✅ |
| Категория | ✅ |
| Изображение | ✅ |
| Группа SKU, Наличие, Производитель, Описание, Старая цена, Все изображения | — |
Пример фида
Обезличенный пример фида интернет-магазина одежды — эталон структуры.
Масштаб примера: ~2400 офферов, 24 категории, 16 характеристик, кодировка utf-8, размер ≈ 4,5 МБ.
Каркас
xml
<?xml version="1.0" encoding="utf-8"?>
<yml_catalog date="2026-07-13 09:43">
<shop>
<name>Acme</name>
<url>https://example.com</url>
<currencies><currency id="RUB" rate="1"/></currencies>
<categories>
<category id="38" url="https://example.com/catalog/topy-i-baski/">Топы и баски</category>
<category id="42" url="https://example.com/catalog/yubki/">Юбки</category>
<!-- … всего 24 … -->
</categories>
<offers>
<!-- … 2425 офферов … -->
</offers>
</shop>
</yml_catalog>Один оффер
xml
<offer id="5684" type="vendor.model" available="false" group_id="5652">
<url>https://example.com/product/baska-na-zavyshennoy-talii-s-kantom/</url>
<currencyId>RUB</currencyId>
<categoryId>38</categoryId>
<picture>https://example.com/upload/iblock/105/105b6891de78429372f7e58f7549eb26.jpg</picture>
<model>Баска на завышенной талии с кантом</model>
<price>10100</price>
<vendor>Acme</vendor>
<vendorCode>00001402</vendorCode>
<name>Баска на завышенной талии с кантом</name>
<param name="Стиль">вечерние</param>
<param name="Стиль">повседневные</param>
<param name="Материал">хлопок</param>
<param name="Цвет" picture="https://example.com/swatch/4bbf15.webp">белый</param>
<param name="Размер">XS</param>
<param name="Предзаказ">Нет</param>
</offer>Как этот оффер читается
| В фиде | Как используется |
|---|---|
id="5684" | Идентификатор товара |
group_id="5652" | Группа вариантов (5684–5686 — один товар) |
available="false" | «Нет в наличии» |
type="vendor.model" | Не используется |
<name> (и <model>) | Название (name приоритетнее model) |
<url> | Ссылка на карточку |
<price>10100 | Цена 10100 |
<currencyId>RUB | Валюта |
<categoryId>38 | Категория «Топы и баски» и все её родители |
<picture> | Изображение + галерея |
<vendor> | Бренд «Acme» |
<vendorCode> | Поле проекта — работает по настройке в ЛК |
<param name="Стиль"> ×2 | Характеристика «Стиль» = список из двух значений |
<param name="Цвет"> | Характеристика «Цвет»; если включена как фильтр — фасет |
picture="…" у <param> | Вид в фильтре: картинка-образец или код цвета рядом с названием |