Налаштування завантаження замовлень з 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 хвилин.