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