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

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

Как устроен обмен заказами

Обмен заказами живёт в том же модуле sale, что и оформление, и работает по второй фазе протокола CommerceML — mode=query/mode=success для документов. В отличие от каталога, здесь инициатором чаще выступает 1С: обработка обмена подключается к точке /bitrix/admin/1c_exchange.php и последовательно выполняет запрос заказов, их приём и подтверждение.

Цикл выглядит так:

1. checkauth — авторизация обработки по логину и паролю пользователя сайта;
2. query — сайт формирует sale.xml со всеми заказами, попадающими под условия выгрузки, и отдаёт его 1С;
3. import (file/sale) — 1С присылает встречный документ с изменениями, сайт разбирает его через sale_import.php;
4. success — стороны подтверждают завершение сессии.

Что передаётся в каждую сторону

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

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

Настройка на стороне сайта

В админке идёте в Магазин → Настройки → Настройки обмена данными → Экспорт в 1С (профиль обмена заказами). Ключевые параметры:

• Пользователь для обмена — отдельная учётка с правами на модуль sale; под ней 1С проходит checkauth;
• Выгружать заказы — включите и задайте, с какого момента (обычно «изменённые с прошлой сессии»);
• Сопоставление статусов — таблица «статус 1С → статус заказа Битрикс»;
• Тип плательщика и способы оплаты — маппинг на PAY_SYSTEM_ID;
• Свойства заказа — какие поля попадают в XML как реквизиты контрагента.

На стороне 1С в типовой обработке «Обмен с сайтом» (модуль «Обмен с сайтом» в УТ/УНФ/ERP) указывается адрес узла, логин, пароль и расписание. Регламентное задание запускает обмен по таймеру.

Сопоставление справочников

Основная боль двустороннего обмена — идентификаторы. 1С находит заказ на сайте по ID (или по XML-идентификатору документа), а товарные позиции — по XML_ID элемента каталога. Если каталог выгружался не из этой же 1С, идентификаторы не совпадут и заказ приедет с «неопознанными» строками.

• Статусы. Список статусов заказа (Магазин → Статусы заказов) сопоставляется с состояниями документа в 1С. Заведите статусы заранее и не меняйте их коды после запуска.
• Способы оплаты и доставки. Маппинг на платёжные системы и службы доставки Битрикса; расхождение приводит к тому, что заказ приходит без оплаты.
• Склады. Если включён складской учёт, коды складов на сайте должны соответствовать складам 1С (см. соседнюю статью о соответствии складов).

Проверка и отладка

Ход сессии проще всего смотреть в лог-файле обмена. Включите логирование в настройках профиля — Битрикс пишет __1c_exchange.log в каталог обмена, а также сохраняет присланный sale.xml во временную папку.

Что проверять при отладке:

1. Прошла ли авторизация — в логе шаг checkauth и выданный sessid;
2. Сформировался ли sale.xml и попал ли в него нужный заказ (фильтр по дате/статусу);
3. Разобрал ли сайт ответ 1С — ищите записи sale_import.php и обновление полей заказа;
4. Нет ли ошибок вида «не найден товар с XML_ID» — это разъехавшиеся идентификаторы каталога.

Частые грабли

Несколько ситуаций, которые чаще всего ломают обмен заказами:

• Заказ «уезжает» в 1С повторно. Причина — сброс отметки о выгрузке; проверьте, что 1С отправляет mode=success и сайт фиксирует факт обмена.
• Дублирование позиций. Возникает, когда XML_ID торговых предложений на сайте не совпадает с 1С — заказ приходит «поверх» и добавляет строки заново.
• Слетают цены. Если мастер цен — 1С, а на сайте включён пересчёт корзины, итоговая сумма может разойтись; отключайте пересчёт для заказов, пришедших из 1С.
• Таймаут на больших заказах. Длинные документы упираются в max_execution_time; увеличьте лимит для скрипта обмена или включите пошаговый режим.
• Статус не применяется. Код статуса в 1С не совпадает с кодом в Битриксе — исправляется в таблице сопоставления.

Автоматизация и расписание

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

• Регламентное задание в 1С запускает обмен заказами каждые 10–15 минут в рабочее время;
• Каталог, цены и остатки выгружаются отдельным профилем 2–4 раза в сутки;
• На сайте события заказа (OnSaleOrderSaved) можно использовать, чтобы помечать заказ к выгрузке немедленно.

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

Итог

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

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