Установлювати КриптоПро CSP на кожен ноутбук, роздавати токени, ловити баги browser plug-in після оновлень — знайомий біль для будь-якого керівника. В середньому компанія витрачає 2-3 дні на підписання одного документа через кур'єра, а хмарний підпис скорочує цей час до 3-5 хвилин. Витрати на кур'єрські служби можна значно знизити. В середньому компанія обробляє від 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 на кожен комп'ютер. Компанії, які впровадили хмарний ЕДО, значно скорочують витрати на кур'єрські служби та витратні матеріали.
Сповіщення та автоматизація воронки
Згідно з 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. Без токенів на кожному робочому місці, без сканера, без очікування кур'єра. Отримайте консультацію щодо вашого проєкту — оцінимо обсяг робіт за один день.