Інтеграція Бітрікс24 з сервісами електронного підпису

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

Сповіщення та автоматизація воронки

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

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

Менеджер не стежить за статусами вручну — система сама повідомляє і рухає угоду по воронці.

Що входить в роботу при замовленні інтеграції?

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

Етапи впровадження

Хмарний електронний підпис через зовнішній сервіс прибирає залежність від конкретного комп'ютера. Менеджер відправляє документ з картки угоди, контрагент підписує в інтерфейсі оператора ЕДО, підписана версія автоматично повертається в CRM. Без токенів на кожному робочому місці, без сканера, без очікування кур'єра. Отримайте консультацію щодо вашого проєкту — оцінимо обсяг робіт за один день.