Інтеграція Bitrix24 з Эльбою
ІП та невеликі компанії на упрощенці ведуть облік в Эльбі, а продажі — в Bitrix24. Зв'язок між системами зазвичай виглядає так: менеджер закрив угоду, написав бухгалтеру, бухгалтер вручну створив рахунок, скинув PDF, менеджер переслав клієнту. Через два дні — «а оплатили?» — бухгалтер лізе в банківську виписку. Множимо на 20 угод на тиждень та отримуємо процес, який з'їдає час обох.
Інтеграція Bitrix24 з Эльбою автоматизує маршрут «угода → рахунок → оплата → закриваючий документ».
Що пов'язуємо
| Дані | Bitrix24 → Эльба | Эльба → Bitrix24 |
|---|---|---|
| Контрагенти | Створення за ІНН з карточки CRM | Оновлені реквізити |
| Рахунки | Автоматична генерація з угоди | Статус (виставлено / оплачено / прострочено) |
| Оплати | — | Факт поступлення з сумою та датою |
| Акти | Запит на створення | PDF документа |
| Товари | Позиції з угоди CRM | — |
Архітектура
Эльба надає API для роботи з контрагентами, рахунками та платежами. Інтеграція будується через проміжний сервіс:
- Bitrix24 → вебхук при переході угоди на потрібну стадію.
- Middleware → обробляє подію, збирає дані, відправляє запит в Эльбу.
- Эльба → створює об'єкт (контрагент, рахунок), повертає результат.
- Middleware → записує результат назад у CRM.
Для зворотного потоку (оплати, статуси) — middleware опитує API Эльби за розписанням або обробляє callback, якщо Эльба його підтримує.
Автоматичне створення рахунків з угод
Головний сценарій інтеграції. Менеджер працює тільки в Bitrix24:
- Угода переходить на стадію «Виставити рахунок» — триггер відправляє дані в middleware.
- Middleware перевіряє: є ли ІНН контрагента, заповнені ли товарні позиції, вказана ли ставка ПДВ (або «без ПДВ» для УСН).
- Контрагент шукається в Эльбі за ІНН. Не знайдено — створюється.
- Рахунок формується в Эльбі: номер, дата, позиції, загальна сума.
- PDF рахунку генерується та прикріплюється до угоди в Bitrix24.
- Менеджер відправляє PDF клієнту зі карточки угоди.
Для ІП на УСН «доходи» ПДВ не нараховується — інтеграція врахує систему оподаткування та не додасть рядок ПДВ в рахунок.
Контрагенти: сверка та дедупліція
Правило: один ІНН — одна запис у кожній системі. При першій синхронізації:
- З Bitrix24 вивантажуються всі компанії з заповненим ІНН.
- В Эльбі шукаються збіги.
- Знайдені пари пов'язуються через внутрішній ID.
- Компанії без пари — створюються в цільовій системі.
При подальшій роботі: кожне створення або змінення компанії в CRM перевіряється на наявність пари. Якщо ІНН змінився (помилка вводу, інше юрлиці) — пересопоставлення.
Согласування оплат
Эльба підключається до банку через API та отримує виписки. Коли платіж зіставлено з рахунком:
- Middleware отримує інформацію: рахунок № 127 оплачено, сума 85 000₽, дата 12.03.2026.
- У Bitrix24 угода переходить на стадію «Оплата отримана».
- У таймлайні — запис з деталями платежу.
- При частковій оплаті — сума записується в поле «Оплачено», угода залишається на поточній стадії.
Неоплачені рахунки з истіклим сроком — автоматичне сповіщення менеджеру. Налаштовується період: наприклад, через 3 та 7 днів після строку оплати.
Закриваючі документи
Після оплати Эльба може автоматично сформувати акт виконаних робіт або товарну накладну. Інтеграція:
- Ініціює створення акта при переході угоди на стадію «Виконано».
- Передає дані в Эльбу: контрагент, позиції, період.
- Отримує PDF та прикріплює до угоди.
Для ІП це закриває мінімальний набір документів: рахунок → оплата → акт.
Особливості для ІП та малого бізнесу
Эльба заточена під упрощений облік. Це впливає на інтеграцію:
- УСН «доходи» — рахунки без ПДВ, немає необхідності передавати податкову ставку.
- УСН «доходи мінус видатки» — розходні документи з Эльби не транслюються в CRM (вони не потрібні менеджеру).
- Патент — Эльба ведеє книгу обліку доходів; інтеграція фіксує тільки поступлення.
- АУСН — автоматична упрощена система; Эльба може працювати з нею, інтеграція передає дані без змін.
Обробка помилок
- Таймаут API Эльби — повтор через 5, 15, 45 секунд. Якщо не допомогло — задача в чергу, сповіщення адміністратору.
- Невалідний ІНН — перевірка контрольної суми до відправлення. Менеджер бачить: «ІНН не пройшов перевірку, перевірте правильність».
- Ліміт запитів — middleware дотримується rate limit API, запити буферизуються.
- Невідповідність номенклатури — якщо товар з CRM не знайдено у довіднику Эльби, створюється автоматично або логується для ручного маппінгу.
Безпека
Авторизація через OAuth 2.0. Токени зберігаються на сервері middleware, оновлюються автоматично. Всі запити — HTTPS. Доступ до middleware обмежено за IP. Логи ротуються, особисті дані маскуються.
Налаштовуємо інтеграцію під конкретний режим оподаткування та бізнес-процес компанії — від базового виставлення рахунків до повного циклу з відстеженням оплат та автоформуванням закриваючих документів.