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

Штатные компоненты 1С-Битрикс принимают каталог по протоколу CommerceML, а настройки магазина позволяют управлять импортом каталога и обменом заказами. Конкретные возможности зависят от конфигурации 1С, версии модуля обмена и редакции сайта. Поэтому работу начинают не с включения расписания, а с карты данных и тестового сценария.

Схема двустороннего обмена товарами, ценами, остатками и заказами между интернет-магазином и учётной системой
Направления обмена определяют отдельно для товарных данных и заказов.

Какие данные передаются между сайтом и 1С

НаправлениеЧто обычно передаётсяЧто нужно согласовать
Из 1С на сайтРазделы, товары, торговые предложения, свойства, цены, остатки, изображенияИсточник каждого поля, типы цен, склады, единицы измерения, характеристики
С сайта в 1СЗаказы, состав корзины, покупатель или контрагент, доставка, оплата, комментарийМомент передачи, поиск дублей, соответствие статусов, изменение заказа после выгрузки
Из 1С на сайт после обработки заказаСтатус, изменения состава и суммы, сведения об оплате или отгрузке — если это предусмотрено схемойКакая система управляет заказом после передачи и какие изменения разрешены

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

Выгрузка заказов из Битрикс в 1С строится по одной из трёх моделей. Заказ обрабатывают на сайте и передают в 1С уже отработанным, обрабатывают в 1С сразу после создания или используют смешанную схему с передачей при переходе в заданный статус. Это не означает, что все поля заработают автоматически в конкретной базе — соответствия всё равно нужно проверить.

С какими конфигурациями 1С работает типовой обмен

Для актуальных релизов торговых конфигураций 1С 1С-Битрикс выпускает собственные модули обмена. Они бесплатные и устанавливаются в 1С по инструкции из дистрибутива. На 10 октября 2026 года в официальном перечне для России есть модули для таких конфигураций:

  • «Управление торговлей» (1С:УТ) редакции 11.5;
  • «Управление нашей фирмой» (1С:УНФ) редакции 3.0;
  • «ERP Управление предприятием 2»;
  • «Комплексная автоматизация» редакции 2;
  • «Розница» редакции 2.3.

Отдельные версии модулей выпущены для Беларуси и Казахстана. Каждый модуль привязан к релизу конфигурации, поэтому обмен с сайтом 1С:УТ 11.5 или 1С:УНФ зависит не только от названия программы, но и от номера релиза в вашей базе.

1С-Битрикс считает УТ 10.3 неактуальной. Старые версии модуля обмена для неё использовать можно, но их развитие и исправление ошибок прекращены. Если магазин работает на такой базе, обмен 1С-Битрикс с 1С:УТ стоит обсуждать вместе с планом перехода на актуальную редакцию.

Для 1С:УНФ есть своя особенность. По информации издания фирмы «1С», начиная с версии 3.0.12 прежний механизм «Обмен с сайтом» автоматически заменяется обновлённым «Интернет-магазин». Поэтому раздел настроек в вашей базе может называться иначе, чем в старых инструкциях.

На стороне сайта важна редакция. Обмен с 1С в «1С-Битрикс: Управление сайтом» настраивают через форму интеграции интернет-магазина, а в редакциях «Старт» и «Стандарт» она недоступна.

Релиз базы и редакцию сайта сверяют до начала работ.

Как работает типовой обмен 1С с сайтом на Битрикс

1С обменивается с сайтом на 1С-Битрикс по протоколу CommerceML. Сайт и учётная система работают независимо, и инициатор соединения всегда 1С: она обращается к служебной странице обмена на сайте, а сайт прямого доступа к базе 1С не имеет. Выгрузка каталога проходит четыре этапа.

  1. Авторизация. 1С входит на сайт под пользователем обмена.
  2. Инициализация. Сайт сообщает, принимает ли он zip-архивы и какой размер файла допустим. Здесь же согласуется версия CommerceML.
  3. Передача файлов обмена. 1С отправляет XML-файлы частями. Обычно основных файлов два: каталог (import) и торговые предложения (offers). Изображения передаются отдельными файлами.
  4. Импорт. 1С опрашивает сайт, пока тот не ответит, что файл обработан. Большие выгрузки Битрикс разбирает шагами и обновляет инфоблок, торговый каталог, цены и остатки.

На любом этапе сайт может ответить ошибкой или не ответить вовсе. Для 1С это значит, что файл не доставлен или не обработан, и ответ сервера она показывает в своём сообщении об ошибке. Ещё одна деталь важна до первого запуска: при полной выгрузке после успешного импорта сайт деактивирует товары, которых не было в файле.

