Щодня менеджери втрачають години на ручне перенесення документів із CRM в СЕД. За нашими даними, до 75% часу погодження йде на пересилання файлів та оновлення статусів. Ми автоматизуємо цей обмін інтеграцією Бітрікс24 із системою електронного документообігу. Результат: документи створюються та погоджуються без жодного копіювання, цикл угоди скорочується на 80%. На практиці: для компанії з 50 угодами на місяць інтеграція скоротила цикл погодження з 3 днів до 4 годин — економія $11k–16k. на рік. Документ формується в картці угоди, йде в СЕД, проходить маршрут, статус повертається — усе автоматично. Наш досвід — понад 10 інтеграцій із REST API Бітрікс24 та різними СЕД (REST API). Типові проблеми — зламані маршрути при оновленні CRM, втрати статусів, дублювання документів. Інтеграція ці ризики виключає. Замовте консультацію інженера для аналізу вашого процесу.
З чим інтегруємо
| СЕД | API | Протокол | Що враховувати |
|---|---|---|---|
| 1С:Документообіг | HTTP-сервіси, OData | REST / SOAP | Тісний зв'язок з екосистемою 1С, складна авторизація через сесії 1С |
| Directum RX | Сервіси інтеграції | REST API | Хороша документація, webhook-сповіщення, стабільний API |
| ELMA365 | Публічний REST API | REST | Low-code платформа, гнучкі бізнес-процеси, швидке налаштування маршрутів |
| DocsVision | Web-сервіси | REST / SOAP | Гнучка маршрутизація, але документація розрізнена |
Як виконується інтеграція Бітрікс24 із системою електронного документообігу
Точки інтеграції в Бітрікс24
-
crm.documentgenerator.*— генерація документів на основі шаблонів. - Бітрікс24.Диск — завантаження та скачування підписаних файлів.
- Бізнес-процеси — автоматичний запуск відправки webhook при зміні стадії.
Покрокове налаштування обміну:
- Створіть шаблон документа в генераторі Бітрікс24, підставивши поля угоди.
- Налаштуйте бізнес-процес: при переході угоди в стадію "На погодженні" відправте webhook з даними документа в middleware.
- Middleware приймає запит, відправляє документ в СЕД через її API.
- СЕД запускає маршрут погодження і по завершенні відправляє webhook назад.
- Middleware оновлює стадію угоди через
crm.deal.updateта завантажує підписаний файл на Диск.
Цей процес скорочує час обробки на 80% порівняно з ручним введенням. Офіційна документація Bizproc описує всі доступні дії.
Чому варто обрати middleware для інтеграції Бітрікс24 із системою електронного документообігу
Проста інтеграція (одна СЕД, лінійний маршрут) може обійтися без middleware. Але middleware надійніше прямого webhook у 3 рази при обробці помилок — він розшиває та повторює запити, веде лог та запобігає втраті даних. Витрати на ручне введення даних становлять близько $360–520. на місяць для середнього відділу продажів. Інтеграція окупається протягом півроку.
Архітектура з middleware:
Бітрікс24 -> Middleware -> СЕД Middleware — окремий сервіс (Laravel або Node.js), який зберігає мапінг document_id↔deal_id, обробляє черги через Redis/RabbitMQ та логує кожен крок.
Deep-dive: маршрути погодження та мапінг статусів — розробка інтеграції Бітрікс24
Погодження — центральний процес. Маршрути бувають трьох типів: послідовний, паралельний та умовний. У послідовному кожен наступний погоджувач отримує документ після схвалення попереднім. У паралельному документ йде кільком одночасно, достатньо схвалення всіх. Умовний маршрут залежить від суми договору або типу контрагента.
Мапінг статусів:
| Статус в СЕД | Стадія угоди в Б24 | Дія middleware |
|---|---|---|
| Створено | Документи на погодженні | crm.deal.update |
| На розгляді | — | Оновити UF-поле |
| Зауваження | Доработка документів | Повідомити менеджера |
| Погоджено | Документи погоджено | Перевести стадію |
| Підписано | Договір підписано | Завантажити файл |
| Відхилено | — | Повідомити |
Webhook із СЕД:
POST /api/sed-webhook { "document_id": "DOC-4521", "new_status": "approved", "approved_by": "[email protected]", "timestamp": "12 марта, 11:45", "comments": "Замечаний нет", "signed_file_url": "https://sed.company.ru/files/DOC-4521-signed.pdf" } Конфлікти та блокування
Ситуація: менеджер відредагував договір, поки документ на погодженні. Три стратегії:
- Блокування — редагування заборонено (перевірка UF-поля). Найнадійніший спосіб.
- Версіонування — кожна зміна створює нову версію, погодження перезапускається.
- Сповіщення — попередження менеджеру.
На практиці блокування виключає розбіжності.
Метадані документа та юридичне зберігання
СЕД зберігає документ з метаданими: номер, дата, контрагент, сума. Мапінг полів угоди:
| Поле в Б24 | Поле в СЕД |
|---|---|
| TITLE | Тема документа |
| OPPORTUNITY | Сума договору |
| COMPANY_ID | Контрагент |
| ASSIGNED_BY_ID | Ініціатор |
| UF_CRM_DOC_TYPE | Тип документа |
Підписані екземпляри повертаються в Б24, але майстер-копія живе в СЕД.
Віджет у картці угоди
Вбудовуємо віджет через REST placement CRM_DEAL_DETAIL_TAB: статус погодження, маршрут, історія. Менеджер бачить усе в одному вікні.
Що входить в роботу
- Конфігурація маршрутів погодження в СЕД
- Налаштування webhook-сповіщень між системами
- Розробка middleware (черги, логування, мапінг статусів)
- Віджет у картці угоди для відстеження погодження
- Інтеграція генератора документів Бітрікс24
- Документація з архітектури та налаштувань
- Навчання користувачів (2 години)
- Підтримка 30 днів після запуску
Етапи та терміни
| Етап | Що робимо | Термін |
|---|---|---|
| Обстеження | Аналіз API та маршрутів | 3–5 днів |
| Проектування | Архітектура middleware | 3–4 дні |
| Розробка middleware | Webhook-обробники, черги | 5–8 днів |
| Інтеграція Б24 | Бізнес-процеси, віджет | 3–5 днів |
| Інтеграція СЕД | Налаштування маршрутів | 3–5 днів |
| Тестування | Наскрізні сценарії | 3–5 днів |
| Пілотний запуск | Один відділ | 5–10 днів |
Результат
Інтеграція CRM із СЕД прибирає ручну працю на стику систем. Менеджер працює в Бітрікс24 — формує документ, рухає угоду. Юрист та керівники погоджують у СЕД. Документ проходить маршрут автоматично, статус повертається в CRM, підписана версія зберігається на Диску. Зв'яжіться з нами для оцінки проекту — отримайте консультацію інженера протягом дня. Заповніть форму на сайті — ми підберемо оптимальну архітектуру за 1 день.