Налаштування друку документів 1С із Бітрікс24

Налаштування друку документів 1С з Бітрікс24

Менеджер працює в Бітрікс24 CRM — веде угоду, спілкується з клієнтом через вбудований месенджер. У якийсь момент потрібно виставити рахунок. Рахунок створюється в 1С. Раніше це означало: відкрити 1С, знайти контрагента, створити документ, зберегти PDF, повернутися в Бітрікс24, прикріпити файл. П'ять перемикань контексту заради однієї дії. Інтеграція друку документів 1С з Бітрікс24 усуває це перемикання.

Що означає «друк з Бітрікс24»

Під «друком документів 1С з Бітрікс24» розуміється кілька пов'язаних сценаріїв:

1. Формування PDF-документа (рахунок, УПД, накладна, акт) у 1С — прямо з картки угоди або контрагента в Бітрікс24
2. Відправка документа клієнту — через email, месенджер або посилання для завантаження
3. Збереження документа у Бітрікс24 Drive — прив'язка до угоди або контакту

Технічно це реалізується через HTTP-сервіс у 1С, який отримує запит з Бітрікс24 і повертає готовий PDF.

HTTP-сервіс у 1С для генерації документів

Створюємо в 1С (УТ, КА, ERP) HTTP-сервіс з методом POST /hs/documents/print.

Запит:

{
  "document_type": "invoice",
  "order_id": "bitrix_order_123",
  "counterparty_guid": "abc-123-def...",
  "items": [
    {"guid": "товар-guid", "quantity": 5, "price": 1500.00},
    {"guid": "товар2-guid", "quantity": 2, "price": 3200.00}
  ],
  "date": "2024-03-15",
  "api_key": "secret-key"
}

Сервіс у 1С:

1. Знаходить або створює контрагента за counterparty_guid
2. Створює документ (Рахунок на оплату / Замовлення покупця / УПД)
3. Формує друковану форму через стандартний механізм ДрукованаФорма
4. Повертає PDF в base64

{
  "success": true,
  "document_number": "Рх-00001234",
  "document_date": "2024-03-15",
  "document_1c_guid": "документ-guid...",
  "pdf_base64": "JVBERi0xLjQ..."
}

Кнопка в інтерфейсі Бітрікс24

Для менеджера потрібна кнопка «Виставити рахунок» прямо в картці угоди. Реалізується через:

Варіант 1: Застосунок Бітрікс24 (Marketplace). Розроблений застосунок додає вкладку в картку угоди. Менеджер бачить форму: вибір документа (рахунок/накладна/акт), список позицій з угоди, кнопка «Сформувати».

Варіант 2: Віджет через REST API. Через CRMActivityUI.EntityDetail Бітрікс24 дозволяє вбудовувати кастомні інтерфейси в картку CRM.

Варіант 3: Роботи/тригери. При переході угоди в певний статус — автоматично формується рахунок у 1С та прикріплюється до угоди. Без участі менеджера.

Варіант 3 — найбільш автоматизований. Підходить, якщо логіка документа стандартна (один тип рахунку для всіх угод даного типу).

Прив'язка позицій угоди до номенклатури 1С

Щоб рахунок у 1С містив правильну номенклатуру — позиції угоди в Бітрікс24 повинні містити XML_ID, що збігається з GUID номенклатури в 1С. Це забезпечується через каталог продуктів Бітрікс24, синхронізований з 1С (або через обмін через Бітрікс-сайт, або через пряму синхронізацію каталогу Бітрікс24 з 1С через REST API).

Якщо синхронізації каталогу немає — можна передавати позиції за найменуванням, але тоді в 1С буде створюватися «невідома номенклатура», і бухгалтер повинен буде її уточнювати вручну.

Типи документів для друку

Кожен тип документа — окремий endpoint у HTTP-сервісі 1С або параметр document_type в єдиному endpoint.

Кейс: скорочення циклу виставлення рахунку

Виробник обладнання: цикл від прийняття замовлення до відправки рахунку клієнту — 2–4 години (очікування, поки бухгалтер не відкриє 1С і не виставить рахунок). Клієнт міг зателефонувати раніше.

Після інтеграції: менеджер у картці угоди Бітрікс24 натискає «Виставити рахунок», заповнює кількість і дату — через 3 секунди рахунок-PDF прикріплений до угоди та відправлений клієнту по email через завдання. Бухгалтер отримує сповіщення про створений рахунок у 1С.

Цикл скоротився з 2–4 годин до 5 хвилин. Виключили випадки «забутих» рахунків, які раніше осідали в списку завдань менеджера.

Додатково: налаштували автоматичне створення рахунку при переведенні угоди в статус «Рахунок виставляється» — через робот Бітрікс24, який викликає webhook, що запускає HTTP-запит до 1С.