Настройка печати документов 1С из Битрикс24

Как работает печать из Битрикс24

Менеджер работает в Битрикс24 CRM — ведёт сделку, общается с клиентом через встроенный мессенджер. В какой-то момент нужно выставить счёт. Раньше это означало: открыть 1С, найти контрагента, создать документ, сохранить PDF, вернуться в Битрикс24, прикрепить файл. Пять переключений контекста ради одного действия. Настройка печати документов 1С из Битрикс24 убирает это переключение. Мы настраиваем эту связь так, чтобы менеджеру не приходилось покидать CRM. Вся операция — от нажатия кнопки до получения PDF — занимает секунды. Это сокращает время выставления счетов с часов до минут и исключает ошибки ручного копирования данных. Наш опыт показывает, что такая интеграция окупается за первый месяц.

Под «печатью документов 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С:

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С.

Главный бухгалтер: «Раньше на выставление счёта уходило до 30 минут, теперь — 5. Ошибки исчезли».

Цикл сократился с 2–4 часов до 5 минут. Интеграция оказалась в 10 раз быстрее ручного переноса. Исключили случаи «забытых» счётов, которые раньше оседали в списке задач менеджера. Экономия составила около 300 000 рублей в месяц на трудозатратах бухгалтерии, что сэкономило компании почти 2 млн рублей в год. Дополнительно настроили автоматическое создание счёта при переводе сделки в статус «Счёт выставляется» — через робот Битрикс24, который вызывает webhook, запускающий HTTP-запрос к 1С.

Сколько времени занимает настройка?

Срок зависит от сложности. Базовая настройка одного типа документа (счёт) занимает 1-2 дня. Полный цикл с роботами и всеми документами — до 5 дней. Точные сроки определяем после аудита текущей схемы документооборота.

Типичные ошибки при интеграции

• Неверный GUID номенклатуры: синхронизируйте каталог продуктов
• Отсутствие API-ключа в 1С: проверяйте заголовок запроса
• Перегрузка сервера 1С: добавьте ограничение по частоте запросов

Что входит в работу

• Аудит текущей схемы документооборота и конфигураций 1С
• Разработка HTTP-сервиса в 1С под нужные типы документов
• Создание кнопки в карточке сделки Битрикс24 (приложение/виджет/робот)
• Настройка синхронизации номенклатуры (если требуется)
• Тестирование всех сценариев: штатная работа, ошибки, нагрузка
• Обучение менеджеров и бухгалтеров
• Документация по эксплуатации и схема интеграции

Почему стоит автоматизировать печать?

Ручной перенос данных из Битрикс24 в 1С — источник ошибок: перепутанные контрагенты, неверные суммы, забытые счета. Интеграция исключает человеческий фактор и ускоряет операцию в 5-10 раз. Мы гарантируем работоспособность решения на всех этапах: от проектирования до поддержки.

Закажите предварительную оценку вашего проекта — мы проанализируем типы документов, нагрузку и существующую архитектуру. Свяжитесь с нами для консультации.