Інтеграція Bitrix24 з МоёДело
Бухгалтер працює в МоёДело, менеджер — у Bitrix24. Між ними — чат, де летають скриншоти рахунків, голосові повідомлення з реквізитами та питання «а цей оплатив?». Кожен день починається з ручної сверки: хто оплатив, кому повторити рахунок, який контрагент змінив реквізити. При 30+ угодах на тиждень такий процес генерує помилки швидше, ніж бухгалтер їх знаходить.
Інтеграція Bitrix24 з сервісом МоёДело пов'язує CRM та бухгалтерію в єдиний потік даних — без ручного перенесення.
Периметр інтеграції
| Об'єкт | Bitrix24 → МоёДело | МоёДело → Bitrix24 |
|---|---|---|
| Контрагенти | Створення/оновлення за ІНН | Оновлені реквізити |
| Рахунки на оплату | Автостворення з угоди | Статус (виставлено, оплачено, скасовано) |
| Оплати | — | Факт та сума поступлення |
| Акти | Запит на створення з CRM | PDF для прикріплення до угоди |
| Товари/послуги | Каталог CRM → номенклатура | — |
Як улаштована зв'язка
МоёДело надає REST API з OAuth 2.0-авторизацією. Bitrix24 — REST API + вебхуки на події CRM. Інтеграція будується через middleware-сервіс:
- Подія в CRM. Угода переходить на стадію виставлення рахунку — Bitrix24 відправляє вебхук.
- Middleware обробляє запит. Отримує дані угоди: контрагент (ІНН), товари, суми, ПДВ.
- Пошук контрагента в МоёДело. За ІНН. Якщо не знайдено — створюється автоматично з реквізитами з CRM.
- Створення рахунку. Через API МоёДело з передачею всіх позицій та реквізитів.
- Зворотна запис. Номер та посилання на рахунок зберігаються у користувацькому полі угоди.
Синхронізація контрагентів
Ключове правило: один ІНН — одна запис. При створенні компанії в CRM менеджер вводить ІНН, і скрипт:
- Перевіряє формат та контрольну суму ІНН.
- Запитує дані з ЕГРЮЛ/ЕГРІП (через DaData або Контур.Фокус).
- Заповнює карточку: повне найменування, юридична адреса, КПП, ОГРН.
- При синхронізації з МоёДело — знаходить або створює контрагента.
Зворотна синхронізація: якщо бухгалтер додав контрагента в МоёДело (наприклад, постачальника), middleware створює компанію в Bitrix24.
Конфлікти вирішуються за приоритетом: дані з ЕГРЮЛ — найвищий приоритет, потім МоёДело, потім CRM.
Виставлення рахунків з CRM
Менеджер працює в привичному інтерфейсі Bitrix24. Процес виставлення рахунку:
- У карточці угоди натискає «Створити рахунок» (користувацька кнопка або автоматичний триггер стадії).
- Система перевіряє наявність обов'язкових даних: ІНН контрагента, хоча б одна товарна позиція, ставка ПДВ.
- Якщо чогось немає — менеджер бачить конкретне сповіщення, що заповнити.
- Рахунок створюється в МоёДело, PDF генерується та прикріплюється до угоди.
- Менеджер відправляє PDF клієнту з карточки — email або месенджер.
Для повторних рахунків — копіювання попереднього з оновленням дати та номера.
Відстеження оплат
МоёДело обробляє банківські виписки та зіставляє платежі з рахунками. Коли оплата зафіксована:
- Middleware отримує статус «оплачено» з сумою та датою.
- У Bitrix24 угода автоматично переходить на стадію «Оплачено».
- У таймлайні угоди з'являється запис з деталями платежу.
- Якщо оплата часткова — угода залишається на поточній стадії, в полі записується фактично оплачена сума.
Прострочені рахунки: middleware щодня зіставляє неоплачені рахунки зі сроком оплати. Якщо строк пройшов — менеджеру приходить сповіщення в Bitrix24 з номером рахунку та кількістю днів просрочки.
Фінансові звіти в CRM
Інтеграція додає в Bitrix24 дані, яких там спочатку немає:
- Дебіторська заборгованість — сума неоплачених рахунків по кожному контрагенту. Виводиться у карточці компанії.
- Середній час оплати — скільки днів у середньому контрагент платить після виставлення рахунку. Допомагає оцінити платіжну дисципліну.
- Оборот по контрагенту — сумарна виручка за період. Дані з МоёДело, відображення в CRM.
Ці метрики не замінюють повноцінну бухгалтерську звітність, але дають менеджеру контекст при роботі з клієнтом.
Закриваючі документи
Після виконання зобов'язань потрібен акт або накладна. Зі карточки угоди менеджер ініціює створення акта — middleware передає дані в МоёДело, документ формується та повертається в CRM як PDF.
Якщо компанія використовує ЕДО через МоёДело — документ відправляється контрагенту через оператора електронного документообігу.
Обробка помилок
- API МоёДело недоступна — три повтори з експоненціальною затримкою (5, 15, 45 секунд). Якщо не допомогло — задача ставиться в чергу та обробляється при відновленні зв'язку. Адміністратор отримує сповіщення.
- Невалідні дані — помилка повертається менеджеру в зрозумілому вигляді: «Не вказано КПП для юридичної особи» замість коду помилки API.
- Дублі — дедупліція за ІНН (контрагенти) та за внутрішнім ID рахунку (документи).
Безпека
OAuth-токени МоёДело зберігаються на сервері middleware, оновлюються автоматично за refresh-токеном. Передача даних — HTTPS. Доступ до middleware — за IP-whitelist. Особисті дані в логах маскуються (ІНН — так, ПІБ — ні).
Налаштовуємо зв'язку під конкретні бізнес-процеси: від базового сценарію «рахунок з угоди» до повного циклу з актами, відстеженням оплат та фінансовою аналітикою в CRM.