Автоматизація ЕДО: інтеграція Бітрікс24 і Контур.Діадок
Навіщо автоматизувати ЕДО в Бітрікс24
Менеджер закриває угоду, створює рахунок-фактуру в 1С, завантажує PDF, завантажує в Діадок, підписує КЕП, відправляє контрагенту. Паралельно прикріплює копію в CRM вручну. Через тиждень — ще один акт, потім УПД. На 50 угодах на місяць це рутина, яка з'їдає два робочих дні менеджера (до 40 годин). Помилки при ручному введенні зустрічаються в 7% випадків — неправильний ІПН, не та ставка ПДВ, втрата PDF. Автоматизація знижує кількість помилок на 95% (з 7% до 0.35%) та скорочує час на відправку одного документа з 15 хвилин до 2 хвилин (на 87%). Ми допомагаємо компаніям автоматизувати ланцюжок: документ формується з CRM, йде в ЕДО, підписується, а статус повертається назад в угоду. Інтеграція Бітрікс24 з Контур.Діадок — це не просто підключення API, а налаштування повного циклу: від мапінгу реквізитів до серверного підпису та обробки вхідних. Автоматизація скорочує час на документообіг у 5 разів порівняно з ручним копіюванням, а при середній ставці менеджера 1500 грн/год економія сягає 60 000 грн на місяць. При збільшенні обсягу до 100 документів економія зростає до 120 000 грн на місяць.
Які проблеми вирішує інтеграція
- Втрата часу — ручна передача даних з CRM в Діадок займає до 15 хвилин на документ. При 50 документах на місяць це 12,5 годин чистої рутини.
- Помилки в реквізитах — невірний ІПН, ставка ПДВ, сума призводять до відмов контрагентів і повторної відправки. Автоматизація виключає людський фактор.
- Відсутність єдиного вікна — менеджеру доводиться перемикатися між CRM і Діадоком, відстежувати статуси вручну. Статуси повертаються в угоду автоматично.
Архітектура інтеграції: компоненти та обмін даними
Зв'язка Б24 з Контур.Діадок реалізується через Diadoc API. Основні компоненти:
| Компонент | Роль |
|---|---|
| Бітрікс24 CRM | Джерело даних: реквізити компанії, суми, номенклатура з угоди |
| Middleware (серверний обробник) | Формує XML-документ за стандартом ФНС, відправляє в Diadoc API |
| Diadoc API | Приймає документ, маршрутизує контрагенту, управляє підписанням |
| КЕП (CryptoPro CSP / VipNet) | Підпис документа на стороні відправника |
Middleware може бути реалізований на PHP або Node.js. Приклад базового виклику Diadoc API для відправки документа:
// Пример отправки документа через Diadoc API (REST) $apiUrl = 'https://diadoc-api.kontur.ru/'; $authToken = 'ваш_токен_авторизации'; $boxId = 'id_ящика_организации'; $document = [ 'Document' => [ 'DocumentType' => 'Invoice', 'Content' => base64_encode($xmlContent), 'FileName' => 'invoice_123.xml' ] ]; $ch = curl_init($apiUrl . 'V2/Documents'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: DiadocAuth ddauth_api_client_id=' . $authToken, 'Content-Type: application/json' ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($document)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); Детальніше: документація Diadoc API
Прямого коннектора з коробки немає. Інтеграція реалізується через готовий додаток з Маркетплейсу Б24 (якщо підходить під сценарій), кастомну розробку middleware або iPaaS-платформу (Albato, Make) — остання не підходить, якщо потрібен строгий XML ФНС.
Які документи можна відправляти з CRM?
З угоди автоматично формуються формалізовані документи (УПД, рахунок-фактура) та неформалізовані (акти, договори). Дані беруться з угоди та пов'язаних сутностей:
- Реквізити продавця — з налаштувань компанії в Б24 (ІПН, код ЄДРПОУ, адреса, р/р).
- Реквізити покупця — з картки компанії/контакту в CRM.
- Номенклатура — з товарних позицій угоди (назва, кількість, ціна, ПДВ).
- Суми — підсумок, ПДВ, до оплати — розраховуються автоматично.
Middleware формує XML у форматі ФНС для рахунків-фактур і УПД, для актів і договорів — PDF або довільний XML.
Як налаштувати автоматичне підписання з CRM?
Підписання документа в Діадоку вимагає КЕП. Варіанти:
- Через інтерфейс Діадока. Менеджер натискає кнопку в CRM, документ створюється в Діадоку, менеджер підписує КЕП. Статус повертається через API.
- Через серверний підпис. CSP встановлено на сервері, документ підписується автоматично сертифікатом організації. Підходить для масової відправки (десятки документів на день). Автоматичне підписання через сервер у 3 рази швидше, ніж ручне підписання.
- Через хмарний підпис Контура. КЕП зберігається в хмарі Контура, підписання через API без локального CSP.
Статуси документа та зворотний зв'язок у CRM
Після відправки документ проходить стадії: Відправлено → Доставлено → Підписано / Відхилено → Анульовано. Статуси передаються назад у Б24 через polling API або події. У картці угоди оновлюється користувацьке поле «Статус ЕДО», при підписанні обома сторонами робот переводить угоду на наступну стадію.
Робота з вхідними документами від контрагентів
Контрагент відправляє документ через Діадок. Інтеграція перехоплює його, створює активність в CRM з прив'язкою до компанії, прикріплює PDF, сповіщає менеджера. Після підписання з боку компанії статус оновлюється.
Терміни впровадження
| Масштаб | Що входить | Термін |
|---|---|---|
| Базовий | Відправка неформалізованих документів, ручне підписання | 1–2 тижні |
| Стандартний | Формалізовані документи, автоформування з угоди, повернення статусів | 2–4 тижні |
| Розширений | Серверний підпис, обробка вхідних, інтеграція з 1С + Б24 + Діадок | 4–6 тижнів |
Що входить у проект інтеграції
Наша команда реалізувала більше 30 проектів інтеграції з Контур.Діадок. Ми гарантуємо безперебійну роботу інтеграції. Використовуємо сертифіковані рішення CryptoPro CSP. Маємо досвід понад 30 проектів. У проект входить:
- Підключення Diadoc API: авторизація, отримання токена, налаштування ящика організації.
- Мапінг реквізитів: компанія та контакт в CRM → реквізити продавця/покупця.
- Формування документів з CRM: УПД, акти, рахунки-фактури на основі даних угоди.
- Налаштування підписання: інтеграція з CryptoPro (локальна або серверна), хмарний підпис Контура.
- Повернення статусів: оновлення полів угоди, автоматичний перехід стадії.
- Обробка вхідних: сповіщення, прив'язка до угоди, підписання.
- Навчання менеджерів: відправка документа з CRM, відстеження статусу, обробка відхилень.
Бажаєте автоматизувати документообіг? Залиште заявку на аудит поточного процесу — ми підберемо оптимальну архітектуру. Отримайте консультацію з налаштування інтеграції Бітрікс24 з Контур.Діадок.