Настройка загрузки заказов из 1С-Битрикс в 1С:УТ
Передача заказов из Битрикс в УТ — вторая половина двустороннего обмена. Цены и номенклатура идут «сверху вниз» (из 1С на сайт), заказы — «снизу вверх» (с сайта в 1С). Это направление критично для операционной работы: менеджер не должен вручную перебивать заказы из сайта в учётную систему.
Что передаётся в заказе
При выгрузке заказа из Битрикс в формате CommerceML передаётся:
- Шапка заказа: номер, дата, статус, комментарий
- Контрагент: ФИО / наименование организации, ИНН, адрес, телефон, email
- Позиции заказа: XML_ID товара (или SKU), количество, цена, сумма
- Доставка: способ доставки, адрес, стоимость
- Оплата: способ оплаты, статус оплаты
- Дополнительные свойства: кастомные поля заказа, если они переданы
В УТ заказ создаётся как «Заказ покупателя». Контрагент ищется по ИНН (для юрлиц) или по ФИО (для физлиц). Если не найден — создаётся новый.
Маппинг статусов: главная точка отказа
Статусы заказов в Битрикс — строковые коды (N = новый, P = оплачен, F = выполнен). В УТ — перечисление (НовыйЗаказ, ВРаботе, Выполнен). Соответствие нужно настроить явно.
В настройках узла обмена Битрикс (Настройки → Магазин → Интеграция с 1С) есть таблица маппинга статусов. Типичная настройка:
| Статус Битрикс | Статус УТ |
|---|---|
| N (новый) | НовыйЗаказ |
| P (оплачен) | ВРаботе |
| F (завершён) | Выполнен |
| C (отменён) | Отменён |
Обратный маппинг (из УТ в Битрикс) — когда менеджер в УТ изменил статус заказа, сайт должен отобразить изменение. Это настраивается аналогично, в обратном направлении. Без обратного маппинга покупатель не видит актуальный статус своего заказа в личном кабинете.
Создание контрагента в УТ
Физлицо с сайта попадает в УТ как «Частное лицо» в справочнике «Контрагенты». Идентификация — по телефону или email (не по ФИО, которое не уникально).
Рекомендую: добавить в свойства заказа Битрикс поле BITRIX_USER_ID (ID пользователя) и передавать его в ДополнительныеРеквизиты заказа. УТ сохраняет это как внешний ID контрагента. При повторном заказе — поиск контрагента идёт по этому ID, не создаётся дубль.
// В обработчике выгрузки заказа добавляем ID пользователя
$arOrderProps['BITRIX_USER_ID'] = $order->getUserId();
Для юридических лиц — поиск по ИНН. ИНН должен быть обязательным полем при оформлении заказа в B2B-разделе сайта.
Позиции заказа: привязка к номенклатуре УТ
Каждая позиция заказа в XML содержит ИдТовара — XML_ID элемента инфоблока Битрикс. Этот XML_ID должен совпадать с GUID номенклатуры (или характеристики) в УТ.
Если XML_ID в Битрикс не совпадает с GUID в УТ — УТ не найдёт номенклатуру и создаст «неизвестный товар» или откажет в создании заказа. Это случается при:
- Ручном создании товаров в Битрикс (без обмена)
- Импорте номенклатуры из другого источника
- Восстановлении БД Битрикс из старого бэкапа
Диагностика: перед запуском передачи заказов сделайте тестовую выгрузку одного заказа и проверьте, все ли ИдТовара находятся в УТ.
Доставка и службы доставки
Способ доставки из заказа Битрикс передаётся в поле Доставка → СпособДоставки. В УТ это должен быть элемент справочника «Службы доставки». Соответствие нужно настроить в узле обмена.
Если на сайте несколько служб доставки (курьер, Почта, СДЭК, самовывоз), в УТ должны быть соответствующие службы. Если не настроить маппинг — заказ создаётся без службы доставки, и менеджер в УТ должен добавлять её вручную.
Адрес доставки. Передаётся в Контрагент → Адреса → Адрес с типом «Доставка». УТ сохраняет адрес в карточке контрагента. Если у покупателя несколько адресов доставки — каждый заказ передаёт актуальный адрес.
Кейс: магазин с ручной сборкой заказов
Дистрибьютор промышленного оборудования: все заказы собираются вручную кладовщиком по распечатанному листу. Заказ из Битрикс должен попасть в УТ, пройти согласование (менеджер подтверждает наличие), затем уйти на сборку.
Реализовали статусную цепочку:
- Заказ с сайта → УТ (статус «Новый»)
- Менеджер в УТ проверяет наличие → переводит в «Подтверждён» → статус уходит обратно в Битрикс, покупатель получает email
- После отгрузки → «Выполнен» → Битрикс обновляет статус
Интервал обмена: заказы → каждые 3 минуты; статусы обратно → каждые 5 минут. Задержка между действием менеджера и email покупателю — не более 8 минут.