Интеграция Битрикс24 с Контур.Диадок
Менеджер закрывает сделку, создаёт счёт-фактуру в 1С, скачивает PDF, загружает в Диадок, подписывает ЭЦП, отправляет контрагенту. Параллельно прикрепляет копию в CRM вручную. Через неделю — ещё один акт. И ещё один УПД. На 50 сделках в месяц это превращается в рутину, которая съедает два рабочих дня. Интеграция Б24 с Контур.Диадок автоматизирует цепочку: документ формируется из CRM, уходит в ЭДО, подписывается, а статус возвращается обратно в сделку.
Что такое Контур.Диадок
Контур.Диадок — оператор электронного документооборота (ЭДО) от СКБ Контур. Через него юридические лица обмениваются юридически значимыми документами: счетами-фактурами, актами, УПД, торг-12, договорами. Документы подписываются квалифицированной электронной подписью (КЭП) и имеют ту же юридическую силу, что бумажные оригиналы.
Типы документов, передаваемых через Диадок:
- Счёт-фактура — для вычета НДС
- УПД (универсальный передаточный документ) — заменяет счёт-фактуру + акт/накладную
- Акт выполненных работ — подтверждение оказания услуг
- Торг-12 — товарная накладная
- Договор — произвольный документ с подписанием обеими сторонами
Архитектура интеграции
Связка Б24 + Диадок работает через Diadoc API (REST). Основные компоненты:
| Компонент | Роль |
|---|---|
| Битрикс24 CRM | Источник данных: реквизиты компании, суммы, номенклатура из сделки |
| Middleware (серверный обработчик) | Формирует XML-документ по стандарту ФНС, отправляет в Diadoc API |
| Diadoc API | Принимает документ, маршрутизирует контрагенту, управляет подписанием |
| КЭП (CryptoPro / VipNet) | Подпись документа на стороне отправителя |
Прямого коннектора «Б24 → Диадок» из коробки нет. Интеграция реализуется через:
- Готовое приложение из Маркетплейса Б24 — если существует подходящее, покрывающее сценарий.
- Кастомную разработку — серверный скрипт (PHP/Node.js), который по вебхуку из Б24 формирует документ и отправляет через Diadoc API.
- iPaaS-платформу (Albato, Make) — если не требуется формирование XML по стандарту ФНС.
Формирование документа из CRM
Данные для документа берутся из сделки и связанных сущностей:
- Реквизиты продавца — из настроек компании в Б24 (ИНН, КПП, адрес, р/с).
- Реквизиты покупателя — из карточки компании/контакта в CRM.
- Номенклатура — из товарных позиций сделки (название, количество, цена, НДС).
- Суммы — итого, НДС, к оплате — рассчитываются автоматически.
Middleware формирует XML в формате, требуемом ФНС (для счетов-фактур и УПД — формализованный формат). Для актов и договоров — неформализованный формат (PDF или произвольный XML).
Процесс подписания
Подписание документа в Диадоке требует КЭП. Варианты подписания из Б24:
- Через интерфейс Диадока. Менеджер нажимает кнопку в CRM → документ создаётся в Диадоке → менеджер переходит в Диадок, подписывает КЭП. Статус возвращается в Б24 через API.
- Через серверную подпись. CryptoPro CSP установлен на сервере. Документ подписывается автоматически сертификатом организации. Подходит для массовой отправки (десятки документов в день).
- Через облачную подпись Контур. КЭП хранится в облаке Контура — подписание происходит через API без локальной установки CryptoPro.
Статусы документа и обратная связь в CRM
После отправки документ в Диадоке проходит стадии:
- Отправлен — документ ушёл контрагенту
- Доставлен — контрагент получил документ
- Подписан — контрагент подписал своей КЭП
- Отклонён — контрагент отказался подписывать (с комментарием)
- Аннулирован — одна из сторон инициировала аннулирование
Статусы передаются обратно в Б24 через polling Diadoc API (периодический опрос) или через механизм событий. В карточке сделки обновляется пользовательское поле «Статус ЭДО», а при подписании обеими сторонами — робот переводит сделку на следующую стадию.
Работа с входящими документами
Контрагент отправляет документ через Диадок. Интеграция перехватывает входящий документ и:
- Создаёт активность (событие) в CRM с привязкой к компании контрагента.
- Прикрепляет PDF-версию документа к карточке сделки.
- Уведомляет ответственного менеджера.
- После подписания со стороны компании — обновляет статус.
Сроки внедрения
| Масштаб | Что входит | Срок |
|---|---|---|
| Базовый | Отправка неформализованных документов (акты, договоры) из CRM в Диадок, ручное подписание | 1-2 недели |
| Стандартный | Формализованные документы (УПД, счёт-фактура), автоматическое формирование из сделки, возврат статусов | 2-4 недели |
| Расширенный | Серверная подпись, обработка входящих документов, интеграция с 1С + Б24 + Диадок | 4-6 недель |
Что настраиваем
- Подключение Diadoc API: авторизация, получение токена, настройка ящика организации
- Маппинг реквизитов: компания и контакт в CRM → реквизиты продавца/покупателя в документе
- Формирование документов из CRM: УПД, акты, счета-фактуры на основе данных сделки
- Настройка подписания: интеграция с CryptoPro (локальная или серверная), облачная подпись Контур
- Возврат статусов из Диадока в CRM: обновление полей сделки, автоматический перевод стадии
- Обработка входящих документов: уведомления, привязка к сделке, подписание
- Обучение менеджеров: отправка документа из CRM, отслеживание статуса, обработка отклонений