Справочники и Данные · 10 мин
Как выгружать справочники из 1С в 1С-Битрикс
Как выгружать справочники из 1С в 1С-Битрикс: настройка типового обмена, CommerceML, сопоставление полей, проверка результата и типичные ошибки.
Выгрузка справочников из 1С в 1С-Битрикс — стандартная задача интеграции учётной системы с сайтом. Под справочниками здесь обычно понимают номенклатуру, контрагентов, склады, виды цен, единицы измерения и пользовательские справочники, созданные под нужды компании. Корректная выгрузка означает, что на сайте появляются те же товары, свойства и структура каталога, что и в учётной системе, без дублей и потери данных.
Основной механизм передачи данных — типовой обмен через формат CommerceML, который поддерживается как со стороны конфигураций 1С (Управление торговлей, Комплексная автоматизация, ERP, УНФ), так и со стороны модуля интернет-магазина в Битрикс. В статье разобраны подготовка данных, настройка узла обмена, сопоставление полей, проверка результата и типичные ошибки, из-за которых справочники выгружаются не полностью или с искажениями.
Что именно можно выгрузить как справочник
В типовом обмене справочники превращаются в сущности каталога Битрикс. Номенклатура становится товарами инфоблока, иерархические группы номенклатуры — разделами каталога, дополнительные реквизиты и сведения — свойствами товаров, виды цен — типами цен, склады — складами в модуле складского учёта.
Контрагенты при обмене заказами выгружаются как профили покупателей. Пользовательские справочники (например, «Бренды» или «Коллекции») типовой обмен напрямую не передаёт: их данные обычно выносят в дополнительные реквизиты номенклатуры либо передают через доработанный обмен, если требуется отдельный справочник на стороне сайта.
Подготовка данных в 1С перед выгрузкой
Качество выгрузки определяется состоянием справочников в 1С. Перед настройкой обмена проверьте, что у номенклатуры заполнены наименования, указаны единицы измерения, назначены группы и нет массовых дублей. Дубли после выгрузки превратятся в дубли товаров на сайте, и чистить их там заметно сложнее.
Отдельно проверьте дополнительные реквизиты и сведения: именно они станут свойствами товаров. Если один и тот же смысл задан двумя разными реквизитами (например, «Цвет» и «Цвет товара»), на сайте появятся два свойства, что усложнит фильтрацию. Приведите реквизиты к единому набору до первой полной выгрузки.
Убедитесь, что у пользователя, под которым выполняется обмен, есть права на чтение всех выгружаемых справочников и на выполнение обмена данными с сайтом. Недостаток прав — частая причина «пустых» файлов выгрузки без видимых ошибок.
Настройка узла обмена с сайтом в 1С
В типовых конфигурациях обмен настраивается через раздел интеграции с сайтом: «Администрирование» → «Обмен с сайтами» (в УТ 11 и КА) или «Синхронизация данных» → «Обмен с сайтом» в других конфигурациях. Создаётся новый узел обмена, в котором указывается адрес скрипта обмена на сайте вида https://сайт/bitrix/admin/1c_exchange.php, логин и пароль пользователя Битрикс с правами на обмен.
На вкладке выгрузки товаров задаётся отбор: какие группы номенклатуры, склады и виды цен участвуют в обмене. Здесь же настраивается соответствие полей: какой реквизит 1С передаётся в какое свойство инфоблока. Если соответствие не задано, Битрикс создаст свойства автоматически по именам реквизитов — это допустимо на старте, но затрудняет управление каталогом в дальнейшем.
Доступны два режима: полная выгрузка и выгрузка изменений. Первый запуск всегда полный, далее разумно переключаться на обмен изменениями, чтобы не гонять по сети весь каталог при каждом сеансе.
- 1Создайте в Битрикс пользователя с правами на выполнение обмена с 1С
- 2В 1С создайте узел обмена с сайтом и укажите адрес скрипта обмена
- 3Проверьте соединение кнопкой тестирования подключения
- 4Настройте отбор номенклатуры, складов и видов цен
- 5Задайте соответствие реквизитов 1С свойствам инфоблока
- 6Выполните пробную выгрузку малой группы товаров и проверьте результат
- 7Запустите полную выгрузку и включите расписание обмена изменениями
Настройка приёма данных на стороне Битрикс
В административном разделе Битрикс настройки интеграции находятся в разделе «Магазин» → «Интеграция с 1С». Здесь указывается, в какой инфоблок загружать каталог, какие типы цен и склады создавать, а также поведение при отсутствии товара в файле выгрузки: деактивировать, удалить или оставить без изменений.
Обратите особое внимание на параметр действия с элементами, которых нет в выгрузке. Значение «удалить» опасно: любая ошибка в отборе на стороне 1С приведёт к удалению части каталога. Безопасный вариант на этапе запуска — «деактивировать» или «ничего не делать» с последующей ручной разборкой.
Также проверьте ограничения хостинга: максимальное время выполнения скрипта, лимит памяти и размер загружаемых файлов. Большие каталоги обмен передаёт порциями, и при жёстких лимитах сеанс может обрываться на середине.
Выгрузка нестандартных справочников и свойств
Типовой обмен покрывает номенклатуру, цены, остатки и контрагентов, но не умеет передавать произвольные справочники 1С как самостоятельные сущности сайта. Если нужен, например, отдельный справочник брендов с логотипами и описаниями, есть три практических пути.
Первый — передать значения справочника как дополнительный реквизит номенклатуры, а на сайте настроить свойство типа «справочник» (highload-блок) и заполнить его обработкой или импортом. Второй — доработать обмен на стороне 1С, добавив свои XML-блоки, и написать обработчик на стороне Битрикс. Третий — использовать готовые модули расширенной интеграции из маркетплейса, которые поддерживают выгрузку дополнительных сущностей.
Способы передать нестандартный справочник
Быстро и без доработок, но справочник живёт только как свойство товара, без собственных полей и картинок
Полный контроль над структурой, но требует разработчика 1С и Битрикс и усложняет обновления
Готовая поддержка дополнительных сущностей, но зависимость от стороннего решения и его стоимости
Проверка результата выгрузки
После первой выгрузки сверьте ключевые показатели: количество товаров в инфоблоке против количества позиций в отборе 1С, полноту дерева разделов, наличие цен и остатков у произвольной выборки товаров. Проверьте, что свойства заполнены теми значениями, что заданы в реквизитах 1С, а типы свойств соответствуют замыслу (список, строка, число).
Откройте журнал обмена в 1С и логи на стороне сайта. Сообщения вида «не удалось записать элемент» или ошибки авторизации указывают на конкретные проблемы: права, дубли уникальных кодов, обрывы соединения. Повторная выгрузка после исправления должна пройти без новых записей об ошибках.
Как проверить результат
Совпадает с числом позиций в отборе 1С с учётом вариаций
Существенно меньше или появились дубли одного товара
Дерево каталога повторяет иерархию групп номенклатуры
Все товары свалились в корень или в один раздел
Значения реквизитов попали в правильные свойства с верным типом
Созданы дублирующие свойства или значения попали в строковое поле вместо списка
У тестовых товаров цены и остатки совпадают с 1С
Цены нулевые, остатки пустые, тип цены не тот
Типичные ошибки и их последствия
Самая частая проблема — дубли товаров после повторных выгрузок. Она возникает, когда меняется принцип формирования внешнего кода (XML_ID) или каталог на сайте создавался вручную до интеграции. Лечится приведением каталога к единому источнику истины — 1С — и очисткой ручных дублей.
Вторая группа ошибок связана с правами и лимитами: обмен стартует, передаёт часть данных и молча обрывается. Признаки — недогруженные картинки, частично заполненные свойства. Проверяйте логи, увеличивайте таймауты, уменьшайте размер порции.
FAQ: частые вопросы о выгрузке справочников в Битрикс
Можно ли выгрузить справочник из 1С в Битрикс без типового обмена?
Да. Для разовой задачи подойдёт выгрузка в CSV или Excel из 1С и импорт в инфоблок штатными средствами Битрикс. Для регулярной синхронизации разовый импорт не подходит: нужен либо типовой обмен, либо доработанная интеграция через REST API Битрикс.
Почему после выгрузки товары есть, а картинок нет?
Изображения передаются отдельными файлами, и их загрузка чувствительна к лимитам сервера и правам на папку upload. Проверьте, что у номенклатуры в 1С картинки реально прикреплены, а на сервере хватает места и не обрывается сеанс по таймауту. Повторная выгрузка с уменьшенной порцией обычно догружает недостающие файлы.
Как выгрузить только часть номенклатуры, а не весь справочник?
В настройках узла обмена в 1С есть механизм отбора: по группам, по условиям на реквизиты, по сегментам. Настройте отбор так, чтобы в выгрузку попадала только нужная часть справочника, и проверьте состав выгрузки кнопкой просмотра отобранных данных до запуска.
Что делать, если в Битрикс создаются дубли свойств при каждом обмене?
Обычно причина в том, что в 1С есть несколько реквизитов с похожими именами или реквизит переименовали после первой выгрузки. Свойства на сайте связываются с реквизитами по внешнему коду, и при расхождении создаются новые. Приведите реквизиты в 1С к единому набору, удалите лишние свойства на сайте и выполните полную выгрузку заново.
Можно ли выгружать справочники по расписанию автоматически?
Да. В 1С настраивается регламентное задание обмена с сайтом с нужной периодичностью. Для стабильной работы используйте режим выгрузки изменений, следите за логами и настройте уведомления об ошибках обмена, чтобы узнавать о сбоях сразу, а не от менеджеров магазина.
Что важно запомнить
Выгрузка справочников из 1С в Битрикс строится на типовом обмене CommerceML: чистые данные в 1С, корректный узел обмена, аккуратные настройки приёма на сайте и обязательная пробная выгрузка на малой выборке. Режим удаления отсутствующих товаров включайте только после стабилизации обмена, а нестандартные справочники передавайте через реквизиты, доработку или специализированные модули.