Схема этапов обмена 1С с сайтом на 1С-Битрикс: авторизация, инициализация, передача файлов, импорт шагами и обмен заказами, с веткой ошибки 1С запускает обмен вручную или по расписанию. После авторизации пользователя обмена сайт на этапе инициализации сообщает, принимает ли zip и допустимый размер файла. Затем 1С передаёт файлы частями, сайт импортирует их шагами и повторяет шаг, пока импорт не закончен. Если обмен заказами настроен, 1С забирает файл с новыми заказами, иначе обмен завершается. Неверный логин, неполученные параметры, непринятый файл, ошибка импорта или неполученные заказы ведут к ошибке: 1С показывает ответ сервера, администратор обмена разбирает сообщение 1С, логи сервера и таблицу ошибок и повторяет запуск на тестовой копии. 1С запускает обмен (вручную или по расписанию) запрос Авторизация пользователя обмена на сайте доступ разрешён Инициализация сайт сообщает, принимает ли zip и допустимый размер файла параметры получены Передача файлов обмена частями (XML, изображения) файлы приняты Импорт шагами каталог, цены, остатки шаг не закончен, повтор импорт завершён, обмен заказами настроен импорт завершён, обмен заказами не настроен Обмен заказами 1С забирает с сайта файл с новыми заказами изменения из 1С — если включено файл заказов получен Обмен завершён проверить контрольные позиции и заказ неверный логин или нет прав параметры не получены файл не принят ошибка импорта заказы не получены Ошибка или пустой ответ 1С показывает ответ сервера, обмен не завершён администратор обмена Разбор по сообщению 1С, логам сервера и таблице ошибок, повторный запуск на тестовой копии
Этапы типового обмена 1С с сайтом на 1С-Битрикс: импорт идёт шагами, заказы передаются отдельной веткой, при сбое 1С показывает ответ сервера.

Обмен заказами Битрикс с 1С идёт отдельным сценарием. 1С так же авторизуется, а затем забирает с сайта XML-файл с новыми заказами. Изменения заказа, сделанные в 1С, возвращаются на сайт, если это включено в настройках. В профиле задают, заказы какого сайта выгружать, какие статусы учитывать и как обрабатывать изменения. Запуск может выполняться вручную, по расписанию или другим способом, который поддерживает установленный модуль и конфигурация.

Штатный механизм удобен, когда структура данных укладывается в CommerceML и стандартные сущности магазина. Если бизнес использует необычные справочники, несколько учётных систем или собственный порядок резервирования, поверх типового обмена может потребоваться доработка или отдельный API.

Что определить до первой настройки

  1. Какая система является источником истины. Например, название и остаток меняются только в 1С, а SEO-описание и фотографии — только на сайте.
  2. Какие сущности участвуют. Товары, предложения, склады, типы цен, единицы, контрагенты, заказы, оплаты и отгрузки.
  3. Как связаны идентификаторы. Нельзя надёжно сопоставлять товары только по названию: оно меняется и может повторяться.
  4. Когда передаётся заказ. Сразу после оформления, после оплаты, после проверки менеджером или при переходе в определённый статус.
  5. Кто может менять заказ после передачи. Иначе менеджер исправит состав в 1С, покупатель — на сайте, а следующий обмен перезапишет изменения.
  6. Как часто нужны обновления. Расписание зависит от объёма каталога, частоты изменения остатков и допустимой задержки.

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

Модуль обмена Битрикс с 1С и его настройка

Модуль обмена 1С с сайтом состоит из двух половин. В 1С это модуль или встроенный механизм конфигурации, где описан узел обмена. На сайте это модуль интернет-магазина со служебным скриптом, который принимает запросы. Поэтому настройка обмена 1С с сайтом всегда затрагивает обе стороны.

Что настраивают на стороне 1С

В 1С создают узел обмена с сайтом. Названия разделов зависят от конфигурации и релиза, но состав настроек похож:

  • адрес служебного скрипта обмена на сайте, обычно /bitrix/admin/1c_exchange.php;
  • логин и пароль пользователя сайта, от имени которого идёт обмен, с проверкой соединения;
  • режим: выгрузка товаров, обмен заказами или оба сразу;
  • что выгружать: каталоги и группы, типы цен, склады, изображения и файлы;
  • выгрузка только изменённых данных;
  • расписание автоматического обмена.

Узлов может быть несколько, например для разных каталогов.

Что настраивают на стороне сайта

