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