Выгрузка товаров в Яндекс Маркет в Битрикс: рабочие приёмы

Выгрузка из Битрикс в Яндекс Маркет может формально завершаться без ошибок, но при этом часть товаров не появляется на площадке, варианты объединяются неверно, а цена в фиде расходится с карточкой магазина. В материале для 1С-Битрикс: Управление сайтом 24.x–25.x разберём три рабочих подхода: встроенный экспорт, отдельный XML-фид и интеграцию через готовый модуль. Главный критерий — не сам факт создания файла, а совпадение цены, наличия и структуры товара после обновления.

Сначала определите, что именно вы выгружаете

У Яндекс Маркета есть два разных сценария. Магазин может передавать каталог для размещения предложений на Маркете или загружать ассортимент в кабинете продавца. Во втором случае важны не только товарные данные, но и остатки по складам, идентификаторы, статусы заказов и правила самой модели продаж.

В Битрикс обычно выгружают XML-фид с предложениями. Он содержит товары, цены, ссылки, изображения, остатки и дополнительные параметры. Маркет забирает этот файл по URL или получает его через настроенную интеграцию. Поэтому проверять нужно не страницу товара в Битрикс, а итоговый XML, который видит внешняя система.

Ниже подразумевается стандартный экспорт из Битрикс. Названия разделов зависят от редакции и установленных модулей: ищите настройки по словам «Яндекс.Маркет», «экспорт» или «торговые каталоги». Обновления интерфейса для 24.x и 25.x могут менять расположение пунктов, но логика остаётся той же.

Три подхода к выгрузке

Для первого запуска выбирайте встроенный экспорт. Переходить к модулю стоит, когда проблема уже сформулирована: например, нужно передавать остатки из нескольких складов или разделять цены для разных каналов. Отдельный фид оправдан, если правила отбора товаров невозможно выразить штатными настройками.

Рабочая выгрузка — это не файл без ошибок XML. Это согласованный контракт между каталогом Битрикс и правилами Маркета: один товар, одна цена, понятный остаток и корректная ссылка.

Практика: как настроить встроенный экспорт

1. Проверьте основу каталога

1. Определите инфоблок каталога. У товара должны быть заполнены название, активность, ссылка, основная картинка и цена нужного типа. Если каталог использует торговые предложения, проверьте не только родительский товар, но и каждое предложение. Проверка: откройте несколько URL из будущей выгрузки без авторизации и убедитесь, что страницы отдаются с кодом 200.
2. Проверьте структуру вариантов. Размер, цвет, объём и другие характеристики должны храниться в свойствах торговых предложений, а не только в описании родительского товара. Проверка: у двух вариантов одного товара должны отличаться собственные значения и, если требуется, артикулы.
3. Настройте цены. Выберите тот тип цены, который действительно должен видеть покупатель Маркета. Учитывайте скидки, валюту и правила округления. Проверка: сравните цену в админке, на открытой карточке и в тестовом XML для одного и того же предложения.
4. Проверьте остатки. Решите, что означает нулевой остаток: исключение предложения из фида или передача товара как временно недоступного. Не смешивайте складской остаток и ручное поле «в наличии». Проверка: измените остаток у тестового товара и убедитесь, что после обновления фида меняется именно нужный атрибут.
5. Настройте отбор. Исключите скрытые, архивные, тестовые и недоступные для заказа товары. Отдельно проверьте товары без картинки, цены, категории и обязательных характеристик. Проверка: число предложений в фиде соответствует числу реально продаваемых позиций, а не всему инфоблоку.
6. Заполните параметры доставки. Укажите регион, способы и сроки доставки там, где это предусмотрено вашей схемой подключения. Если доставка рассчитывается индивидуально, не подставляйте универсальное значение во все товары. Проверка: в настройках Маркета нет предупреждения о неполных данных по региону или доставке.
7. Сохраните URL фида и включите обновление. Сначала запустите ручное формирование, затем настройте регулярное задание на сервере или штатное расписание. Проверка: время изменения XML меняется после запуска, а журнал Битрикс не содержит ошибки генерации.

Что проверять в самом XML

