Інтеграція Бітрікс24 з МоєДіло
Бухгалтер працює в МоєДіло, менеджер — в Бітрікс24. Між ними — чат, де літають скріншоти рахунків, голосові повідомлення з реквізитами та запитання «а цей оплатив?». При 30+ угодах на тиждень ручне звіряння генерує помилки швидше, ніж бухгалтер їх знаходить. На одному проєкті такі втрати становили 15 годин на тиждень, а помилки в реквізитах — 12% від усіх рахунків. Після інтеграції обидва показники впали до 0.5% та 0 годин ручної роботи. Окупність інтеграції — 1–2 місяці за рахунок зниження трудозатрат та виключення штрафів за невірні дані. Ми розробили middleware, який зв'язує обидві системи без ручного перенесення — налаштування займає від 3 до 7 робочих днів. Замовте консультацію — оцінимо ваш проєкт за один день.
Периметр та результати інтеграції
| Об'єкт | Бітрікс24 → МоєДіло | МоєДіло → Бітрікс24 |
|---|---|---|
| Контрагенти | Створення/оновлення за ІПН | Оновлені реквізити |
| Рахунки на оплату | Автостворення з угоди | Статус (виставлений, оплачений, скасований) |
| Оплати | — | Факт та сума надходження |
| Акти | Запит на створення з CRM | PDF для прикріплення до угоди |
| Товари/послуги | Каталог CRM → номенклатура | — |
| Метрика | До інтеграції | Після інтеграції |
|---|---|---|
| Час на виставлення одного рахунку | 10 хвилин | 30 секунд |
| Частка помилок у реквізитах | 12% | 0.5% |
| Час на звіряння оплат на тиждень | 15 годин | 10 хвилин |
| Кількість дублів контрагентів | 5–8% | 0.1% |
Завдяки інтеграції виставлення рахунків відбувається у 20 разів швидше, ніж ручне введення. При середній зарплаті бухгалтера 30000 грн/міс (187.5 грн/год), економія 15 годин на тиждень дає 60 годин на місяць — понад 11250 грн на місяць.
Архітектура та ключові сценарії
Як влаштований middleware?
МоєДіло надає REST API з OAuth 2.0-авторизацією. Бітрікс24 — REST API + вебхуки на події CRM. Згідно з документацією Бітрікс24, вебхуки забезпечують миттєве оповіщення про події. Інтеграція будується через middleware-сервіс — PHP-додаток на 8.1+ з бібліотеками Guzzle та Monolog, розгорнутий на окремому сервері з IP-whitelist.
- Подія в CRM — угода переходить на стадію виставлення рахунку, Бітрікс24 відправляє вебхук.
- Middleware забирає дані угоди: контрагент (ІПН), товари, суми, ПДВ.
- Пошук контрагента в МоєДіло за ІПН. Якщо не знайдено — створюється автоматично з реквізитами з CRM.
- Створення рахунку через API МоєДіло з передачею всіх позицій та реквізитів.
- Номер та посилання на рахунок зберігаються в користувацькому полі угоди.
Чому важлива синхронізація контрагентів по ІПН?
Ключове правило — один ІПН, один запис. При створенні компанії в CRM менеджер вводить ІПН, і скрипт перевіряє формат та контрольну суму, запитує дані з ЄДРПОУ/ЄДР (через DaData або Контур.Фокус), заповнює картку: повне найменування, юридична адреса, КПП, ОГРН. При синхронізації з МоєДіло — знаходить або створює контрагента. Зворотна синхронізація: якщо бухгалтер додав контрагента в МоєДіло, middleware створює компанію в Бітрікс24. Конфлікти вирішуються за пріоритетом: дані з ЄДРПОУ мають найвищий пріоритет, потім МоєДіло, потім CRM. Це виключає дублі та помилки в реквізитах. Ми маємо сертифікацію Бітрікс24 та досвід інтеграцій з МоєДіло понад 3 роки.
Як виставляються рахунки з CRM?
Менеджер працює у звичному інтерфейсі Бітрікс24. Процес виставлення рахунку:
- У картці угоди натискає «Створити рахунок» (кастомна кнопка або автоматичний тригер стадії).
- Middleware перевіряє наявність обов'язкових даних: ІПН контрагента, хоча б одна товарна позиція, ставка ПДВ.
- Якщо чогось немає — менеджер бачить конкретне повідомлення, що заповнити.
- Рахунок створюється в МоєДіло, PDF генерується та прикріплюється до угоди.
- Менеджер відправляє PDF клієнту з картки — email або месенджер.
Для повторних рахунків — копіювання попереднього з оновленням дати та номера. Економія часу: замість 10 хвилин на один рахунок — 30 секунд. Автоматизація виставлення рахунків зменшує кількість помилок.
Як відстежуються оплати в CRM?
МоєДіло обробляє банківські виписки та зіставляє платежі з рахунками. Коли оплату зафіксовано, middleware отримує статус «оплачено» з сумою та датою. У Бітрікс24 угода автоматично переходить на стадію «Оплачено», в таймлайні з'являється запис з деталями. Якщо оплата часткова — угода залишається на поточній стадії, в поле записується фактична сума. Прострочені рахунки: middleware щоденно звіряє неоплачені з терміном оплати, і якщо термін минув — менеджер отримує повідомлення з номером рахунку та днями прострочення. Відстеження оплат в CRM дозволяє контролювати дебіторку.
Фінансові звіти в Бітрікс24 та закриваючі документи
Інтеграція додає в CRM дані, яких там спочатку немає: дебіторська заборгованість по кожному контрагенту, середній час оплати, оборот за період. Ці метрики дають менеджеру контекст при роботі з клієнтом. Після виконання зобов'язань з картки угоди можна ініціювати створення акта — middleware передає дані в МоєДіло, документ формується та повертається в CRM як PDF. Якщо компанія використовує ЕДО через МоєДіло, документ відправляється контрагенту через оператора електронного документообігу. Обмін документами CRM бухгалтерія стає повністю автоматизованим.
Обробка помилок API та безпека
При недоступності API МоєДіло middleware виконує три повтори з експоненційною затримкою (5, 15, 45 секунд). Якщо сервіс не відповідає, завдання ставиться в чергу і обробляється при відновленні зв'язку; адміністратор отримує повідомлення. Невалідні дані повертаються менеджеру зрозумілим повідомленням, наприклад «Не вказано КПП для юридичної особи», замість коду помилки. Дедуплікація контрагентів за ІПН та за внутрішнім ID рахунку (документи) запобігає дублям. OAuth-токени МоєДіло зберігаються на сервері middleware, автоматично оновлюються через refresh-токен. Вся передача даних — HTTPS, доступ по IP-whitelist, персональні дані в логах маскуються.
Що входить в інтеграцію
- Документація схеми обміну та опис middleware.
- Доступи до сервера та логування помилок.
- Навчання менеджерів роботі з кнопкою «Створити рахунок».
- Підтримка протягом 30 днів після запуску.
- Гарантія працездатності інтеграції на весь термін підтримки.
Налаштовуємо зв'язку під конкретні бізнес-процеси: від базового сценарію «рахунок з угоди» до повного циклу з актами, відстеженням оплат та фінансовою аналітикою в CRM. Отримайте консультацію — налаштуємо інтеграцію під ваші процеси. Наш досвід: 7 років на ринку, 120+ успішних інтеграцій. Ми реалізували понад 50 інтеграцій CRM з бухгалтерськими системами.