Ми не раз стикалися з ситуацією, коли клієнт використовує УНФ і хоче синхронізувати каталог і замовлення з сайтом на Бітрікс. УНФ — вибір малого бізнесу, який веде CRM, склад і продажі в одному місці без надмірної складності ERP. Інтеграція з Бітрікс тут працює інакше, ніж з УТ або КА: в УНФ немає повноцінного механізму CommerceML-обміну в старому стилі, зате є REST API та Bitrix Drive — офіційний конектор від 1С. Налаштування обміну потребує розуміння протоколів і типових помилок: наприклад, варіанти номенклатури не завжди коректно мапляться на SKU, а стандартний CommerceML не передає серії. Ми розберемо два шляхи і покажемо, як уникнути дублів та зависань.
Як вибрати спосіб обміну?
Шлях 1: CommerceML (класичний). УНФ підтримує стандартний протокол обміну через /bitrix/admin/1c_exchange.php. Вивантажуються номенклатура, ціни, залишки, приймаються замовлення. Працює, але з обмеженнями: немає характеристик у повному вигляді, немає серій, документи CRM не передаються. Докладніше про протокол читайте на CommerceML.
Шлях 2: REST API + веб-хуки. УНФ починаючи з версії 1.6 має вбудований HTTP-сервіс. Бітрікс може опитувати його або отримувати push-сповіщення про зміни. Цей шлях гнучкіший, але потребує розробки на обох сторонах.
Для більшості завдань (каталог + замовлення) достатньо CommerceML. REST потрібен, коли потрібно передавати нестандартні об'єкти: угоди CRM, завдання, документи.
Як налаштувати CommerceML в УНФ по кроках
- Перейдіть у розділ Компанія → Інтеграція → Обмін із сайтом.
- Вкажіть адресу сайту (наприклад,
https://ваш-сайт.ua) та облікові дані (логін/пароль для 1С-обміну). - Виберіть групи номенклатури для вивантаження — позначте лише ті, які мають бути на сайті.
- Налаштуйте вид ціни (роздрібна або оптова) та виберіть склади для вивантаження залишків.
- Налаштуйте відповідність статусів замовлень: в УНФ статуси «Новий», «В роботі», «Виконаний», «Скасований» — зіставте їх з вашим ланцюжком статусів на сайті.
- Запустіть тестовий обмін — він виконується вручну через кнопку «Виконати обмін».
Замовлення з Бітрікс в УНФ
Замовлення створюються в УНФ як «Замовлення покупця». Контрагент створюється автоматично за даними із замовлення. Обробка замовлення займає в середньому 2 секунди при синхронізації. «Раніше статус оновлювався раз на 15 хвилин, тепер клієнти бачать зміни миттєво. Це підвищило лояльність.» — клієнт, сервісний центр.
Критичний момент: статуси. В УНФ замовлення проходить статуси: Новий → В роботі → Виконаний / Скасований. В Бітрікс — свій ланцюжок статусів. Відповідність налаштовується у вузлі обміну. Якщо не налаштувати — замовлення в УНФ будуть зависати у статусі «Новий».
Зворотна синхронізація статусів — коли менеджер в УНФ змінює статус замовлення, ця зміна має потрапити в Бітрікс. Стандартний обмін це підтримує: при наступному сеансі обміну статус замовлення оновлюється в Бітрікс. Але є затримка — рівна інтервалу обміну (зазвичай 5–15 хвилин).
Чому REST API швидший за CommerceML?
При використанні CommerceML затримка синхронізації становить 5–15 хвилин. Для сервісних компаній, де клієнт чекає на оновлення статусу ремонту, це критично. REST API з веб-хуками дає миттєвий зворотний зв'язок — затримка знижується до 1–2 секунд. Більше 90% наших клієнтів із сервісною моделлю обирають REST.
Кейс: сервісний центр (з нашої практики)
Наш клієнт — сервісний центр з ремонту техніки. В УНФ ведеться CRM (заявки клієнтів, історія ремонтів), на сайті — форма заявки та особистий кабінет клієнта.
Завдання: заявка з сайту має потрапляти в УНФ як «Звернення», клієнт має бачити статус ремонту в особистому кабінеті на сайті.
Рішення: використовували REST API УНФ. При відправці форми на сайті:
- Бітрікс створює замовлення у своїй системі
- Скрипт робить POST-запит до HTTP-сервісу УНФ: створює звернення
- УНФ повертає ID звернення, Бітрікс зберігає його в користувацькому полі замовлення
Для зворотної синхронізації статусів — веб-хук з УНФ: при зміні статусу звернення — POST-запит на endpoint Бітрікс, який оновлює статус замовлення.
Затримка статусної синхронізації: 0 (миттєво через хук) замість 5 хвилин при polling.
Приклад конфігурації веб-хука
{ "event": "crm.invoice.status.update", "url": "https://site.bitrix24.ru/rest/1/токен/hook.php" } Процес роботи
| Етап | Тривалість | Результат |
|---|---|---|
| Аналіз поточної структури даних | 1–2 дні | Схема відповідності номенклатури та замовлень |
| Налаштування CommerceML або REST | 2–3 дні | Працюючий обмін у тестовому контурі |
| Тестування та налагодження | 1–2 дні | Обробка помилок, кейси з дублями |
| Документація та навчання | 0,5 дня | Інструкція для операторів |
Типовий проєкт займає від 5 до 7 днів. Вартість розраховується індивідуально, але середня економія часу на синхронізацію становить до 90%.
Що входить у роботу
- Аналіз структури даних та схеми обміну — 1–2 дні
- Налаштування CommerceML або REST API — 2–3 дні
- Тестування сценаріїв (замовлення, номенклатура, статуси) — 1–2 дні
- Документація для операторів та адміністраторів — 0,5 дня
- Навчання співробітників (1–2 години) — включено
- Пост-підтримка 2 тижні після запуску
Які обмеження УНФ при інтеграції?
| Параметр | УНФ | УТ 11 |
|---|---|---|
| Характеристики номенклатури | Варіанти (обмежено) | Повноцінні характеристики |
| Декілька складів | Так | Так |
| Серійний облік | Так (базово) | Так (розширено) |
| REST API | Так | Обмежено |
| CRM-об'єкти в обміні | Тільки через REST | Ні |
| Макс. позицій у каталозі | до 20 000 | до 100 000 |
| Швидкість синхронізації | 5–15 хв (CommerceML), 1–2 сек (REST) | Залежить від об'єму |
УНФ добре підходить для інтеграції, якщо каталог невеликий (до 20 тис. позицій) і немає складних характеристик. Якщо бізнес зростає — закладіть можливість міграції на КА або УТ без переробки сайту (зберігайте XML_ID номенклатури).
Типові помилки та чек-лист
- Не налаштовано відповідність статусів — замовлення зависають.
- XML_ID номенклатури не збігається при обміні — дублі.
- Вивантажуються всі групи номенклатури, включаючи службові — сміття на сайті.
- Використовуються серії, але CommerceML їх не передає — потрібен REST.
Висновок
Наші інженери мають сертифікати 1С та Бітрікс, понад 5 років досвіду, виконали більше 50 проєктів з інтеграції. Ми гарантуємо безшовний обмін без втрати даних. Замовте налаштування під ключ — термін від 5 днів. Зв'яжіться з нами для аналізу вашого проєкту — отримайте консультацію інженера.