
YML файл в Битрикс используется для передачи структуры каталога и прайс-листов между платформами и маркетплейсами. Его правильная генерация обеспечивает корректную синхронизацию товаров, категорий и цен. Формат файла строго регламентирован, поэтому ошибка в структуре может привести к отказу площадки в обработке данных.
Первый шаг – подготовка инфоблоков и их свойств. Необходимо убедиться, что все товары имеют уникальные идентификаторы, заполнены цены и наличие, а категории соответствуют иерархии. Для удобства рекомендуется использовать встроенные фильтры и пользовательские поля, чтобы выгрузка содержала только актуальные позиции.
Далее настраивается профиль экспорта. В Битрикс нужно выбрать «Маркетплейсы» → «YML-выгрузка» и указать инфоблоки, которые будут включены в файл. Важно корректно настроить соответствие полей: Название товара, Цена, Валюта, Ссылка на изображение, Категория. Ошибки в сопоставлении часто приводят к некорректной генерации файла.
После настройки профиля рекомендуется провести тестовую выгрузку на ограниченном наборе товаров. Это позволяет проверить структуру XML и убедиться в правильности кодировки. При обнаружении несоответствий необходимо скорректировать свойства инфоблоков и параметры экспорта до окончательной генерации YML.
Финальный этап – сохранение и загрузка файла на маркетплейс или внешний ресурс. Оптимально использовать автоматические сценарии обновления, чтобы YML файл регулярно отражал актуальные цены и наличие товаров без ручного вмешательства.
Выгрузка YML файла из Битрикс: пошаговое руководство

Для начала убедитесь, что у вас есть доступ к административной панели Битрикс и права на управление торговым каталогом. YML-файл формируется на основе данных инфоблока с товарами.
Шаг 1. Настройка каталога: Перейдите в Контент → Инфоблоки → Товары. Убедитесь, что для каждого товара заполнены ключевые поля: название, цена, наличие, описание и изображения. Для корректной выгрузки Яндекс.Маркет важны поля vendor, model и vendorCode.
Шаг 2. Создание профиля выгрузки: Перейдите в Маркетинг → Торговые каталоги → Экспорт в YML. Нажмите Добавить профиль. Укажите имя профиля и инфоблок, который будет использоваться для генерации файла.
Шаг 3. Настройка полей YML: В профиле задайте соответствие полей инфоблока стандарту YML. Укажите валюту, категорию, единицы измерения. Если требуется, подключите правила преобразования цен или фильтры по разделам.
Шаг 4. Проверка данных: Используйте кнопку Предварительный просмотр. Убедитесь, что YML формируется без ошибок, все товары имеют категории и корректные цены. Исправьте несоответствия в инфоблоке.
Шаг 5. Выгрузка файла: Нажмите Выгрузить. Файл создается в формате .xml/YML и сохраняется на сервере по указанному пути. Для автоматизации укажите расписание в cron, чтобы выгрузка выполнялась регулярно.
Шаг 6. Проверка и публикация: Откройте YML-файл в текстовом редакторе или через сервис проверки Яндекс.Маркет. Убедитесь, что структура соответствует требованиям: теги offer, price, currencyId присутствуют для каждого товара.
Следуя этим шагам, вы получите корректный YML-файл, готовый к загрузке в маркетплейсы или интеграцию с внешними сервисами. Автоматизация выгрузки позволит поддерживать актуальность каталога без ручного вмешательства.
Настройка параметров инфоблоков для корректной выгрузки
Для корректной выгрузки YML необходимо тщательно настроить инфоблоки в Битрикс, учитывая структуру данных и требования торговых площадок.
-
Проверка структуры инфоблока:
- Убедитесь, что все товары находятся в едином инфоблоке или в логически разделённых инфоблоках для разных категорий.
- Все поля должны соответствовать типу данных: числовые поля для цен и остатков, строковые – для названий и описаний.
- Идентификаторы элементов должны быть уникальными и постоянными.
-
Настройка свойств для YML:
- Создайте обязательные свойства: Цена, Наличие, Артикул, Категория.
- Для изображений используйте тип свойства «Файл», а не «Список», чтобы выгрузка включала прямые ссылки на картинки.
- Свойства для торговых площадок (например, vendor, model) создавайте с типом «Строка» и фиксированными значениями.
-
Управление разделами инфоблока:
- Каждый раздел должен иметь уникальный XML_ID для корректной группировки товаров в YML.
- Разделы следует упорядочить по иерархии категорий торговой площадки, чтобы избежать ошибок при импортировании.
-
Проверка активности и доступности элементов:
- Все товары должны быть активными и иметь хотя бы один доступный склад с положительным остатком.
- Для выгрузки исключайте товары с пустыми ключевыми свойствами (цена, артикул, категория).
-
Настройка формата данных:
- Дата обновления товара должна быть указана в формате ISO 8601 (YYYY-MM-DDThh:mm:ss).
- Цены и остатки – без лишних символов и с точной конвертацией валют, если требуется.
- Для корректной работы Яндекс.Маркет и других площадок указывайте валюту через свойство currency (например, RUB).
После настройки инфоблоков рекомендуется протестировать выгрузку на выборке товаров, чтобы убедиться в правильности структуры YML и отсутствии ошибок при импорте на торговую площадку.
Выбор формата и структуры YML в Битрикс

