Интеграция Битрикс24 с сервисами электронной подписи

Устанавливать КриптоПро CSP на каждый ноутбук, раздавать токены, ловить баги browser plug-in после обновлений — знакомая боль для любого руководителя. В среднем компания тратит 2-3 дня на подписание одного документа через курьера, а облачная подпись сокращает это время до 3-5 минут. Затраты на курьерские службы можно снизить до $4.5k–6.5k. в год. В среднем компания обрабатывает от 50 до 200 документов в месяц — каждый требует от 2 до 4 часов ручной работы. Мы предлагаем другой путь: облачные сервисы электронной подписи. Они снимают привязку к рабочему месту и позволяют выстроить гибкие маршруты подписания с несколькими участниками, включая контрагентов. Экономия на одном документе достигает 95%. Закажите интеграцию под ключ за 2–3 недели — свяжитесь для консультации.

Какой сервис электронной подписи выбрать для Битрикс24?

Для обмена формализованными документами (УПД, счета-фактуры) с российскими контрагентами — Диадок или СБИС. Для внутреннего подписания без токенов — КриптоПро DSS. Для международных контрактов — DocuSign. Облачная подпись через API в 3 раза быстрее традиционной — не нужно ждать курьера или сканировать бумаги.

Как устроена интеграция Битрикс24 с сервисами электронной подписи?

Общая схема одинакова для всех сервисов, различается только API:

1. Документ формируется в Битрикс24 через генератор документов (crm.documentgenerator).
2. Обработчик извлекает файл через REST API Битрикс24 и передаёт в сервис ЭП.
3. Сервис запускает маршрут подписания — уведомляет подписантов.
4. Подписанты работают в интерфейсе сервиса ЭП (или в мобильном приложении).
5. Webhook от сервиса сообщает о завершении.
6. Подписанный документ + файл подписи загружаются обратно в Битрикс24.

Связующее звено — серверный обработчик (webhook-приёмник). В простом варианте — PHP-скрипт на хостинге. Для надёжной работы при высокой нагрузке — очередь задач через Redis или RabbitMQ с гарантированной доставкой и ретраями при ошибках. По нашим данным, внедрение интеграции сокращает общий цикл закрытия сделки на 30–40%.

Интеграция с Контур.Диадок: полный цикл

Диадок — крупнейший оператор ЭДО в России, и именно с ним чаще всего связывают Битрикс24. REST API доступен по адресу https://api.kontur.ru/diadoc/v1/. Разберём реализацию подробно.

Аутентификация

Двухэтапная: сначала POST /Authenticate с логином/паролем или сертификатом, затем полученный токен передаётся в заголовке Authorization: DiadocAuth ddauth_api_client_id={client_id}, ddauth_token={token}. Токен живёт 1 час. В middleware кэшируем его и обновляем автоматически за 5 минут до истечения — иначе запросы начнут падать с 401 посреди рабочего дня.

Отправка документа на подпись

1. Получить файл из Битрикс24: crm.documentgenerator.document.get.
2. Определить ящик организации: GET /GetMyOrganizations.
3. Найти контрагента в Диадоке: GET /GetCounteragent?myOrgId={id}&counteragentOrgId={id}.
4. Для формализованных документов (УПД, акт, счёт-фактура) — POST /GenerateTitleXml, Диадок требует XML в формате ФНС.
5. Отправить: POST /PostMessage с вложенным документом и типом.

Для неформализованных документов (договоры, допсоглашения) XML не нужен — файл передаётся как есть.

Отслеживание статуса

Диадок поддерживает два механизма:

• Polling — GET /GetDocflowEvents?afterEventId={id} — получение событий после указанного ID.
• Webhook-подписки — уведомления при изменении статуса через партнёрский доступ.

На практике webhooks Диадока могут задерживаться на минуты при пиковых нагрузках. Надёжная схема: webhook как триггер немедленной проверки, polling каждые 5 минут как страховка. Так не теряются события и не нагружается API лишними запросами.

