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