Настройка печати документов 1С из Битрикс24
Менеджер работает в Битрикс24 CRM — ведёт сделку, общается с клиентом через встроенный мессенджер. В какой-то момент нужно выставить счёт. Счёт создаётся в 1С. Раньше это означало: открыть 1С, найти контрагента, создать документ, сохранить PDF, вернуться в Битрикс24, прикрепить файл. Пять переключений контекста ради одного действия. Интеграция печати документов 1С из Битрикс24 убирает это переключение.
Что значит «печать из Битрикс24»
Под «печатью документов 1С из Битрикс24» понимается несколько связанных сценариев:
- Формирование PDF документа (счёт, УПД, накладная, акт) в 1С — прямо из карточки сделки или контрагента в Битрикс24
- Отправка документа клиенту — через email, мессенджер, или ссылку для скачивания
- Сохранение документа в Битрикс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С:
- Находит или создаёт контрагента по
counterparty_guid - Создаёт документ (Счёт на оплату / Заказ покупателя / УПД)
- Формирует печатную форму через стандартный механизм
ПечатнаяФорма - Возвращает 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С будет создаваться «неизвестная номенклатура», и бухгалтер должен будет её уточнять вручную.
Типы документов для печати
| Документ | Конфигурация 1С | Когда нужен |
|---|---|---|
| Счёт на оплату | УТ, КА, БП, ERP | Выставление счёта клиенту |
| Товарная накладная (ТОРГ-12) | УТ, КА, ERP | Отгрузка товара |
| УПД (счёт-фактура + накладная) | УТ, КА, БП, ERP | Отгрузка с НДС |
| Акт выполненных работ | КА, ERP, УНФ | Услуги |
| Договор (по шаблону) | Все конфигурации | Подписание договора |
Каждый тип документа — отдельный endpoint в HTTP-сервисе 1С или параметр document_type в едином endpoint.
Кейс: сокращение цикла выставления счёта
Производитель оборудования: цикл от принятия заказа до отправки счёта клиенту — 2–4 часа (ожидание, пока бухгалтер не откроет 1С и не выставит счёт). Клиент мог позвонить раньше.
После интеграции: менеджер в карточке сделки Битрикс24 нажимает «Выставить счёт», заполняет количество и дату — через 3 секунды счёт-PDF прикреплён к сделке и отправлен клиенту по email через задачу. Бухгалтер получает уведомление о созданном счёте в 1С.
Цикл сократился с 2–4 часов до 5 минут. Исключили случаи «забытых» счётов, которые раньше оседали в списке задач менеджера.
Дополнительно: настроили автоматическое создание счёта при переводе сделки в статус «Счёт выставляется» — через робот Битрикс24, который вызывает webhook, запускающий HTTP-запрос к 1С.