Налаштування обміну актами звіряння між 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 дні на місяць на ручну розсилку.