Чтобы товары появились в Яндекс.Маркете, площадке нужен не сам сайт, а специально сформированный файл каталога в формате YML — упрощённый вариант XML с фиксированной структурой полей: название, цена, категория, наличие, характеристики.
В 1С-Битрикс YML-файл собирается штатным экспортом каталога, и большая часть работы приходится не на техническую генерацию, а на правильное сопоставление категорий и заполнение обязательных полей — без них площадка отклонит выгрузку целиком или конкретные товары.
Что такое YML
Формат YML — Yandex Market Language, диалект XML с обязательной структурой. Файл состоит из двух главных блоков:
| Блок | Содержимое |
|---|---|
<categories> | Дерево категорий магазина с идентификаторами |
<offers> | Список товаров со ссылкой на категорию, ценой и характеристиками |
Минимальный пример одного предложения внутри файла:
<offer id="1024" available="true">
<url>https://site.ru/catalog/stol-pismennyj/</url>
<price>12990</price>
<currencyId>RUR</currencyId>
<categoryId>42</categoryId>
<picture>https://site.ru/upload/stol.jpg</picture>
<name>Стол письменный "Классик"</name>
<vendor>МебельПром</vendor>
<description>Письменный стол из массива дуба.</description>
</offer>Штатный экспорт из Битрикс
Раздел Магазин → Настройки → Экспорт в торговые системы позволяет собрать YML без написания кода. Настройка сводится к нескольким шагам:
- Выберите инфоблок каталога и торговых предложений, если они используются.
- Сопоставьте категории Битрикс с категориями, которые попадут в файл.
- Выберите тип цен, участвующий в выгрузке.
- Укажите, какие свойства товара становятся характеристиками в YML.
- Задайте расписание обновления файла.
- Получите постоянную ссылку на файл для указания в личном кабинете Маркета.
Расписание настраивается через агент — как и большинство фоновых задач в Битрикс. Генерацию тяжёлого файла на крупном каталоге разумно запускать ночью, а не на каждом хите; общие принципы работы с агентами разобраны в статье Агенты в Битрикс.
Нужна помощь с Битрикс?
Сопоставление категорий
Самая трудоёмкая часть настройки — не техническая, а смысловая. Дерево разделов каталога на сайте почти никогда не совпадает один в один со структурой, которую ожидает Маркет, поэтому категории приходится сопоставлять вручную в интерфейсе экспорта.
Правило простое: каждая выгружаемая категория должна вести к конечным товарам, а не оставаться пустой. Пустые категории в файле не запрещены формально, но не приносят пользы и усложняют модерацию на стороне площадки.
Обязательные и рекомендуемые поля
| Поле | Статус | Что будет, если пропущено |
|---|---|---|
price | Обязательно | Товар не пройдёт в выгрузку |
categoryId | Обязательно | Товар не появится в каталоге площадки |
picture | Рекомендуется | Карточка выглядит хуже, ниже кликабельность |
vendor | Рекомендуется | Хуже работает сравнение и фильтрация на площадке |
description | Рекомендуется | Модерация может занять больше времени |
param | Желательно | Товар не попадает в сравнение характеристик |
Характеристики через тег <param> формируются из свойств
инфоблока — тех же самых, что участвуют в умном фильтре на сайте. Если свойства
каталога уже настроены и заполнены, для YML остаётся только указать,
какие из них включить в выгрузку.
Наличие и остатки
Атрибут available у каждого предложения должен отражать
реальное наличие товара. Если каталог синхронизируется с 1С, важно, чтобы
YML-файл обновлялся уже после завершения обмена остатками, а не параллельно
с ним — иначе площадка получит устаревшие данные о наличии.
Порядок настройки самого обмена и типичные проблемы синхронизации разобраны в статье Интеграция Битрикс с 1С.
Проверка файла
Прежде чем указывать ссылку на файл в личном кабинете Маркета, стоит проверить его самостоятельно:
- Откройте ссылку на файл в браузере — он должен открываться как валидный XML.
- Проверьте, что число товаров в файле совпадает с ожидаемым.
- Убедитесь, что цены указаны без ошибок округления.
- Проверьте несколько случайных категорий на корректность сопоставления.
- Убедитесь, что ссылки на карточки товаров рабочие, а не ведут на 404.
- Проверьте, что файл обновляется по расписанию, а не остаётся статичным.
Последний пункт легко пропустить: файл может сгенерироваться один раз корректно, а агент обновления окажется неактивен — тогда площадка месяцами показывает устаревшие цены и остатки.
Частые проблемы
| Симптом | Вероятная причина |
|---|---|
| Площадка отклоняет весь файл | Невалидный XML или отсутствуют обязательные поля |
| Часть товаров не проходит модерацию | Не сопоставлена категория или не заполнены характеристики |
| Цены на площадке отличаются от сайта | Выгружается не тот тип цены или файл не обновляется |
| Товары числятся в наличии, хотя раскуплены | Файл собирается до завершения обмена остатками |
| Файл генерируется очень долго | Экспорт запущен на хитах вместо агента по расписанию |
Итог
Штатный экспорт Битрикс формирует YML-файл без написания кода: достаточно один раз сопоставить категории каталога с категориями площадки, выбрать нужный тип цены и настроить расписание обновления через агента.
Основные ошибки лежат не в технике, а в данных: пустые категории, незаполненные характеристики и рассинхронизация с обменом остатков. Проверять готовый файл стоит так же внимательно, как саму настройку экспорта, — площадка отклоняет не только явно невалидный XML, но и формально корректные товары без нужных полей.