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

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

Ми налаштовуємо middleware, який зв'язує Бітрікс24 і Контур.Бухгалтерію через REST API. За 5-10 днів налаштовуємо обмін: контрагенти, рахунки, оплати, закриваючі документи. Ручна обробка однієї угоди займає до 15 хвилин, автоматизована — 2-3 секунди. Автоматизація скорочує витрати на створення рахунку з $2–3ів до $1–1ів — економія до $2.7k–3.9kів на рік при 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);
}