Проблема: при двосторонній синхронізації 1С:Документооборот (1С:ДО) та Бітрікс24 зациклюються вебхуки — оновлення документа в 1С створює завдання в Бітрікс24, оновлення завдання надсилає зворотний запит до 1С, і цикл повторюється. Без прапорців синхронізації це призводить до дублювання даних та нескінченних сповіщень. Ми вирішуємо цю задачу через контрольні мітки та інтелектуальний мапінг, гарантуючи стабільну роботу зв'язки.
Зв'язка 1С:Документооборот та Бітрікс24 закриває розрив між обліковим контуром та робочим простором команди. Документи зберігаються в 1С:ДО з юридичною силою та версійністю, а співробітники працюють із завданнями та погодженнями всередині Бітрікс24 — без перемикання між системами. Наш досвід у цій інтеграції перевищує 5 років, понад 100 впроваджень, що дозволяє уникнути типових помилок при налаштуванні.
Ми налаштовуємо двосторонній обмін так, щоб зміни в будь-якій із систем коректно відображалися в іншій, конфлікти оброблялися автоматично, а маршрути погодження не дублювалися. Все працює під ключ: від першого налаштування до моніторингу в промисловій експлуатації.
Що синхронізується
Обмін будується за трьома напрямками:
- Документи → Бітрікс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. Мапінг за email або табельним номером у користувацькому полі.
- Статуси погодження. «Погоджено» / «Відхилено» / «На доопрацювання» в 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 хвилин для документів та миттєвою синхронізацією для завдань і погоджень. Наш підхід з чергами повідомлень (RabbitMQ) обробляє до 5000 документів на годину — це в 10 разів швидше типових рішень без буферизації.
Оцініть ваш проект: ми підготуємо план інтеграції за 1 день. Зв'яжіться з нами для консультації — гарантуємо стабільну роботу обміну.