Інтеграція Bitrix24 з Контур.Діадок
Менеджер закриває угоду, створює рахунок у 1С, завантажує PDF, завантажує у Діадок, підписує ЕЦП, відправляє контрагенту. Паралельно вручну прикріпляє копію в CRM. Через тиждень — ще один акт. І ще один УПД. На 50 угодах на місяць це перетворюється на рутину, яка з'їдає два робочих дні. Інтеграція B24 з Контур.Діадок автоматизує ланцюг: документ формується з CRM, йде в ЕДО, підписується, а статус повертається назад в угоду.
Що таке Контур.Діадок
Контур.Діадок — оператор електронного документообігу (ЕДО) від СКБ Контур. Через нього юридичні особи обмінюються юридично значимими документами: рахунками-фактурами, актами, УПД, товарними накладними, договорами. Документи підписуються кваліфікованою електронною підписом (КЕП) та мають ту саму юридичну силу, що й паперові оригіналу.
Типи документів, які передаються через Діадок:
- Рахунок-фактура — для вирахування ПДВ
- УПД (універсальний передавальний документ) — замінює рахунок-фактуру + акт/накладну
- Акт виконаних робіт — підтвердження надання послуг
- Товарна накладна (Торг-12) — товарна накладна
- Договір — довільний документ з підписанням обома сторонами
Архітектура інтеграції
Зв'язка B24 + Діадок працює через Diadoc API (REST). Основні компоненти:
| Компонент | Роль |
|---|---|
| Bitrix24 CRM | Джерело даних: реквізити компанії, суми, номенклатура з угоди |
| Middleware (серверний обробник) | Формує XML-документ за стандартом ФНС, відправляє в Diadoc API |
| Diadoc API | Приймає документ, маршрутизує контрагенту, управляє підписанням |
| КЕП (CryptoPro / VipNet) | Підпис документа на стороні відправника |
Прямого коннектора «B24 → Діадок» з коробки немає. Інтеграція реалізується через:
- Готове додаток з Маркетплейсу B24 — якщо існує підходяча, що охоплює сценарій.
- Користувацьку розробку — серверний скрипт (PHP/Node.js), який по вебхуку з B24 формує документ та відправляє через Diadoc API.
- iPaaS-платформу (Albato, Make) — якщо не потрібно формування XML за стандартом ФНС.
Формування документа з CRM
Дані для документа беруться з угоди та пов'язаних сутностей:
- Реквізити продавця — з налаштувань компанії у B24 (ІНН, КПП, адреса, р/с).
- Реквізити покупця — з карточки компанії/контакту в CRM.
- Номенклатура — з товарних позицій угоди (назва, кількість, ціна, ПДВ).
- Суми — разом, ПДВ, до оплати — розраховуються автоматично.
Middleware формує XML у форматі, необхідному ФНС (для рахунків-фактур та УПД — формалізований формат). Для актів та договорів — неформалізований формат (PDF або довільний XML).
Процес підписання
Підписання документа у Діадоці вимагає КЕП. Варіанти підписання з B24:
- Через інтерфейс Діадока. Менеджер натискає кнопку в CRM → документ створюється у Діадоці → менеджер переходить у Діадок, підписує КЕП. Статус повертається в B24 через API.
- Через серверну підпис. CryptoPro CSP встановлений на сервері. Документ підписується автоматично сертифікатом організації. Підходить для масової відправки (десятки документів на день).
- Через хмарну підпис Контур. КЕП зберігається в хмарі Контура — підписання відбувається через API без локальної установки CryptoPro.
Статуси документа та зворотний зв'язок у CRM
Після відправки документ у Діадоці проходить стадії:
- Відправлено — документ пішов контрагенту
- Доставлено — контрагент отримав документ
- Підписано — контрагент підписав своєю КЕП
- Відхилено — контрагент відмовився підписувати (з коментарем)
- Аннульовано — одна зі сторін ініціювала аннулювання
Статуси передаються назад в B24 через polling Diadoc API (періодичний опит) або через механізм подій. У карточці угоди оновлюється користувацьке поле «Статус ЕДО», а при підписанні обома сторонами — бот переводить угоду на наступну стадію.
Робота з вхідними документами
Контрагент відправляє документ через Діадок. Інтеграція перехоплює та:
- Створює активність (подію) в CRM з прив'язкою до компанії контрагента.
- Прикріпляє PDF-версію документа до карточки угоди.
- Сповіщує відповідального менеджера.
- Після підписання зі сторони компанії — оновлює статус.
Терміни впровадження
| Масштаб | Що входить | Термін |
|---|---|---|
| Базовий | Відправка неформалізованих документів (акти, договори) з CRM у Діадок, ручне підписання | 1-2 тижні |
| Стандартний | Формалізовані документи (УПД, рахунок-фактура), автоматичне формування з угоди, повернення статусів | 2-4 тижні |
| Розширений | Серверна підпис, обробка вхідних документів, інтеграція 1С + B24 + Діадок | 4-6 тижнів |
Що налаштовуємо
- Підключення Diadoc API: авторизація, отримання токена, налаштування ящика організації
- Маппінг реквізитів: компанія та контакт у CRM → реквізити продавця/покупця у документі
- Формування документів з CRM: УПД, акти, рахунки-фактури на основі даних угоди
- Налаштування підписання: інтеграція з CryptoPro (локальна або серверна), хмарна підпис Контур
- Повернення статусів з Діадока в CRM: оновлення полів угоди, автоматичний перевід стадії
- Обробка вхідних документів: сповіщення, прив'язка до угоди, підписання
- Навчання менеджерів: відправка документа з CRM, відстеження статусу, обробка відхилень