Откройте фид в браузере или скачайте его на рабочий компьютер. XML должен быть корректно закрыт и содержать только разрешённые для Маркета значения. Для выборочной проверки достаточно взять пять товаров из разных категорий, один товар с вариантами, позицию со скидкой и товар с нулевым остатком.

• ссылка ведёт на правильный домен, протокол и карточку товара;
• название не подменилось названием раздела или внутренним кодом;
• цена и старая цена соответствуют правилам скидки;
• изображение доступно без авторизации и не возвращает ошибку;
• артикул уникален там, где Маркет использует его для различения предложений;
• варианты не склеились в одну позицию и не превратились в набор не связанных товаров.

XML-фид — это машинно читаемый файл с описанием ассортимента. [1] Для человека он выглядит как набор тегов, но Маркет воспринимает каждое поле буквально: пустой остаток и отсутствие поля — разные состояния.

Как избежать типичных ошибок

Цена в фиде отличается от цены на сайте

Чаще всего экспорт использует другой тип цены, не учитывает скидку или получает цену до применения правил корзины. Сравните настройки экспорта с конкретным предложением, а затем проверьте, не меняется ли цена только после авторизации. Если цена зависит от группы пользователя, заранее определите, какую группу должен видеть Маркет.

Товар есть в Битрикс, но его нет на Маркете

Проверьте активность товара и раздела, наличие цены, картинки, остатка и попадание в выбранный отбор. Затем найдите товар в XML по артикулу или URL. Если его нет в файле, проблема в Битрикс; если он есть, но отклонён, смотрите причину в кабинете Маркета.

Варианты объединяются неправильно

Так происходит, когда у предложений нет различающего признака или одинаковый идентификатор используется для нескольких вариантов. Храните цвет, размер и другие характеристики на уровне торгового предложения, а не только в общем описании. После исправления проверяйте не одну карточку, а группу из нескольких вариантов.

Фид формируется слишком долго

Полный экспорт на большом каталоге может нагружать PHP и базу данных. Не запускайте его одновременно с тяжёлыми обменами, индексацией и резервным копированием. Если штатный экспорт не укладывается в доступное время, измерьте длительность генерации, объём XML, нагрузку на базу и число предложений; после этого выбирайте отдельный фид или модуль, а не меняйте настройки вслепую.

Когда какой вариант выбирать

Оставляйте встроенный экспорт, если у вас один каталог, одна основная цена и понятный источник остатков. Готовый модуль нужен, когда важна двусторонняя интеграция, несколько складов или автоматическая синхронизация с кабинетом продавца. Отдельный фид выбирайте только при наличии собственной логики: например, разные наборы товаров для нескольких регионов или сложный расчёт доступности.

Не пытайтесь решить настройкой выгрузки проблему грязного каталога. Если в Битрикс дублируются артикулы, не заполнены свойства или остатки обновляются с задержкой, любой способ передачи будет публиковать те же ошибки, только быстрее.

Где подход ломается

Штатная схема плохо подходит для каталога, где цена рассчитывается в реальном времени, а остатки приходят из нескольких систем с разной периодичностью. Она также не заменяет проверку после обновления: успешная генерация XML не означает, что Маркет принял каждое предложение.

Отдельно учитывайте кеширование. Страница товара может уже показывать новую цену, а фид — старую версию, если результат экспорта или данные каталога закешированы. При расследовании фиксируйте время генерации, URL, артикул и фактические значения в XML. Инвалидация кеша — отдельная тема; здесь важна только проверка, что фид и карточка используют одинаковые данные.

Что делать дальше

После запуска соберите небольшой контрольный набор из 10–20 товаров: обычный товар, варианты, скидка, нулевой остаток, новая позиция и товар с несколькими изображениями. Раз в день проверяйте их в XML и в кабинете Маркета, а после изменения каталога повторяйте проверку вручную.

На продакшене следите за четырьмя показателями: временем генерации фида, временем его обновления на Маркете, числом отклонённых предложений и расхождениями цен. Когда один из них меняется, сначала сравнивайте исходные данные Битрикс с итоговым XML, а уже потом ищите проблему в настройках площадки.