Устанавливать КриптоПро CSP на каждый ноутбук, раздавать токены, ловить баги browser plug-in после обновлений — знакомая боль для любого руководителя. В среднем компания тратит 2-3 дня на подписание одного документа через курьера, а облачная подпись сокращает это время до 3-5 минут. Затраты на курьерские службы можно снизить до 500 000 руб. в год. В среднем компания обрабатывает от 50 до 200 документов в месяц — каждый требует от 2 до 4 часов ручной работы. Мы предлагаем другой путь: облачные сервисы электронной подписи. Они снимают привязку к рабочему месту и позволяют выстроить гибкие маршруты подписания с несколькими участниками, включая контрагентов. Экономия на одном документе достигает 95%. Закажите интеграцию под ключ за 2–3 недели — свяжитесь для консультации.
Какой сервис электронной подписи выбрать для Битрикс24?
| Сервис | Тип подписи | API | Для чего подходит |
|---|---|---|---|
| Контур.Диадок | КЭП, УНЭП | REST | Юридически значимый ЭДО с российскими контрагентами, роуминг между операторами |
| СБИС | КЭП, УНЭП | REST | ЭДО + бухгалтерия, удобно для компаний, уже работающих в экосистеме Тензор |
| КриптоПро DSS | КЭП | REST | Облачная подпись без локального CSP — ключ хранится на сервере |
| DocuSign | AES, QES (eIDAS) | REST | Международный документооборот, работа с зарубежными партнёрами |
Для обмена формализованными документами (УПД, счета-фактуры) с российскими контрагентами — Диадок или СБИС. Для внутреннего подписания без токенов — КриптоПро DSS. Для международных контрактов — DocuSign. Облачная подпись через API в 3 раза быстрее традиционной — не нужно ждать курьера или сканировать бумаги.
Как устроена интеграция Битрикс24 с сервисами электронной подписи?
Общая схема одинакова для всех сервисов, различается только API:
- Документ формируется в Битрикс24 через генератор документов (
crm.documentgenerator). - Обработчик извлекает файл через REST API Битрикс24 и передаёт в сервис ЭП.
- Сервис запускает маршрут подписания — уведомляет подписантов.
- Подписанты работают в интерфейсе сервиса ЭП (или в мобильном приложении).
- Webhook от сервиса сообщает о завершении.
- Подписанный документ + файл подписи загружаются обратно в Битрикс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 посреди рабочего дня.
Отправка документа на подпись
- Получить файл из Битрикс24:
crm.documentgenerator.document.get. - Определить ящик организации:
GET /GetMyOrganizations. - Найти контрагента в Диадоке:
GET /GetCounteragent?myOrgId={id}&counteragentOrgId={id}. - Для формализованных документов (УПД, акт, счёт-фактура) —
POST /GenerateTitleXml, Диадок требует XML в формате ФНС. - Отправить:
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 на каждый компьютер. Компании, внедрившие облачный ЭДО, экономят до 500 000 рублей в год на курьерских службах и расходных материалах.
Уведомления и автоматизация воронки
Согласно Wikipedia: Электронная подпись, юридическая значимость обеспечивается сертификатом КЭП.
Каждое изменение статуса документа в сервисе ЭП транслируется в Битрикс24:
- Уведомление в чат (
im.notify.system.add) — ответственному менеджеру - Перевод стадии сделки (
crm.deal.update) — автоматически при подписании обеими сторонами - Комментарий в таймлайне (
crm.timeline.comment.add) — запись с деталями события - Задача при отказе (
tasks.task.add) — менеджеру на доработку документа
Менеджер не следит за статусами вручную — система сама уведомляет и двигает сделку по воронке.
Что входит в работу при заказе интеграции?
- Анализ требований и выбор сервиса
- Настройка API-ключей и тестового контура
- Разработка обработчиков отправки и приёма webhooks
- Интеграция кнопки «Отправить на подпись» в карточку сделки
- Создание скриптов для многопользовательских маршрутов
- Полное тестирование с реальными документами и контрагентами
- Подготовка документации и обучение пользователей
- Техническая поддержка в течение 30 дней после запуска
Этапы внедрения
| Этап | Что делаем | Срок |
|---|---|---|
| Анализ требований | Выбор сервиса, сравнение API, юридические аспекты | 2–3 дня |
| Настройка сервиса | Получение API-ключей, регистрация ящиков, тестовый контур | 1–2 дня |
| Разработка обработчиков | Отправка документов, приём webhooks, маппинг статусов, очередь задач | 5–7 дней |
| Интеграция с CRM | Кнопка «Отправить на подпись» в карточке сделки, автоматизация воронки | 3–4 дня |
| Маршруты подписания | Цепочки согласования, параллельные и последовательные ветки | 2–3 дня |
| Тестирование | Полный цикл с тестовым контрагентом, отказы, повторные отправки, edge-кейсы | 3–5 дней |
Облачная электронная подпись через внешний сервис убирает зависимость от конкретного компьютера. Менеджер отправляет документ из карточки сделки, контрагент подписывает в интерфейсе оператора ЭДО, подписанная версия автоматически возвращается в CRM. Без токенов на каждом рабочем месте, без сканера, без ожидания курьера. Получите консультацию по вашему проекту — оценим объём работ за один день.