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