Генератор документов

Типовые документы формируются сами — в CRM и в бизнес-процессах

Приложение добавляет в Битрикс24 Маркетплейс два равных по возможностям шага: робота «Генератор документов» в автоматизации CRM и действие «Генератор документов (действие БП)» в Дизайнере бизнес-процессов. На нужном шаге он берёт ваш docx-шаблон, подставляет в метки данные — и готовый документ появляется на Диске. Договор, счёт, акт, приказ, лист согласования — без ручного копирования из карточек.

Чем отличается от штатного генератора документов CRM

Штатный инструмент создаёт документ вручную из карточки сделки. Наше приложение работает там, где штатного не хватает:

— Автоматически, а не по кнопке. Документ создаётся на нужной стадии или шаге процесса: после согласования, при смене стадии, по расписанию.

— Не только CRM. В метки подставляются любые переменные и константы процесса: данные сотрудников, значения из форм, результаты предыдущих шагов.

— Шаблон — обычный файл Word. Отдельный редактор не нужен: разметьте метки {{поле}} в привычном docx, форматирование сохраняется полностью.

— Картинку тоже можно подставить. Метка заменяется изображением с Диска — подписью, печатью, логотипом, с указанием ширины и высоты.

— Результат сразу в PDF, если нужно. Параметр «Формат результата»: docx (по умолчанию) или PDF.

— Результат передаётся дальше по процессу. На выходе шага доступны ID созданного файла, ссылка на просмотр и ссылка для скачивания — их можно сразу подставить в письмо клиенту, задачу или уведомление.

— Без отдельной платы и без лимитов. Приложение входит в подписку Битрикс24 Маркетплейс, количество генераций мы не ограничиваем.

Что это даёт

— Документ оформляется за секунды вместо минут ручного заполнения.

— Исключены ошибки ввода: данные идут напрямую из CRM и переменных процесса.

— Один шаблон обслуживает сколько угодно сценариев и процессов.

Как начать работать

1. Подготовьте шаблон: обычный документ .docx, где вместо изменяемых значений стоят метки вида {{название_поля}}. Количество меток не ограничено. Метки — именно в двойных фигурных скобках; поля MergeField из ранних версий приложение не обрабатывает.

2. Загрузите шаблон на Диск и решите, в какую папку складывать результат. Числовые ID искать не нужно: файл и папка выбираются в настройках кнопкой «Выбрать».

3. Добавьте шаг: в CRM — робота «Генератор документов» на нужной стадии лида, сделки, счёта или смарт-процесса; в Дизайнере бизнес-процессов — действие «Генератор документов (действие БП)».

4. Выберите шаблон и папку, задайте имя итогового файла и формат, сопоставьте метки со значениями — метка и значение стоят в одной пронумерованной строке. Запустите: документ появится в указанной папке на Диске.

Сразу после установки приложение кладёт на Диск готовый пример — «Демо-шаблон GenDocx.docx». Первую генерацию можно запустить на нём, не готовя свой файл.

Если генерация не удалась — шаблон не найден, ошибка разметки, не удалось загрузить результат — причина пишется в журнал бизнес-процесса.

Совет для macOS: шаблон лучше готовить в Microsoft Word, так форматирование гарантированно сохранится.

Вопрос — ответ

Как вывести дату?

Для дат и полей типа «Дата/Время» используйте модификатор printable: {=System:Date > printable}.

Как вывести значение поля типа «Список», в том числе с несколькими выбранными значениями?

Через модификатор: {=Variable:кодпеременной > printable}.

Как сделать перенос строки внутри одной метки?

Подставляемая строка может содержать xml-тег <w:br/>: Пункт1<w:br/>Пункт2<w:br/>Пункт3.

Как получить ID созданного файла и ссылки на него?

Выберите нужные значения в разделе «Дополнительные результаты» следующего шага процесса. Для действия в Дизайнере в его настройках должно быть включено «Ожидание ответа» = Да.

Как подставить реквизиты компании?

Штатно доступно только устаревшее текстовое поле «Банковские реквизиты» — код BANKING_DETAILS. Для реквизитов, привязанных к компании или контакту через раздел «Реквизиты», штатного механизма подстановки в Битрикс24 Маркетплейс нет.