Обмен 1С-Битрикс с 1С: как устроена интеграция

Обмен 1С-Битрикс с 1С — это не «волшебная кнопка», а строгий протокол, по которому две системы обмениваются XML-файлами. Понимание того, как устроена эта механика изнутри, экономит часы на настройке и разборе ошибок: становится ясно, кто кого инициирует, где хранятся данные и почему выгрузка «встаёт» на большом каталоге.

Протокол CommerceML и кто с кем говорит

В основе интеграции лежит открытый стандарт CommerceML 2 — набор XML-схем, которыми 1С и Битрикс описывают товары, свойства, цены, остатки и заказы. Обмен идёт через HTTP(S): сторона 1С выступает клиентом, а сайт — сервером, который принимает запросы на специальный скрипт-обработчик.

Точка входа на стороне Битрикса — файл /bitrix/admin/1c_exchange.php (для каталога) и /bitrix/admin/1c_exchange.php?type=sale (для заказов, интернет-магазин). Именно этот адрес прописывается в настройке узла обмена в 1С вместе с логином и паролем пользователя сайта, у которого есть право на обмен.

• Каталог (товары, разделы, свойства, картинки) идёт из 1С на сайт.
• Цены и остатки выгружаются отдельным пакетом или вместе с каталогом.
• Заказы — двусторонний поток: сайт отдаёт новые заказы, 1С возвращает их со статусами.

Этапы одной сессии обмена

Обмен — это не один запрос, а последовательность шагов. 1С дергает обработчик сайта командами через параметр mode, и каждый шаг завершается ответом сервера. Порядок для каталога такой:

1. mode=checkauth — авторизация: сайт возвращает cookie-сессию.
2. mode=init — согласование параметров: поддержка ZIP, максимальный размер файла (file_limit).
3. mode=file — 1С загружает XML (и картинки) на сайт по частям.
4. mode=import — сайт разбирает файлы и пишет данные в инфоблоки; при больших объёмах шаг вызывается повторно, пока не вернёт success.

Для заказов добавляются режимы mode=query (сайт отдаёт XML заказов) и mode=success. Понимание этих команд критично при разборе логов: по последнему успешному mode сразу видно, на каком этапе всё остановилось.

Как данные ложатся в каталог сайта

На стороне сайта данные из 1С попадают в инфоблоки модуля iblock и торгового каталога catalog. При первой настройке обмена Битрикс сам создаёт нужные инфоблоки: один для товаров и, если в 1С включены характеристики, второй — для торговых предложений (SKU), связанный с первым.

Ключевую роль играет внешний код — XML_ID. Каждый товар, раздел и свойство получают GUID из 1С, и по нему система при повторных выгрузках находит уже существующий элемент и обновляет его, а не плодит дубли. Поэтому нельзя вручную менять или чистить XML_ID — это первый шаг к «задвоению» каталога.

Двусторонний обмен заказами

Заказы — единственный поток, который идёт в обе стороны. Сайт формирует XML новых и изменённых заказов, 1С забирает его на шаге query, создаёт документы (заказ покупателя, реализация) и отдаёт обратно пакет с обновлёнными реквизитами: номером в 1С, статусом, флагами оплаты и отгрузки.

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

Где на сайте хранятся файлы и настройки

Все служебные файлы обмена лежат в каталоге /upload/1c_catalog/ (и /upload/1c_exchange/ для более новых версий). Именно сюда 1С загружает import.xml, offers.xml, prices.xml, файлы остатков и папки с картинками товаров.

• Профиль обмена и его параметры хранятся в настройках модуля торгового каталога: Магазин → Настройки → Настройки модулей → Торговый каталог.
• Права на обмен определяются группой пользователя сайта, под которым авторизуется 1С; удобно завести отдельного технического пользователя.
• Логи пишутся в файл __1c_exchange.log в каталоге обмена, если включено логирование — это первый источник при разборе сбоев.

Отдельно стоит проверять права на запись в /upload/: если веб-сервер не может создать файл, обмен упадёт ещё на шаге file, хотя авторизация прошла успешно.

Узкие места и на что смотреть при настройке

Большинство проблем интеграции сводится к трём вещам: ресурсы сервера, объём каталога и корректность сопоставлений. Чем крупнее номенклатура, тем чаще обмен упирается в таймауты и память PHP.

• Ресурсы PHP. Параметры max_execution_time, memory_limit и post_max_size должны позволять принимать и разбирать крупные XML.
• Размер порции. В настройках модуля есть «Количество элементов, обрабатываемых за один шаг» — его снижают, если импорт не укладывается в лимит времени.
• Полная vs. частичная выгрузка. В 1С стоит включить обмен «только изменённых» объектов, чтобы каждая сессия не гоняла весь каталог заново.
• Кодировка и валидность XML. Битая выгрузка из-за нестандартных символов в наименованиях — частая причина ошибок парсинга.

Итог

Интеграция 1С-Битрикс с 1С — это протокол CommerceML поверх HTTP: 1С как клиент пошагово шлёт XML на обработчик 1c_exchange.php, а сайт раскладывает данные по инфоблокам, сопоставляя объекты по XML_ID. Каталог идёт в одну сторону, заказы — в обе, а стабильность обмена держится на ресурсах сервера, размере порции и аккуратных сопоставлениях в узле 1С.

Мы в B2Bsite настраиваем такой обмен под ключ — от первичной связки каталога, цен и остатков до двустороннего потока заказов и сопровождения интеграции, когда каталог растёт. Если обмен нужно завести с нуля или он «встал» на проде, поможем разобраться и стабилизировать.