Оффер: атрибуты и поля
<offer> — одно товарное предложение. Как правило, это конкретный SKU (например, платье «Ривьера» размера S). Каждый оффер становится одним товаром в выдаче.
Атрибуты оффера
| Атрибут | Обяз. | Поведение |
|---|---|---|
id | ✅ | Уникальный идентификатор товара. Оффер с пустым/отсутствующим id не индексируется. |
group_id | — | Идентификатор группы вариантов. Если не задан — равен id. Используется для группировки SKU. |
available | — | Наличие. false или 0 → «нет в наличии»; любое другое значение (в т. ч. отсутствие атрибута) → «в наличии». |
Прочие атрибуты (например, type="vendor.model") не используются — указывать их можно, но на разбор они не влияют.
xml
<offer id="5684" group_id="5652" available="false">…</offer>Стандартные теги
Внутри оффера сервис распознаёт набор стандартных YML-тегов без всякой настройки:
| Тег фида | Значение в товаре | Комментарий |
|---|---|---|
<name> | Название | Приоритетный источник имени. |
<model> | Название (запасной) | Используется, только если нет <name>. |
<url> | Ссылка на карточку | Относительные ссылки достраиваются до абсолютных. |
<picture> | Изображение(я) | Первая картинка — главная, все <picture> — галерея. |
<price> | Цена | Число; при отсутствии — 0. |
<oldprice> | Старая цена | Для подсветки скидок. |
<currencyId> | Валюта | RUB, … |
<categoryId> | Категория (можно несколько) | Каждый тег разворачивается в цепочку предков; первый — основной раздел. |
<vendor> | Производитель/бренд | Для фильтра по бренду. |
<description> | Описание | HTML вычищается автоматически. |
Пустые теги игнорируются.
Нестандартные (произвольные) теги
Любой тег оффера, которого нет в таблице выше (например, <vendorCode>, <barcode>, <country>), сервис при импорте обнаруживает и добавляет в список полей проекта.
Нестандартные теги не участвуют в поиске, пока вы их не включите
Обнаруженное поле по умолчанию не участвует в поиске, фильтрах и сортировке (и остаётся пустым в документе, пока ему не задана роль). Чтобы задействовать его — включите нужную роль (поиск / фильтр / сортировка) в личном кабинете. Один флаг «Отображение» тег не активирует. Стандартные теги из таблицы выше работают всегда. Подробнее — «Настройка в личном кабинете».
Как формируются отдельные поля
Название
<name>, иначе <model>. Если оба пусты, имя достраивается из бренда и категории (например, Acme Юбки); в крайнем случае — Товар #{id}. Лучший результат всегда даёт явный <name>.
Цена
<price> — число без символов валюты и пробелов, дробная часть через точку (7990, 79.50). Диапазоны недопустимы. <oldprice> показывается как старая цена, только если присутствует.
Изображения
Первый <picture> — главное изображение, все <picture> — галерея (в порядке следования). Относительный путь (/img/a.jpg) достраивается до абсолютного по адресу магазина.
xml
<picture>https://example.com/img/front.jpg</picture>
<picture>https://example.com/img/back.jpg</picture>Ссылка (url)
- Собственный
<url>оффера (относительный — достраивается до абсолютного). - Если
<url>нет — ссылка собирается изurlосновной категории (первый<categoryId>) иgroup_id.
Явный <url> в каждом оффере — предпочтительный вариант.
Наличие
Определяется атрибутом available (см. выше). Отдельного тега не требуется.