Обмін актами звірки 1С та Бітрікс24: налаштування й автоматизація

Проблема: акти звірки залишаються в 1С, а потрібні в CRM

Менеджер веде угоду в Бітрікс24 і йому потрібно перевірити поточний баланс контрагента. Він відкриває 1С, чекає завантаження, формує звіт — 10–15 хвилин. Якщо таких запитів 10 на день — втрачається 2–3 години. А ще контрагенти просять надіслати акт за довільний період, і бухгалтер знову лізе в 1С. Ми вирішуємо цю проблему: налаштовуємо прямий обмін актами звірки між 1С та Бітрікс24 так, щоб дані були доступні одним кліком. Досвід інтеграції — понад 50 проєктів, гарантія на роботи.

Що таке акт звірки в контексті інтеграції

Акт звірки взаєморозрахунків у 1С формується за даними регістру ВзаєморозрахункиЗКонтрагентами за період. Документ містить список операцій (відвантаження, надходження, повернення), підсумкове сальдо та поля для підписів. У 1С це або звіт (АктЗвіркиВзаєморозрахунків), або окремий документ. Для інтеграції нам потрібно віддати ці дані в машинозчитуваному вигляді — через REST API.

Навіщо акти потрібні в Бітрікс24

Сценарій 1: CRM. Менеджер бачить актуальний баланс у картці компанії без перемикання в 1С. Акт звірки відображається віджетом або на окремій вкладці.

Сценарій 2: Портал клієнтів. B2B-клієнт заходить в особистий кабінет на сайті, обирає період і завантажує PDF. Жодних дзвінків бухгалтеру.

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

Як акти звірки потрапляють з 1С до CRM?

Створюємо HTTP-сервіс в 1С — endpoint з перевіркою API-ключа. Сервіс приймає GUID контрагента та період, повертає 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 дані відображаються через віджет (iframe) у картці компанії. URL віджета вказує на HTTP-сервіс 1С, який рендерить HTML-таблицю. Альтернатива — використовувати Activity або Timeline item через REST API, але віджет простіше та швидше.

Порівняння способів відображення в CRM

Віджет — оптимальний варіант: менеджер бачить актуальну інформацію без перезавантаження сторінки.

Автоматичне формування та розсилка актів

Регламентне завдання раз на місяць:

1. Отримуємо список контрагентів з ненульовим сальдо.
2. Для кожного формуємо PDF акта звірки (функція АктЗвіркиВзаєморозрахунків.СформуватиПФ() в 1С).
3. Завантажуємо PDF у Бітрікс24 Диск через REST API (disk.folder.uploadFile).
4. Створюємо задачу менеджеру або одразу надсилаємо email.

Приклад завантаження на PHP:

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

Чому варто автоматизувати розсилку актів?

Ручна розсилка — втрата 3–4 днів на місяць для бухгалтера. Автоматизація скорочує це до 15–20 хвилин на моніторинг. До того ж контрагенти отримують акти без затримок, що зменшує потік дзвінків у відділ продажів.

Кейс з нашої практики: B2B-портал з самообслуговуванням

Оптовий постачальник — 500 активних контрагентів. До нас бухгалтерка витрачала 3–4 дні на місяць на ручну розсилку актів. Контрагенти постійно дзвонили з проханнями сформувати акт за нестандартний період. Ми реалізували особистий кабінет на сайті (Бітрікс) з вкладкою «Акти звірки». Контрагент обирає період → натискає «Сформувати» → HTTP-сервіс 1С повертає PDF. Автоматично 1-го числа кожного місяця формуються 500 PDF (12 хвилин), завантажуються в Диск і створюються завдання менеджерам (ще 8 хвилин через REST). Бухгалтерка перестала витрачати дні на рутину.