На сайте параметры задают в форме «Интеграция с 1С»: Магазин > Настройки > Интеграция с 1С. В некоторых версиях административной панели пункт называется «Настройки магазина». У формы четыре закладки: «Каталог», «Экспорт каталога», «Заказы» и «Профили обмена». Настроить обмен 1С с сайтом удобнее в таком порядке, на тестовой копии:

  1. Пользователь и группа. Создать отдельного пользователя для обмена в своей группе и разрешить загрузку каталога и выгрузку заказов только этой группе. Учётную запись администратора для обмена лучше не использовать.
  2. Каталог. Выбрать тип инфоблока и решить, хранить ли торговые предложения в отдельном инфоблоке.
  3. Типы цен. В 1С выбрать выгружаемые типы, на сайте проверить, куда они попадают и каким группам покупателей видны. Опция «Не менять код (название) типа цены, если используется внешний код (XML_ID)» сохраняет названия типов цен, заданные на сайте.
  4. Шаг и размер файла. Задать интервал шага и размер части файла, подробнее об этом в разделе о больших выгрузках.
  5. Отсутствующие элементы и символьные коды. Выбрать, что делать с товарами и группами, которых нет в файле импорта: удалить, ничего не делать или деактивировать. Там же включают или выключают транслитерацию символьного кода при добавлении и при обновлении. От этих настроек зависят адреса страниц товаров.
  6. Заказы. На закладке «Заказы» указать сайт и статус, начиная с которого заказы выгружаются, при необходимости включить выгрузку только оплаченных заказов и смену статусов по информации из 1С. Поля для каждого типа плательщика задают на закладке «Профили обмена».
  7. Пробный обмен. Запустить обмен на тестовой копии и проверить сообщения в 1С и логи сервера.

Безопасный порядок запуска обмена

  1. Проверить версии и совместимость. Фиксируют конфигурацию и релиз 1С, редакцию и версию Битрикс, установленный модуль обмена и доступные обновления. После обновления ядра или модулей обмен проверяют повторно, порядок описан в статье о безопасном обновлении 1С-Битрикс.
  2. Сделать резервные копии. Нужны актуальная копия базы 1С и сайта, а также понятный порядок восстановления.
  3. Настроить тестовую среду. Первую выгрузку не запускают сразу на рабочем каталоге, особенно если на сайте уже есть товары и заказы.
  4. Проверить небольшой набор данных. Несколько товаров с характеристиками, разными ценами, остатками, изображениями и единицами измерения показывают большую часть проблем.
  5. Согласовать результат. Проверяют карточки, фильтры, наличие, цены и поведение заказа на контрольном сценарии.
  6. Выполнить полную выгрузку. После неё сравнивают количество сущностей, журнал ошибок и выборочные позиции.
  7. Включить регулярный обмен. Расписание задают только после стабильного повторного запуска на тестовых данных.

Как проверить каталог после выгрузки

Факт появления товаров ещё не означает, что каталог готов. Для приёмки выбирают несколько контрольных позиций: простой товар, товар с характеристиками, позицию с несколькими ценами, остатками на разных складах и изображениями.

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

Как проверить обмен заказами

Контрольный заказ должен пройти тот же путь, что и реальная покупка. Для выгрузки заказов из Битрикс в 1С недостаточно увидеть документ в учёте: важно сравнить состав, суммы и дальнейшие изменения.

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

Почему обмен работает нестабильно

Несовпадают идентификаторы

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

Не согласованы характеристики и предложения

Цвет, размер и другие варианты могут храниться в 1С и на сайте по-разному. Из-за этого предложения теряют связь с товаром, фильтр показывает лишние значения, а остаток становится общим вместо отдельного.

Сложная система цен и складов

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

Выгрузка слишком велика для текущих ограничений

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

Объём одного шага на сайте задают два параметра в настройках интеграции. «Интервал одного шага в секундах» ограничивает время шага, значение 0 означает загрузку за один шаг. «Размер единовременно загружаемой части файла (в байтах)» ограничивает порцию файлов обмена. Такие же параметры есть на закладке «Заказы». Если шаг не укладывается в лимиты PHP или таймаут веб-сервера и прокси, возможны ошибки 502 и 504 или пустой ответ, а 1С считает такой файл необработанным.

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

Данные меняют одновременно в двух системах

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

Частые ошибки обмена 1С-Битрикс и что проверить

Причины выше объясняют, почему обмен нестабилен в целом. Таблица идёт от симптома, который видно в 1С или на сайте. Причина в ней вероятная: подтверждает её проверка на тестовой копии.

