Генерация документов в Битрикс24: шаблоны DOCX, PDF и автозаполнение
Зачем автоматизировать документы в CRM
Генерация документов в Битрикс24 — это, пожалуй, самый заметный «быстрый выигрыш» при внедрении CRM. Менеджер создаёт сделку, нажимает кнопку — и получает договор, счёт или коммерческое предложение, в котором уже подставлены реквизиты, товары, цены и суммы прописью. Никакого ручного копирования из карточки в Word.
Для руководителя ценность очевидна: уходит типовая опечатка в реквизитах, исчезают «договоры от клиента 2023 года», а юрист получает единый, утверждённый шаблон вместо десятка самодеятельных версий. В нашей практике внедрений коробочной версии Битрикс24 автогенерация документов — почти всегда первый бизнес-процесс, который просят автоматизировать.
В статье разберём, как это работает «из коробки», где заканчиваются возможности стандартного конструктора и что делать, если нужны сложные конструкции: собственные поля, многоуровневые спецификации, печать пакетов и конвертация в PDF. Ориентируемся на реальные задачи из наших проектов внедрения — от торговых компаний до производственных предприятий.
Содержание
- Стандартные шаблоны: что умеет «коробка»
- Свои поля и плейсхолдеры
- DOCX, PDF и массовая печать
- Когда нужен кастомный модуль
- Чек-лист внедрения
- Вывод
- FAQ
Стандартные шаблоны: что умеет «коробка»
В Битрикс24 из коробки встроен конструктор документов CRM. Он работает так: вы загружаете DOCX-шаблон, размечаете его специальными кодами полей — плейсхолдерами — и на выходе система генерирует заполненный файл. Поддерживаются сделки, счета, контакты, компании и смарт-процессы.
Стандартный набор плейсхолдеров покрывает большинство типовых задач:
- реквизиты компании и контрагента (название, ИНН, КПП, юридический адрес);
- позиции сделки или счёта — номенклатура, количество, цена, НДС, итоговые суммы;
- ответственный менеджер, дата, номер документа;
- пользовательские поля из карточки CRM.
Для регулярных документов вроде счетов и актов часто достаточно штатного функционала и встроенных PDF-шаблонов. Ограничение — в богатстве форматирования: сложные таблицы с объединёнными ячейками, вложенные списки товаров и произвольная логика («если в сделке больше 3 позиций — добавить приложение») конструктором не выражаются.
Как пользователь видит генерацию
Из карточки сделки менеджер открывает список шаблонов, выбирает нужный — и через секунды получает готовый файл в таймлайне. Дальше два типовых сценария: файл уходит клиенту роботом (письмо или мессенджер) либо менеджер скачивает его для печати. Документ не «теряется» на диске ноутбука — всегда можно вернуться к сделке и увидеть, что именно было отправлено.
Золотое правило внедрения: сгенерированный документ — это артефакт сделки. Если файл не прикреплён к CRM, значит, процесс настроен не до конца.
Коробка или облако?
В облачном Битрикс24 конструктор документов доступен во всех тарифах, но с ограничениями по кастомизации. В коробочной версии ничего не мешает расширить механизм: подключить свои обработчики, генерировать файлы через события и хранить результат где угодно. Если документооборот — ядро вашего процесса, мы рекомендуем коробочное внедрение — оно даёт полный контроль над шаблонами и выводом.
Свои поля и плейсхолдеры
Основная ошибка при внедрении — начинать с оформления шаблона вместо модели данных. Сначала определите, какие данные вообще должны попадать в документ: банковские реквизиты подписантов, условия оплаты, гарантийные сроки, ответственные лица. Всё, чего нет в стандартной карточке, — заводите как пользовательские поля CRM.
Только после этого размечайте DOCX-шаблон. Плейсхолдер представляет собой код вида {CompanyName} или {ContactFullName}, а для пользовательских полей используется их системный идентификатор. Мы рекомендуем вести реестр полей: название, ID, обязательность, кто заполняет. В одном из наших проектов такой реестр из ~40 полей сократил время подготовки договора с 40 минут до 3.
Важные нюансы из практики:
- обязательные поля должны быть обязательными и в CRM — иначе документ выйдет с пустыми местами;
- даты подставляйте в явном формате (день.месяц.год), а не в системном;
- суммы прописью поддерживаются стандартными плейсхолдерами — обязательно проверяйте склонение на реальных значениях;
- таблица товаров вставляется целиком — заранее продумайте, что будет, если позиций 50.
DOCX, PDF и массовая печать
Типовая схема: DOCX — рабочий формат для правки, PDF — финальный для отправки. В коробочной версии конвертацию в PDF удобно делать серверным LibreOffice в headless-режиме: шаблон заполняется, сохраняется как DOCX и конвертируется одной командой.
# Регистрация обработчика генерации документа из сделки (облачный REST-пример)
# POST https://ваш-портал/rest/1/токен/crm.documentgenerator.document.add
{
"templateId": 12,
"entityTypeId": 2,
"entityId": 10548,
"values": {
"DocumentNumber": "ДОГ-10548/10",
"SignDate": "08.10.2026",
"CustomField_157": "Оплата 50/50, отсрочка 14 дней"
},
"fileName": "Договор_10548",
"convertToPdf": true
}
Что важно в этом запросе: шаблон хранится в системе один раз, данные подсовываются на лету, а результат прикрепляется к таймлайну сделки и отправляется клиенту. В коробке то же самое делается через API модуля «Документы» или собственный обработчик на событии смены стадии.
Автозаполнение в цепочке продаж
Полная ценность раскрывается, когда генерация встроена в процесс: робот на стадии «Счёт выставлен» формирует счёт и письмо клиенту, на стадии «Договор подписан» — акт выполненных работ. Менеджер не участвует в рутине вообще, а руководитель видит воронку в реальном времени. Настройка такой цепочки — типовая задача этапа автоматизации в наших проектах.
Массовая генерация — отдельная история: выгрузка актов по 200 сделкам за месяц, печать КП для отдела продаж, пакеты документов для тендера. Здесь стандартная кнопка не справляется, и нужен скрипт или кастомный модуль с пакетной обработкой и генерацией единого PDF на десятки документов.
Сравнение подходов
| Критерий | Стандартный конструктор | Кастомный модуль |
|---|---|---|
| Сложность таблиц и вёрстки | Базовые таблицы товаров | Любая вёрстка, приложения, печати |
| Условная логика в шаблоне | Не поддерживается | Полная (смарт-процессы, скрипты) |
| PDF на лету | Ограниченно | LibreOffice / headless-конвейер |
| Массовая генерация | По одному документу | Пакеты, единый PDF, рассылка |
| Трудозатраты | 0–2 дня | От 5–10 дней разработки |
Когда нужен кастомный модуль
Обращайтесь к разработке собственного модуля, если узнаёте хотя бы два пункта из списка:
- в документ нужно подтягивать данные из 1С или внешней ERP (остатки, спецификации, штрихкоды);
- требуется многошаблонная логика: разные формы договора для разных типов клиентов и юрисдикций;
- документы нужно подписывать — с передачей в ЭДО или с КЭП;
- генерация должна запускаться автоматически по событию (сделка переведена в стадию «Договор») с маршрутом согласования;
- нужен самообслуживаемый конструктор шаблонов для юристов без участия разработчика.
Типовая архитектура модуля в наших проектах: хранилище шаблонов DOCX, движок подстановки (на базе API документов или библиотеки типа PHPWord), очередь конвертации в PDF и журнал генерации — кто, когда и на основании каких данных создал документ. Последнее критично для аудита: юристы и служба безопасности регулярно спрашивают, откуда взялась цифра в договоре.
Практический пример: у дистрибьютора оборудования в документ должны были попадать серийные номера и гарантийные сроки из 1С. Стандартный конструктор это не умел, кастомный модуль сделал подстановку за считанные секунды — и исключил ручной ввод серийников на тысячах позиций в месяц.
Документооборот редко живёт изолированно: счёт из CRM уходит в 1С, договор — на согласование через смарт-процессы. Поэтому модуль генерации мы проектируем сразу как часть общей интеграционной шины, а не как самостоятельный «остров».
Чек-лист внедрения
- Инвентаризировать все документы компании: тип, частота, кто готовит, кто согласует.
- Спроектировать модель данных: стандартные поля CRM + пользовательские, реестр полей.
- Утвердить с юристом финальные шаблоны DOCX до начала разметки плейсхолдерами.
- Разметить шаблоны и протестировать на «граничных» данных: длинные названия, 50+ позиций, пустые поля.
- Настроить конвертацию в PDF и именование файлов по единому стандарту.
- Определить точки автозапуска: смена стадии, робот или ручная кнопка.
- Обучить менеджеров и назначить владельца шаблонов (обычно — юрист или операционный директор).
Вывод
- Генерация документов в Битрикс24 из коробки закрывает счета, акты и простые договоры — внедряется за день и почти сразу окупается временем менеджеров.
- Устойчивость решения определяется моделью данных, а не красотой шаблона: реестр полей и обязательность заполнения важнее вёрстки.
- PDF-конвейер на базе LibreOffice — рабочий стандарт для коробки; для массовой печати и пакетов нужна автоматизация.
- Кастомный модуль оправдан при сложной логике, интеграции с 1С/ERP или требованиях аудита.
- Документооборот связан с остальными процессами CRM — закладывайте интеграцию сразу, а не «потом переделаем».
Хотите получить оценку автоматизации документооборота под ваш кейс — напишите нам, разберём ваши шаблоны и предложим архитектуру решения.
FAQ
Можно ли генерировать документы в облачном Битрикс24?
Да, конструктор документов и библиотека шаблонов работают и в облаке, включая PDF-вывод и автоматическую отправку клиенту роботом. Ограничения — в кастомной логике и массовой генерации: для них обычно требуется внешнее приложение на REST API.
Как вывести данные из 1С в документ?
Через интеграцию: нужные поля синхронизируются из 1С в пользовательские поля сделки или смарт-процесса, а шаблон подставляет их как обычные плейсхолдеры. Мы чаще всего реализуем это в составе проекта интеграции с 1С.
Что делать, если шаблон сложный — приложения, печати, слияние ячеек?
Стандартный конструктор такое не выдержит. Решение — кастомный модуль: генерация через PHPWord/Twig с последующей конвертацией в PDF. Шаблон готовит дизайнер в Word, логику подстановки — разработчик.
Как контролировать, какая версия договора ушла клиенту?
Все сгенерированные файлы прикрепляются к таймлайну сделки с автором и временем создания, а журнал генерации фиксирует данные-источники. Критично: доступ к редактированию самих шаблонов должен быть только у владельца документооборота.
Сколько стоит внедрение автогенерации?
Настройка типовых шаблонов в коробке — 2–5 дней. Кастомный модуль с PDF-конвейером, пакетной печатью и интеграцией — от 10 дней. Точную оценку даём после аудита ваших шаблонов.
bitrix