Настройка обмена 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. Маппинг по 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 минут для документов и мгновенной синхронизацией для задач и согласований.