СимптомВероятная причинаЧто проверить
Цены не импортируются или пустыеТип цены не выгружается из 1С или попадает не туда, например в товар вместо торгового предложенияТипы цен в узле 1С, опцию «Цены только в инфоблоке торговых предложений», видимость типа цены для групп покупателей, валюту: типовой обмен выгружает цены в одной валюте
Не переносятся разделы или фотоВ узле 1С не включена выгрузка групп или картинок, на сервере не хватает памяти на масштабирование изображенийСостав выгрузки в 1С, ответ сервера в сообщении 1С, лимит памяти PHP и размер исходных изображений
Дублируются товары или свойстваВнешние коды не совпадают, позиции созданы на сайте вручную или загружены из другого источникаВнешние коды (XML_ID) товаров и свойств на тестовой копии, раздел «Несовпадают идентификаторы» выше
Массовые 404 после синхронизацииСимвольный код пересоздан при обновлении, либо позиции, которых нет в файле полной выгрузки, деактивированы или удаленыТранслитерацию при обновлении, действие с отсутствующими товарами и группами, шаблон URL инфоблока, редиректы, 404 и дубли в краулере и Вебмастере
Не генерируются символьные кодыНе включена транслитерация символьного кода при добавлении элементовНастройку транслитерации в форме интеграции и уже существующие коды разделов и товаров
Белый экран или 502 во время обменаШаг импорта не укладывается в лимиты PHP или таймаут веб-сервераИнтервал шага, размер части файла, логи веб-сервера и PHP, обработчики событий
Не проходит авторизацияPHP работает в режиме CGI и не получает данные HTTP-авторизации, либо у пользователя обмена нет правРежим работы PHP вместе с хостингом, группу пользователя обмена в настройках интеграции, логин и пароль в узле 1С
Статус заказа на сайте не меняетсяИз 1С не пришли дата оплаты или дата отгрузки, либо смена статусов не включенаПроведены ли в 1С документы оплаты и отгрузки, опцию «Менять статусы заказов по информации из 1С»

Строка про 404 касается не только обмена. Если товары уже в поиске, смена адресов без редиректов оставляет проиндексированные страницы с ошибкой. После крупной синхронизации полезно проверить сайт так же, как при техническом SEO-аудите: 404, дубли и канонические адреса.

Когда нужен API вместо типового CommerceML

Собственная интеграция оправдана, когда нужно работать с нестандартными сущностями, обмениваться данными с несколькими системами, получать события почти без задержки или строго контролировать каждую операцию. Но API не отменяет карту данных, идентификаторы, журналирование и тесты — он только меняет транспорт и логику обработки.

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

Что прислать для оценки интеграции

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

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

Короткие ответы

Можно ли обмениваться только остатками и ценами?

Да, состав обмена настраивают под процесс, но нужно проверить, как товары будут сопоставляться и какая система отвечает за остальные поля.

Можно ли запускать обмен в реальном времени?

Возможность зависит от конфигурации 1С, версии модуля и сценария. Для многих проектов достаточно расписания; требование к допустимой задержке лучше определить до выбора режима.

Как заказы с сайта попадают в 1С?

1С вручную или по расписанию забирает с сайта файл с новыми заказами по тому же протоколу. Какие заказы попадут в файл, решают настройки на закладке «Заказы»: сайт, начальный статус, только оплаченные заказы. Проверять результат удобно по списку из раздела о проверке обмена заказами.

Подойдёт ли типовой обмен для 1С:УНФ и 1С:УТ 11.5?

Да, для обеих конфигураций 1С-Битрикс публикует модули обмена. Перед работами сверьте релиз своей базы с перечнем модулей. В УНФ раздел настройки может называться «Интернет-магазин».

Что делать, если товары уже заведены на сайте?

Сначала сопоставить внешние идентификаторы на тестовой копии. Запуск полной выгрузки без сопоставления повышает риск дублей и перезаписи данных.

Нужно ли останавливать магазин на время запуска?

Не всегда. Решение зависит от объёма изменений и текущих заказов. Для миграции полезно заранее определить окно переключения, контрольный срез остатков и план отката.

Как обсудить интеграцию

Я настраиваю и дорабатываю интернет-магазины на 1С-Битрикс вместе с программистом, включая обмен каталогом и заказами. Для оценки пришлите адрес сайта, конфигурацию 1С и кратко опишите, какие данные должны двигаться в каждую сторону. Можно начать с разработки интернет-магазина на 1С-Битрикс или отдельно описать задачу по интеграции сайта с внешними системами.

Официальные материалы по механизму: компоненты обмена с 1С, настройки интеграции на стороне магазина и возможности публикации товаров и обработки заказов.