Настройка обмена актами сверки между 1С и Битрикс24

Настройка обмена актами сверки между 1С и Битрикс24

Акты сверки — документы, которые традиционно живут только в 1С. Но в B2B-сценариях с Битрикс24 возникает запрос: менеджер должен видеть акт сверки с контрагентом прямо в CRM, не переключаясь в 1С. Или — контрагент должен получать акт сверки через портал самообслуживания на сайте.

Что такое акт сверки в контексте интеграции

Акт сверки взаиморасчётов в 1С — это отчёт, формируемый по данным регистра ВзаиморасчётыСКонтрагентами за период. Документ содержит:

• Список операций по контрагенту (отгрузки, поступления, возвраты)
• Итоговое сальдо (кто кому должен)
• Подписи сторон

В 1С это либо отчёт (АктСверкиВзаиморасчётов), либо отдельный документ (в некоторых конфигурациях).

Зачем акты нужны в Битрикс24

Сценарий 1: CRM. Менеджер ведёт сделку с контрагентом в Битрикс24 CRM. Нужно быстро посмотреть актуальный баланс без открытия 1С. Акт сверки как виджет или вкладка в карточке компании.

Сценарий 2: Портал клиентов. B2B-клиент заходит в личный кабинет на сайте и самостоятельно формирует акт сверки за нужный период. Скачивает PDF. Без звонка бухгалтеру.

Сценарий 3: Автоматическая отправка. Раз в месяц акты сверки автоматически отправляются всем контрагентам с ненулевым сальдо — через email или через уведомление в Битрикс24.

Техническая архитектура: HTTP-сервис в 1С

Для получения данных акта сверки по запросу из Битрикс24 — создаём HTTP-сервис в 1С.

Эндпоинт: GET /hs/reconciliation/act Параметры: counterparty_guid, date_from, date_to, api_key Ответ: JSON с данными акта или PDF (base64)

GET /hs/reconciliation/act?counterparty_guid=abc-123&date_from=2024-01-01&date_to=2024-03-31
Authorization: Bearer {api_key}

Ответ:

{
  "counterparty": "ООО Ромашка",
  "period": {"from": "2024-01-01", "to": "2024-03-31"},
  "opening_balance": -15000.00,
  "transactions": [
    {"date": "2024-01-15", "document": "Реализация №12", "debit": 45000, "credit": 0},
    {"date": "2024-01-20", "document": "Платёж №456", "debit": 0, "credit": 45000}
  ],
  "closing_balance": -15000.00,
  "pdf_base64": "JVBERi0xLjQ..."
}

Интеграция с Битрикс24 CRM

Для отображения акта сверки в карточке компании Битрикс24 — используем механизм Activity или Timeline item через REST API.

Более удобный вариант — встраивание через встроенный виджет (iframe) в карточку CRM:

1. В настройках Битрикс24: Приложения → Интеграции → CRM → Карточка компании → Добавить виджет
2. URL виджета: https://1c.example.com/reconciliation?guid={CONTACT.UF_1C_GUID}&period=current_month
3. 1С-сервис рендерит HTML с таблицей акта сверки

Это самый быстрый способ — менеджер видит актуальные данные без отдельной разработки в Битрикс24.

Автоматическое формирование и рассылка актов

Регламентное задание в 1С (или в Битрикс24 через агент) — раз в месяц:

1. Получаем список контрагентов с ненулевым сальдо
2. Для каждого формируем PDF акта сверки (через АктСверкиВзаиморасчётов.СформироватьПФ() в 1С)
3. Загружаем PDF в Битрикс24 Drive через REST API (disk.folder.uploadFile)
4. Создаём задачу ответственному менеджеру: «Отправить акт сверки клиенту {название}»
5. Или сразу отправляем email через messageService.send

Загрузка в Drive:

$bitrix24->call('disk.folder.uploadFile', [
    'id' => ACTS_FOLDER_ID,
    'data' => ['NAME' => "Акт сверки {$company} {$period}.pdf"],
    'fileContent' => base64_encode($pdfContent),
]);

Подпись акта сверки

В идеале акт сверки должен быть подписан. Для электронного документооборота — используется интеграция с сервисами ЭДО (ДИАДОК, СБИС). Это отдельная задача за рамками простого обмена 1С ↔ Битрикс24.

Для автоматической рассылки без ЭДО: PDF формируется в 1С, отправляется контрагенту «для ознакомления». Подписанный скан контрагент возвращает по email или загружает в личный кабинет.

Кейс: B2B-портал с самообслуживанием

Оптовый поставщик: 500 активных контрагентов. Ежемесячно бухгалтер тратила 3–4 дня на рассылку актов сверки вручную. Контрагенты звонили с просьбами прислать акт за нестандартный период.

Реализовали личный кабинет на сайте (Битрикс): вкладка «Акты сверки». Контрагент выбирает период → кнопка «Сформировать» → запрос к HTTP-сервису 1С → PDF скачивается прямо в браузер.

Автоматическая рассылка: 1-го числа каждого месяца — акты за прошлый месяц всем контрагентам с ненулевым сальдо. Формирование 500 PDF в 1С — 12 минут. Загрузка в Битрикс24 Drive и создание задач менеджерам — ещё 8 минут через REST API.

Бухгалтер перестала тратить 3–4 дня в месяц на ручную рассылку.