Зачем автоматизировать ЭДО в Битрикс24
Менеджер закрывает сделку, создаёт счёт-фактуру в 1С, скачивает PDF, загружает в Диадок, подписывает ЭЦП, отправляет контрагенту. Параллельно прикрепляет копию в CRM вручную. Через неделю — ещё один акт, потом УПД. На 50 сделках в месяц это рутина, которая съедает два рабочих дня менеджера (до 40 часов). Ошибки при ручном вводе встречаются в 7% случаев — неправильный ИНН, не та ставка НДС, потеря PDF. Мы помогаем компаниям автоматизировать цепочку: документ формируется из CRM, уходит в ЭДО, подписывается, а статус возвращается обратно в сделку. Интеграция Битрикс24 с Контур.Диадок — это не просто подключение API, а настройка полного цикла: от маппинга реквизитов до серверной подписи и обработки входящих. Автоматизация сокращает время на документооборот в 5 раз по сравнению с ручным копированием, а при средней ставке менеджера $14–20/час экономия достигает $540–780 в месяц.
Какие проблемы решает интеграция
- Потеря времени — ручная передача данных из CRM в Диадок занимает до 15 минут на документ. При 50 документах в месяц это 12,5 часов чистой рутины.
- Ошибки в реквизитах — неверный ИНН, ставка НДС, сумма приводят к отказам контрагентов и повторной отправке. Автоматизация исключает человеческий фактор.
- Отсутствие единого окна — менеджеру приходится переключаться между CRM и Диадоком, отслеживать статусы вручную. Статусы возвращаются в сделку автоматически.
Архитектура интеграции: компоненты и обмен данными
Связка Б24 с Контур.Диадок реализуется через Diadoc API. Основные компоненты:
| Компонент | Роль |
|---|---|
| Битрикс24 CRM | Источник данных: реквизиты компании, суммы, номенклатура из сделки |
| Middleware (серверный обработчик) | Формирует XML-документ по стандарту ФНС, отправляет в Diadoc API |
| Diadoc API | Принимает документ, маршрутизирует контрагенту, управляет подписанием |
| КЭП (CryptoPro CSP / VipNet) | Подпись документа на стороне отправителя |
Middleware может быть реализован на PHP или Node.js. Пример базового вызова Diadoc API для отправки документа:
// Пример отправки документа через Diadoc API (REST) $apiUrl = 'https://diadoc-api.kontur.ru/'; $authToken = 'ваш_токен_авторизации'; $boxId = 'id_ящика_организации'; $document = [ 'Document' => [ 'DocumentType' => 'Invoice', 'Content' => base64_encode($xmlContent), 'FileName' => 'invoice_123.xml' ] ]; $ch = curl_init($apiUrl . 'V2/Documents'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: DiadocAuth ddauth_api_client_id=' . $authToken, 'Content-Type: application/json' ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($document)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); Прямого коннектора из коробки нет. Интеграция реализуется через готовое приложение из Маркетплейса Б24 (если подходит под сценарий), кастомную разработку middleware или iPaaS-платформу (Albato, Make) — последняя не подходит, если требуется строгий XML ФНС.
Какие документы можно отправлять из CRM?
Из сделки автоматически формируются формализованные документы (УПД, счёт-фактура) и неформализованные (акты, договоры). Данные берутся из сделки и связанных сущностей:
- Реквизиты продавца — из настроек компании в Б24 (ИНН, КПП, адрес, р/с).
- Реквизиты покупателя — из карточки компании/контакта в CRM.
- Номенклатура — из товарных позиций сделки (название, количество, цена, НДС).
- Суммы — итого, НДС, к оплате — рассчитываются автоматически.
Middleware формирует XML в формате ФНС для счетов-фактур и УПД, для актов и договоров — PDF или произвольный XML.
Как настроить автоматическое подписание из CRM?
Подписание документа в Диадоке требует КЭП. Варианты:
- Через интерфейс Диадока. Менеджер нажимает кнопку в CRM, документ создаётся в Диадоке, менеджер подписывает КЭП. Статус возвращается через API.
- Через серверную подпись. CSP установлен на сервере, документ подписывается автоматически сертификатом организации. Подходит для массовой отправки (десятки документов в день).
- Через облачную подпись Контур. КЭП хранится в облаке Контура, подписание через API без локального CSP.
Статусы документа и обратная связь в CRM
После отправки документ проходит стадии: Отправлен → Доставлен → Подписан / Отклонён → Аннулирован. Статусы передаются обратно в Б24 через polling API или события. В карточке сделки обновляется пользовательское поле «Статус ЭДО», при подписании обеими сторонами робот переводит сделку на следующую стадию.
Работа с входящими документами от контрагентов
Контрагент отправляет документ через Диадок. Интеграция перехватывает его, создаёт активность в CRM с привязкой к компании, прикрепляет PDF, уведомляет менеджера. После подписания со стороны компании статус обновляется.
Сроки внедрения
| Масштаб | Что входит | Срок |
|---|---|---|
| Базовый | Отправка неформализованных документов, ручное подписание | 1–2 недели |
| Стандартный | Формализованные документы, автоформирование из сделки, возврат статусов | 2–4 недели |
| Расширенный | Серверная подпись, обработка входящих, интеграция с 1С + Б24 + Диадок | 4–6 недель |
Что входит в проект интеграции
Наша команда реализовала более 30 проектов интеграции с Контур.Диадок. В проект входит:
- Подключение Diadoc API: авторизация, получение токена, настройка ящика организации.
- Маппинг реквизитов: компания и контакт в CRM → реквизиты продавца/покупателя.
- Формирование документов из CRM: УПД, акты, счета-фактуры на основе данных сделки.
- Настройка подписания: интеграция с CryptoPro (локальная или серверная), облачная подпись Контур.
- Возврат статусов: обновление полей сделки, автоматический перевод стадии.
- Обработка входящих: уведомления, привязка к сделке, подписание.
- Обучение менеджеров: отправка документа из CRM, отслеживание статуса, обработка отклонений.
Хотите автоматизировать документооборот? Оставьте заявку на аудит текущего процесса — мы подберём оптимальную архитектуру. Получите консультацию по настройке интеграции Битрикс24 с Контур.Диадок.