Настройка формирования актов из Битрикс24 в 1С
Акт выполненных работ — документ, которым исполнитель подтверждает факт сдачи услуги. В Битрикс24 этот момент фиксируется статусом сделки или этапом воронки. Проблема возникает там, где CRM и бухгалтерия живут отдельной жизнью: менеджер закрыл этап, бухгалтер об этом узнаёт через несколько дней, акт задерживается, оплата — тоже.
Интеграция решает это через автоматическую передачу данных из Битрикс24 в 1С при достижении нужного статуса сделки.
Какой документ формируется в 1С
В зависимости от конфигурации 1С целевой документ различается:
| Конфигурация 1С | Документ для актов |
|---|---|
| 1С:Бухгалтерия 3.0 | «Акт об оказании производственных услуг» или «Реализация (акт, накладная)» |
| 1С:УТ 11 | «Реализация товаров и услуг» (вид операции — услуги) |
| 1С:ERP | «Реализация товаров и услуг» |
| 1С:Управление небольшой фирмой | «Оказание услуг» |
Перед настройкой интеграции нужно точно определить, в каком документе бухгалтер ведёт акты в конкретной конфигурации — это определяет правила маппинга.
Откуда берутся данные для акта в Битрикс24
Акт строится на трёх группах данных:
Стороны сделки. Исполнитель — юрлицо компании (реквизиты из настроек Битрикс24, раздел «Реквизиты организации»). Заказчик — контрагент из CRM, привязанный к сделке. Обязательны ИНН, КПП, юридический адрес — без них 1С не создаст документ корректно.
Перечень услуг. Берётся из товарных позиций сделки (crm.deal.productrows.get). Каждая позиция — строка акта: наименование, количество, единица измерения, цена, ставка НДС. Если в CRM используются произвольные наименования услуг, нужна таблица маппинга на номенклатуру 1С.
Сумма и валюта. Сделка в Битрикс24 может вестись в любой валюте — передаётся в 1С с учётом курса или в рублях, в зависимости от учётной политики.
Механизм передачи данных
Вариант 1 — webhook на смену этапа воронки. Наиболее распространённый подход. Настраивается через «Настройки» → «Webhooks» → «Исходящий webhook» на событие ONCRMDEALSTAGEID. Когда сделка переходит в стадию «Акт подписан» (или любую выбранную стадию) — вызывается обработчик.
Обработчик получает ID сделки, забирает полные данные через:
-
crm.deal.get— реквизиты сделки -
crm.deal.productrows.get— позиции -
crm.requisite.get— реквизиты контрагента
Затем формирует запрос к OData-сервису 1С или XML-файл для загрузки.
Вариант 2 — бизнес-процесс с действием «Создать акт в 1С». Подходит для коробочного Битрикс24. В дизайнере бизнес-процессов создаётся активность, вызывающая внешний обработчик. Преимущество — менеджер может запустить процесс вручную, не меняя стадию сделки.
Кейс: digital-агентство с ежемесячным закрытием
Агентство ведёт 60-80 активных проектов. Каждый месяц в последние дни — «акт-марафон»: проджект-менеджеры закрывают этапы, бухгалтер вручную переносит данные в 1С, создаёт акты, отправляет клиентам. На этот процесс уходило 2-3 дня в конце месяца.
После настройки интеграции: закрытие этапа «Работы выполнены» в Битрикс24 автоматически создаёт акт в 1С в статусе «Черновик». Бухгалтер видит список готовых актов, проверяет и проводит. Финальный этап подготовки актов сократился с 2 дней до 4 часов.
Особенность, с которой столкнулись при настройке: агентство использует нестандартные единицы измерения услуг («час», «проект», «правка»), которых не было в справочнике ОКЕИ в 1С. Пришлось добавить кастомные единицы в 1С и прописать маппинг в обработчике.
Синхронизация статусов: обратная связь из 1С
Акт в 1С может быть отклонён бухгалтером при проверке — ошибка в реквизитах или суммах. Полноценная интеграция предполагает и обратную передачу статуса в Битрикс24: если акт отклонён, в сделке появляется задача на менеджера с описанием причины.
Реализуется через регламентное задание в 1С, которое опрашивает документы в статусе «Не принят» и вызывает Битрикс24 REST API (crm.activity.add для создания дела).
Срок настройки интеграции в обе стороны: 4-7 рабочих дней.