Получение подписанного документа

GET /GetMessage?boxId={boxId}&messageId={msgId}&entityId={entityId} 

В ответе — все версии документа, подписи каждой стороны, штампы времени. Извлекаем подписанную версию и файл подписи (.sig), загружаем в Битрикс24 через disk.file.upload, привязываем к сделке.

Отказ от подписи

Контрагент может запросить уточнение или отклонить документ. Диадок передаёт событие с комментарием. Обработчик создаёт в Битрикс24 задачу менеджеру (tasks.task.add) с текстом отказа и возвращает сделку на стадию доработки через crm.deal.update.

Маршруты подписания с несколькими участниками

Реальный документооборот — это не одна подпись. Типичные сценарии:

Последовательное подписание: договор подписывает сначала ваша сторона, затем контрагент. Порядок жёстко фиксирован.

Параллельное подписание: акт сверки подписывают обе стороны независимо.

Подписание с внутренним согласованием: перед подписью руководителем документ визирует юрист и финансовый директор. Визирование — УНЭП, финальная подпись — КЭП. В типовом проекте прописывается до 5–7 этапов согласования.

В API сервисов маршрут описывается набором шагов с участниками, типом действия и порядком:

{ "document_id": "doc-456", "workflow": [ {"step": 1, "action": "approve", "participants": ["[email protected]"], "type": "sequential"}, {"step": 2, "action": "sign", "participants": ["[email protected]"], "type": "sequential"}, {"step": 3, "action": "sign", "participants": ["[email protected]"], "type": "sequential"} ] } 

Что хранится в Битрикс24 после подписания?

После завершения цикла в CRM должны оказаться:

• Оригинал документа (PDF)
• Файл откреплённой подписи (.sig) — CAdES или XAdES
• Протокол подписания — кто, когда, каким сертификатом

Файлы загружаются на Битрикс24.Диск в структуру Подписанные документы / [Год] / [Месяц] / [Номер сделки]. В пользовательских полях сделки фиксируются дата подписания, номер документа в системе ЭДО, статус.

Почему облачная подпись выгоднее традиционной?

Облачная подпись через API сокращает время подписания с 2–3 дней до 3–5 минут, снижает трудозатраты на 80% и не требует установки КриптоПро CSP на каждый компьютер. Компании, внедрившие облачный ЭДО, экономят до $4.5k–6.5k в год на курьерских службах и расходных материалах.

Уведомления и автоматизация воронки

Согласно Wikipedia: Электронная подпись, юридическая значимость обеспечивается сертификатом КЭП. Каждое изменение статуса документа в сервисе ЭП транслируется в Битрикс24:

• Уведомление в чат (im.notify.system.add) — ответственному менеджеру
• Перевод стадии сделки (crm.deal.update) — автоматически при подписании обеими сторонами
• Комментарий в таймлайне (crm.timeline.comment.add) — запись с деталями события
• Задача при отказе (tasks.task.add) — менеджеру на доработку документа

Менеджер не следит за статусами вручную — система сама уведомляет и двигает сделку по воронке.

Что входит в работу при заказе интеграции?

• Анализ требований и выбор сервиса
• Настройка API-ключей и тестового контура
• Разработка обработчиков отправки и приёма webhooks
• Интеграция кнопки «Отправить на подпись» в карточку сделки
• Создание скриптов для многопользовательских маршрутов
• Полное тестирование с реальными документами и контрагентами
• Подготовка документации и обучение пользователей
• Техническая поддержка в течение 30 дней после запуска

Этапы внедрения

Облачная электронная подпись через внешний сервис убирает зависимость от конкретного компьютера. Менеджер отправляет документ из карточки сделки, контрагент подписывает в интерфейсе оператора ЭДО, подписанная версия автоматически возвращается в CRM. Без токенов на каждом рабочем месте, без сканера, без ожидания курьера. Получите консультацию по вашему проекту — оценим объём работ за один день.