Перед экспортом товаров важно определить оптимальный формат YML и структуру файла, чтобы обеспечить корректную загрузку в маркетплейсы и прайс-агрегаторы.
Основные параметры выбора формата YML в Битрикс:
- Версия YML: стандартная версия 1.0 подходит для большинства платформ, версия 2.0 используется для маркетплейсов с расширенными требованиями к описанию товаров и наличию дополнительных параметров.
- Кодировка: UTF-8 обязательна для корректного отображения кириллицы и специальных символов.
- Разделители: при экспорте CSV-параметров в YML следует использовать запятую для совместимости с внешними системами.
Структура YML формируется на основе иерархии каталога:
- Категории: создаются элементы <category> с уникальными id и ссылкой на родительскую категорию (parentId), если она существует.
- Товары: экспортируются в <offer> с обязательными атрибутами: id, available, url, price, currencyId, categoryId, name.
- Дополнительные параметры: можно указывать <vendor>, <model>, <picture>, <description>, <param> для соответствия требованиям маркетплейсов.
Рекомендации по структуре YML в Битрикс:
- Поддерживать строгую иерархию категорий, избегая дублирующихся названий.
- Сохранять единый формат цен и валют для всех товаров.
- Для каждого товара использовать уникальный ID и корректные ссылки на изображения.
- При необходимости добавлять пользовательские параметры через <param> с указанием unit, если требуется измерение.
Следуя этим рекомендациям, YML-файл будет корректно обрабатываться внешними сервисами, минимизируя ошибки при загрузке товаров и ускоряя обновление прайс-листов.
Создание профиля экспорта в модуле «Обмен данными»

Перейдите в раздел «Настройки» → «Обмен данными» → «Профили». Нажмите кнопку «Добавить профиль». В поле «Название профиля» укажите уникальное имя, отражающее цель выгрузки, например «Экспорт YML для Яндекс.Маркет». Выберите тип выгрузки: «YML».
В блоке «Настройки источника данных» выберите инфоблок, содержащий товары. Укажите разделы и свойства, которые необходимо экспортировать. Для атрибутов, обязательных для YML, отметьте: название, цена, валюта, наличие, ссылка на изображение. Остальные свойства добавляйте только при необходимости, чтобы не увеличивать размер файла.
В разделе «Настройки файла» укажите путь сохранения и имя файла, например /upload/yml/export_yml.xml. Выберите кодировку UTF-8. Для больших каталогов активируйте опцию «Разбивать файл на части» и установите лимит в 1000 товаров на файл.
В блоке «Настройки выгрузки» укажите режим: «Полная» или «При изменениях». Для регулярного обновления YML используйте «При изменениях» и настройте периодичность cron-задач через планировщик сервера. Укажите URL, с которого внешние системы будут забирать файл.
Нажмите «Сохранить профиль» и выполните тестовую выгрузку. Проверьте корректность структуры YML и наличие всех обязательных тегов:
Проверка соответствия полей товаров требованиям YML

Перед выгрузкой YML необходимо убедиться, что все поля товаров соответствуют требованиям Яндекс.Маркет. Поля id, name, price, currencyId, categoryId обязательны. Их отсутствие приведет к ошибкам при загрузке.
Поле id должно быть уникальным и числовым. Используйте внутренний код товара из Битрикс или генерацию уникальных числовых идентификаторов. name ограничен 128 символами, запрещены HTML-теги и управляющие символы.
Цена price указывается в числовом формате без пробелов и разделителей тысяч. currencyId поддерживает только коды ISO 4217 (RUB, USD, EUR). Поле categoryId должно ссылаться на существующую категорию, идентификатор которой совпадает с указанием в categories блока YML.
Для полей vendor и vendorCode проверьте соответствие названий брендов официальной номенклатуре. description должен быть не более 5000 символов, без специальных тегов и скриптов. Поле picture требует ссылку на изображение в формате JPEG или PNG, размер файла не более 5 МБ.
Дополнительные атрибуты, такие как model, param и sales_notes, проверяются на соответствие справочникам Яндекс.Маркет. param должен содержать только числовые или текстовые значения, совместимые с указанным name.
Используйте модуль проверки в Битрикс или сторонние скрипты, чтобы автоматически сверять все обязательные поля и предупреждать о несоответствиях. Обязательно экспортируйте тестовый YML и загрузите в Яндекс.Маркет через тестовый режим, чтобы выявить ошибки до массовой выгрузки.
Запуск выгрузки и сохранение YML файла на сервере

