Интеграция Битрикс24 с Контур.Бухгалтерия под ключ

Менеджер закрывает сделку в CRM, бухгалтер узнаёт об этом из мессенджера — так теряется время. Приходится вручную создавать счёт в Контур.Бухгалтерии, сверять реквизиты контрагента с карточкой CRM, следить за оплатой в банковской выписке и возвращаться в Битрикс24. На каждую сделку уходит 3-5 переключений между системами. При 50+ сделках в неделю — гарантированные потери: забытые счета, задвоенные контрагенты, ошибки в реквизитах.

Мы настраиваем middleware, который связывает Битрикс24 и Контур.Бухгалтерию через REST API. За 5-10 дней настраиваем обмен: контрагенты, счета, оплаты, закрывающие документы. Ручная обработка одной сделки занимает до 15 минут, автоматизированная — 2-3 секунды. Автоматизация сокращает затраты на создание счёта с 250 рублей до 5 рублей — экономия до 300 000 рублей в год при 100 сделках.

Как устроена интеграция Битрикс24 с Контур.Бухгалтерией?

Контур.Бухгалтерия предоставляет REST API для работы с контрагентами, счетами и документами. Битрикс24 — REST API и механизм вебхуков. Связка строится через промежуточный сервис (middleware), который слушает события Битрикс24 и отправляет запросы в Контур.

1. Слушает события Битрикс24 — переход сделки на стадию «Выставить счёт» генерирует вебхук.
2. Запрашивает данные — из карточки сделки и связанного контакта/компании забирает реквизиты, сумму, перечень товаров.
3. Создаёт или находит контрагента в Контуре — по ИНН. Если контрагент новый — создаёт карточку.
4. Формирует счёт — с позициями, суммами, НДС.
5. Возвращает номер счёта — записывает в пользовательское поле сделки в Б24.

Обратный поток: middleware периодически (или по вебхуку от Контура) проверяет статусы оплат и обновляет стадии сделок в CRM.

Как избежать дублей контрагентов? — интеграция битрикс24 с

Контрагенты — точка наибольшего трения. В CRM менеджер может создать компанию с минимальными данными (название + телефон), а бухгалтерии нужны полные реквизиты: ИНН, КПП, юридический адрес, банковские данные.

Решаем двумя механизмами:

• Автозаполнение по ИНН. В карточке компании Битрикс24 менеджер вводит ИНН — скрипт обращается к сервису Контур.Фокус (или DaData) и подтягивает все реквизиты. Данные сразу валидны для бухгалтерии.
• Обратная синхронизация. Если бухгалтер добавил контрагента в Контуре (например, поставщика), middleware создаёт соответствующую компанию в CRM с заполненными реквизитами.

Сопоставление записей — по ИНН. Дубли отслеживаются при каждой синхронизации: если в Б24 две компании с одним ИНН — интеграция логирует конфликт и не создаёт дубль в Контуре.

Что делать при ошибках синхронизации?

Middleware логирует каждую операцию: запрос, ответ, результат. При ошибке API (таймаут, невалидные данные, лимит запросов) — три повторные попытки с нарастающей задержкой. Если не помогло — уведомление администратору в чат Битрикс24.

Типичные ошибки:

• Невалидный ИНН — контрагент в CRM создан с ошибкой. Интеграция проверяет контрольную сумму ИНН перед отправкой.
• Несоответствие номенклатуры — товар в CRM не найден в справочнике Контура. Решение: маппинг номенклатуры при первичной настройке.
• Дубль платежа — одна и та же выписка обработана дважды. Решение: дедупликация по номеру платёжного поручения и дате.

Ручной процесс против автоматизации: что эффективнее?

Этапы внедрения интеграции

Что входит в работу

• Проектирование middleware — под вашу CRM-архитектуру и бизнес-процессы.
• Настройка REST API — для Битрикс24 и Контур.Бухгалтерии.
• Карта маппинга данных — контрагенты, номенклатура, счета.
• Тестирование — 3 дня пилотного запуска с вашими данными.
• Документация — описание всех сценариев и точек отказа.
• Обучение — 2-часовой вебинар для менеджеров и бухгалтеров.
• Поддержка — 30 дней после запуска (исправление ошибок, донастройка).

Безопасность и мониторинг

Данные между системами передаются по HTTPS. Токены API хранятся в переменных окружения на сервере middleware, не в коде. Доступ к middleware ограничен по IP-адресам серверов Битрикс24 и Контура. Логи с персональными данными ротируются — хранение не более 90 дней.

Настраиваем интеграцию под конкретный бизнес-процесс компании: от минимальной связки «счёт → оплата» до полного цикла документооборота с ЭДО.

// Пример обработчика вебхука на PHP $event = json_decode(file_get_contents('php://input'), true); if ($event['event'] === 'ON_CRM_DEAL_UPDATE' && $event['data']['FIELDS']['STAGE_ID'] === 'C7:NEW') { $dealId = $event['data']['FIELDS']['ID']; // Получаем данные сделки через REST $deal = $this->bitrix24->call('crm.deal.get', ['id' => $dealId]); // Создаём счёт в Контуре $this->kontur->createInvoice($deal); }