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