Налаштування завантаження замовлень з 1С-Бітрікс в 1С:УТ
Ми налаштовуємо завантаження замовлень з вашого магазину на Бітрікс в 1С:УТ так, щоб менеджеру не доводилося вручну переносити дані. Це друга половина двостороннього обміну: ціни та номенклатура йдуть зверху вниз (з 1С на сайт), а замовлення — знизу вгору (з сайту в 1С). Без коректного налаштування вивантаження операційна робота стопориться: замовлення губляться, контрагенти дублюються, статуси не синхронізуються.
Ми беремо на себе реалізацію обміну під ключ: від налаштування вузла обміну в Бітрікс до тестування тестового замовлення. За 2 робочих дні ви отримуєте стабільну передачу замовлень з можливістю зворотної синхронізації статусів. Наш досвід — 10+ років інтеграцій Бітрікс з 1С, тому ми гарантуємо, що 54-ФЗ, фіскалізація та обмін з маркетплейсами не зламаються.
Що передається в замовленні
При вивантаженні замовлення з Бітрікс у форматі 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 не збігається — УТ не знайде номенклатуру і створить «невідомий товар» або відмовить у створенні замовлення. Типові сценарії помилки:
- Ручне створення товарів в Бітрікс без обміну
- Імпорт номенклатури з іншого джерела
- Відновлення БД Бітрікс зі старого бекапу
Діагностика: перед запуском передачі замовлень зробіть тестове вивантаження одного замовлення і перевірте, чи всі ИдТовара знаходяться в УТ. Ми налаштовуємо логування помилок, щоб ви бачили причину збою.
Доставка і служби доставки
Спосіб доставки із замовлення Бітрікс передається в поле Доставка → СпособДоставки. В УТ це повинен бути елемент довідника «Служби доставки». Якщо на сайті кілька служб (кур'єр, Пошта, Нова пошта, самовивіз), в УТ мають бути відповідні записи. Без маппінгу замовлення створюється без служби доставки, і менеджер додає її вручну.
Адреса доставки передається в Контрагент → Адреси → Адреса з типом «Доставка». УТ зберігає адресу в картці контрагента. Якщо у покупця кілька адрес — кожне замовлення передає актуальну.
Кейс: наш клієнт — магазин з ручним складанням замовлень
Наш клієнт, дистриб'ютор промислового обладнання, зіткнувся з проблемою: всі замовлення збираються вручну комірником за роздрукованим листом, але замовлення з Бітрікс не потрапляли в УТ вчасно. Ми реалізували статусний ланцюжок:
- Замовлення з сайту → УТ (статус «Новий»)
- Менеджер в УТ перевіряє наявність → переводить в «Підтверджено» → статус йде назад в Бітрікс, покупець отримує email
- Після відвантаження → «Виконано» → Бітрікс оновлює статус
Інтервал обміну: замовлення — кожні 3 хвилини; статуси назад — кожні 5 хвилин. Затримка між дією менеджера і сповіщенням покупця — не більше 8 хвилин. В результаті економія часу менеджера склала 30% за рахунок автоматизації.
Згідно з документацією Бітрікс, обмін замовленнями будується на стандарті CommerceML 2.0 (dev.1c-bitrix.ru).
Що входить в налаштування під ключ?
- Аудит поточної конфігурації обміну
- Налаштування вузла обміну в Бітрікс та 1С:УТ
- Маппінг статусів (прямий і зворотний)
- Налаштування створення контрагентів і номенклатури
- Перевірка передачі властивостей замовлення (доставка, оплата, доп. поля)
- Тестування на тестовому замовленні
- Документація за схемою обміну
Типові помилки та їх рішення
| Проблема | Причина | Рішення |
|---|---|---|
| Замовлення не створюється | Не збігається XML_ID | Перевірити GUID номенклатури |
| Дуби контрагента | Немає зовнішнього ID | Додати BITRIX_USER_ID |
| Статус не оновлюється | Немає зворотного маппінгу | Налаштувати зворотний вузол обміну |
| Не приходить адреса | Не вказано тип «Доставка» | Виправити маппінг полів |
Терміни та гарантії
Базове налаштування — від 1 до 2 робочих днів. Якщо потрібні кастомні поля або нестандартні служби доставки — термін збільшується до 3–5 днів. Ми гарантуємо, що після налаштування замовлення будуть передаватися без втрат, а статуси синхронізуватимуться із затримкою не більше 5 хвилин. Надаємо сертифікат на виконані роботи.
Оцінимо ваш проект безкоштовно — напишіть нам, щоб отримати консультацію. Зв'яжіться з нами для розрахунку термінів та вартості.