Налаштування обміну між 1С:Документообігом та Бітрикс24
Зв'язка 1С:Документообіг (1С:ДО) та Бітрикс24 закриває розрив між обліковим контуром та робочим простором команди. Документи зберігаються в 1С:ДО з юридичною силою та версійністю, а працівники працюють із задачами та узгодженнями всередині Бітрикс24 — без перемикання між системами.
Ми налаштовуємо двосторонній обмін так, щоб зміни в будь-якій із систем корректно відбивалися в іншій, конфлікти обробляються автоматично, а маршрути узгодження не дублюються.
Що синхронізується
Обмін будується за трьома напрямами:
- Документи → Бітрикс24.Диск. Файли з 1С:ДО публікуються в задані папки на Диску. При оновленні версії в 1С:ДО файл на Диску перезаписується. Зворотне завантаження — за тригером або розкладом.
- Доручення ↔ Задачи. Доручення в 1С:ДО створює задачу в Бітрикс24 з прив'язкою до відповідального. Закриття задачи в Б24 змінює статус доручення в 1С:ДО.
- Узгодження через бізнес-процеси. Маршрут узгодження документа в 1С:ДО транслюється в БП Бітрикс24 — учасники отримують сповіщення та голосують всередині портала.
Технічний стек інтеграції
Обмін реалізується через REST API Бітрикс24 та HTTP-сервіси 1С:ДО. Схема взаємодії:
| Компонент | Роль |
|---|---|
| REST API Бітрикс24 | Створення задач, завантаження файлів на Диск, запуск БП |
| Вебхуки (вхідні) | Прийом подій від 1С:ДО — новий документ, зміна статусу |
| Вебхуки (вихідні) | Сповіщення 1С:ДО про завершення узгодження в Б24 |
| HTTP-сервіс 1С:ДО | Endpoint для отримання команд від Бітрикс24 |
| Чергу повідомлень | Буферизація при піковому навантаженні (опціонально — RabbitMQ) |
Авторизація — через OAuth 2.0 для серверних додатків або вхідний вебхук із токеном. Для промислової експлуатації використовуємо серверне додаток: токен оновлюється автоматично, немає прив'язки до конкретного користувача.
Маппінг полів
Довідники в 1С:ДО та Бітрикс24 не збігаються. Налаштовуємо таблицю відповідностей:
- Контрагенти 1С:ДО → Компанії CRM. Зіставлення за ІНН або зовнішнім кодом.
- Види документів → Папки Диска. Кожний вид документа з 1С:ДО прив'язується до конкретної папки.
- Виконавці → Користувачі Б24. Маппінг за електронною поштою або табельним номером у користувацькому полі.
- Статуси узгодження. «Узгоджено» / «Відхилено» / «На доробку» в 1С:ДО відповідають результатам голосування в БП Бітрикс24.
Маршрути узгодження документів
Це ключовий елемент інтеграції. Маршрут у 1С:ДО містить етапи: ініціювання, послідовне або паралельне узгодження, підписання. У Бітрикс24 цей маршрут відтворюється через шаблон бізнес-процесу:
- Ініціювання. Вебхук з 1С:ДО запускає БП у Бітрикс24 з передачею ID документа, списку узгоджувачів та терміну.
- Паралельний етап. БП створює завдання всім учасникам етапу одночасно. Результат фіксується в змінних БП.
- Послідовний етап. Завдання наступному учаснику створюється тільки після завершення попереднього.
- Повернення результату. По завершенні БП вихідний вебхук відправляє в 1С:ДО підсумковий статус та коментарі узгоджувачів.
Якщо маршрут у 1С:ДО змінився (додано етап, замінено узгоджувача), шаблон БП оновлюється вручну або через скрипт перестворення. Повна автогенерація шаблонів БП з 1С:ДО можлива, але потребує окремої розробки обробника.
Обробка конфліктів
При двосторонньому обміні неминучі колізії. Правила розв'язання:
-
Документи. Пріоритет у 1С:ДО — це система обліку. Якщо файл змінений у обох системах, версія з 1С:ДО перезаписує версію на Диску, конфліктна копія зберігається з суфіксом
_conflict_YYYYMMDD. - Задачи/доручення. Пріоритет у системі, де сталася остання зміна (за міткою часу). При розбіжності менш за 60 секунд — ручне розв'язання через сповіщення адміністратору.
- Узгодження. Конфлікт неможливий конструктивно: результат голосування формується в одній системі та передається в іншу.
Розклад та моніторинг
Синхронізація документів працює за розкладом (cron-задача на стороні 1С, агент на стороні Б24) з інтервалом від 5 хвилин. Задачи та узгодження — у реальному часі через вебхуки.
Для моніторингу налаштовуємо:
- Лог обміну в 1С:ДО (реєстр відомостей з історією відправок)
- Журнал вхідних вебхуків у Бітрикс24
- Сповіщення адміністратору при помилках HTTP (статуси 4xx/5xx) або таймауті
Що вийде в результаті
Працівники узгоджують документи у звичному інтерфейсі Бітрикс24, не входячи в 1С:ДО. Бухгалтерія та юристи продовжують працювати в 1С:Документообігу. Обидві системи містять актуальні дані з затримкою не більше 5–10 хвилин для документів та миттєвою синхронізацією для задач та узгодження.