Для запуска выгрузки откройте административную панель Битрикс и перейдите в раздел «Маркетинг» → «Yandex.Маркет». Выберите нужный инфоблок и нажмите «Выгрузить». В появившемся окне убедитесь, что выбраны все необходимые поля: название, цена, наличие, категория, описание, изображения.
Установите формат файла YML и укажите путь на сервере, где он будет сохранён. Рекомендуется использовать отдельную папку, например: /upload/yml/, чтобы избежать перезаписи других данных. Имя файла указывайте без пробелов и специальных символов, например: export_2025_09_03.yml.
Перед запуском убедитесь, что у папки на сервере выставлены права записи (CHMOD 755 или 777, если необходимо). Проверьте ограничение по размеру файлов на сервере, чтобы выгрузка больших каталoгов не обрывалась.
Нажмите кнопку «Запустить выгрузку». В процессе формирования файла Битрикс отображает прогресс по количеству обработанных товаров. Для крупных каталогов рекомендуется запускать выгрузку через консольный скрипт, чтобы избежать тайм-аутов веб-сервера.
После завершения выгрузки убедитесь, что YML файл доступен по указанному пути. Проверьте корректность структуры, открыв файл в любом текстовом редакторе или через встроенный Yandex Validator. При обнаружении ошибок исправьте соответствующие поля в инфоблоке и повторите выгрузку.
Для автоматизации регулярной выгрузки настройте cron-задание на сервере, указывая команду консольного скрипта Битрикс с параметрами инфоблока и пути сохранения YML. Это обеспечит актуальность данных без ручного запуска.
Отладка ошибок при генерации YML и повторная выгрузка
При формировании YML в Битрикс часто возникают ошибки, связанные с некорректными данными в карточках товаров. Проверяйте заполненность обязательных полей: название, ID, валюта, цена, ссылка. Отсутствие хотя бы одного значения приведёт к пропуску позиции в выгрузке.
Ошибки кодировки встречаются при использовании нестандартных символов в описаниях. Для проверки откройте сгенерированный файл в редакторе и убедитесь, что он сохранён в UTF-8 без BOM. Несовпадение кодировки вызывает сбои при обработке прайс-агрегаторами.
Если в YML попадают устаревшие данные, очистите кэш модуля и запустите генерацию вручную через Настройки → Инструменты → Генерация YML. После перегенерации сравните дату и время последнего файла в каталоге /upload/yml с текущими.
При большом каталоге выгрузка может обрываться из-за лимита по времени выполнения скрипта. В этом случае увеличьте значение max_execution_time в php.ini или настройте пошаговую генерацию через агент в Битрикс. Это позволит формировать файл частями без потери данных.
Перед повторной выгрузкой проверьте логи ошибок PHP и модулей в административной панели. Любая строка с предупреждением поможет определить источник проблемы – например, отсутствующий артикул или неверный тип цены. После исправления запустите генерацию повторно и откройте файл в браузере для проверки структуры XML.
Вопрос-ответ:
Как найти функцию выгрузки YML в Битриксе?
В административной панели откройте раздел «Магазин» → «Настройки» → «Экспорт данных». Там обычно уже доступен преднастроенный профиль для выгрузки в Яндекс.Маркет. Его можно отредактировать или создать новый, указав формат YML.
Нужно ли вручную обновлять YML файл каждый раз?
Нет, это необязательно. В Битриксе есть возможность настроить автоматическую генерацию файла по расписанию через cron. Тогда система будет создавать новый YML файл в указанное время, и вам не придётся выгружать его вручную.
Файл слишком большой, и выгрузка прерывается. Что делать?
Частая причина — ограничение по времени выполнения скриптов на сервере. Попробуйте включить пошаговую генерацию файла и настройте выгрузку по частям. Также стоит проверить лимиты PHP и обсудить с хостинг-провайдером возможность их увеличения.
Как добавить дополнительные поля в YML, например, бренд или артикул?
В профиле экспорта можно задать соответствие между полями каталога и тегами YML. Для этого укажите, какие свойства товаров должны использоваться для формирования нужных атрибутов. Если какого-то свойства нет, его можно создать в карточке товара и потом связать с нужным тегом.
Куда сохраняется готовый YML файл и как его передать на Яндекс.Маркет?
После генерации файл доступен по ссылке на вашем сайте, обычно в папке /upload/. Эту ссылку необходимо вставить в личном кабинете Яндекс.Маркета при настройке прайс-листа. Тогда площадка будет регулярно загружать файл напрямую с вашего сервера.
Как правильно выгрузить YML-файл из Битрикс для загрузки товаров на маркетплейс?
Для начала в административной панели перейдите в раздел «Магазин» → «Экспорт данных» → «YML (Яндекс.Маркет)». Там нужно создать новый профиль экспорта. Укажите название профиля, выберите каталог, из которого будут браться товары, и задайте условия фильтрации — например, исключите товары без цен или без фотографий. Далее настройте параметры: валюты, категории и формат описания. После сохранения профиля у вас появится ссылка на сформированный YML-файл. Эту ссылку вы можете передать маркетплейсу для автоматического обновления ассортимента.
