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

Это руководство ведёт от установки и первого DOCX до товаров, реквизитов, пользовательских полей, лидов, сделок, КП, счетов, смарт-процессов, связанных задач, условий, дат, длительности и модификаторов.

Перед установкой

Поручите установку администратору вашего Битрикс24 или специалисту, которому разрешено устанавливать приложения и настраивать CRM.

Для первой проверки подготовьте:

• Карточку CRM с контрольными данными и доступом к ней.
• Небольшой шаблон DOCX или XLSX либо готовность воспользоваться библиотекой пресетов.
• Word или Excel для проверки соответствующего файла после формирования.

Открывайте приложение внутри своего портала Битрикс24. Прямое открытие страницы приложения вне портала не заменяет установку и подключение к CRM.

Установка

Эти шаги применяются, когда карточка «Генератор документов» доступна для установки в вашем Битрикс24. Если приложение не находится в Маркете, уточните у разработчика его доступность и ссылку для вашего портала.

1. Войдите в нужный портал Битрикс24 под учётной записью, которой разрешена установка приложений.
2. Откройте в Маркете карточку «Генератор документов».
3. Ознакомьтесь с условиями и запрошенными разрешениями в карточке.
4. Запустите установку доступным в карточке действием.
5. Дождитесь завершения экрана «Установка приложения». Во время работы на нём отображаются этапы подготовки и завершения установки.
6. Убедитесь, что появилось сообщение «Установка завершена».
7. Откройте установленное приложение внутри этого же портала.

Сообщение «Не удалось завершить установку» означает, что установка не завершена. Не принимайте открывшуюся страницу или частично заполненную полосу прогресса за успешный результат.

Разрешения и доступ

Для подготовки документа приложению нужны данные той CRM-карточки, которую вы выбираете. Если используются связанные компания, контакт, реквизиты или задачи, соответствующие сведения должны быть заполнены и доступны. Для прикрепления результата требуется возможность работы с файлами в портале.

Проверяйте точный перечень запрашиваемых разрешений в окне установки. Если нужные сведения не загружаются, обратитесь к администратору или разработчику; не пытайтесь исправить это созданием собственных ключей или передачей паролей.

Установка приложения не является подтверждением того, что каждому сотруднику доступны все карточки и поля. Перед рабочим использованием проверьте выбранный сценарий под учётной записью будущего пользователя.

Первая настройка

Подключите действие в нужных карточках CRM

1. В меню приложения откройте раздел «Bitrix24».
2. Найдите блок «Встройки в карточках CRM».
3. Нажмите «Открыть настройки встроек».
4. На странице «Встройки CRM» отметьте нужные стандартные сущности.
5. В блоке «Смарт-процессы» отметьте нужные процессы, если они есть в списке.
6. Нажмите «Сохранить и зарегистрировать».
7. Дождитесь сообщения «Сохранено» с количеством зарегистрированных встроек.
8. Откройте контрольную карточку выбранной сущности и проверьте наличие действия «Сформировать документ» в верхней панели.

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

Если нужный смарт-процесс добавлен позднее, нажмите «Обновить список смартов», выберите его и снова сохраните настройки. Сообщение об отсутствии дополнительных смарт-процессов само по себе не означает ошибку установки приложения.

Подготовьте один контрольный шаблон

1. Откройте «Шаблоны» → «Мастер шаблона».
2. Выберите источник данных для каталога переменных: сделку, лид, компанию, контакт или ручной JSON. Этот выбор помогает получить подсказки, но сам по себе не задаёт совместимость создаваемого шаблона.
3. Выберите базовый пресет. Формат и совместимые сущности будущего шаблона наследуются от выбранного пресета — проверьте их до создания.
4. Просмотрите «Переменные и примеры» и при необходимости обновите каталог.
5. Укажите название и уникальный код шаблона.
6. Нажмите «Создать из пресета».

Если используете собственный файл, выберите «Шаблоны» → «Новый шаблон», заполните название, код, тип и файл, отметьте совместимые сущности и нажмите «Загрузить шаблон».

Подробные правила подготовки DOCX, XLSX, полей и таблиц находятся в разделе «Примеры и инструкция». Наличие шаблона обязательно для контрольной генерации, но сложный рабочий макет не нужен для проверки самой установки.

Проверка установки

Проверьте не только сообщение о завершении, но и весь первый сценарий:

1. Откройте главную страницу приложения внутри портала и убедитесь, что интерфейс загрузился.
2. Откройте «Шаблоны» и найдите созданный контрольный шаблон.
3. Проверьте каталог полей для его CRM-сущности.
4. Откройте соответствующую контрольную карточку CRM.
5. Нажмите «Сформировать документ» и выберите совместимый шаблон.
6. Дождитесь формирования. Скачайте файл из интерфейса или раздела «Генерации»; при включённом прикреплении он также появится в таймлайне карточки.
7. Откройте файл в Word или Excel.
8. Сверьте несколько известных значений с карточкой и убедитесь, что служебные выражения заменились данными.

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

Начните с DOCX или XLSX. PDF — отдельная возможность, зависящая от настроенного преобразования, и её проверяют после успешного основного сценария.

Частые проблемы первой настройки

Ситуация	Безопасное действие
Приложение не находится в Маркете	Уточните у разработчика доступность и правильную карточку для вашего портала
«Не удалось завершить установку»	Сохраните текст ошибки и сообщите администратору или разработчику, на каком этапе она возникла
Приложение открыто отдельно от портала	Вернитесь в Битрикс24 и откройте установленное приложение оттуда
Нет действия «Сформировать документ»	Проверьте выбранные сущности во «Встройках CRM» и результат «Сохранить и зарегистрировать»
Не виден нужный смарт-процесс	Нажмите «Обновить список смартов» и проверьте наличие процесса в самом портале
Нет совместимого шаблона	Создайте или загрузите шаблон для выбранного типа карточки
Каталог полей пустой или не загрузился	Убедитесь, что приложение открыто внутри портала; повторите обновление каталога и прочитайте сообщение об ошибке
Реквизиты или контакт в документе пустые	Проверьте связи и заполнение данных в контрольной карточке; это не обязательно ошибка установки
Документ не сформирован	Найдите попытку в разделе «Генерации», прочитайте сообщение и исправьте указанные данные или шаблон

При обращении за помощью достаточно указать действие, время ошибки и её текст. Не отправляйте пароли, коды доступа или документы с конфиденциальными данными без необходимости.

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

Не используйте удаление приложения как первый способ исправления ошибки. Сначала сохраните исходные шаблоны и необходимые сформированные документы, затем уточните у разработчика порядок повторной установки и сохранность данных.

Что уточнить перед установкой

• Доступность карточки приложения для вашего портала, если её ещё нельзя установить из Маркета.
• Требования к тарифу и редакции вашего Битрикс24.
• Окончательный перечень разрешений в доступной для установки версии.
• Сохранение шаблонов, настроек и истории при удалении или повторной установке.

Поддержку коробочной редакции, мобильного приложения и формирование PDF при необходимости согласуйте отдельно до использования этих сценариев.

Подробная работа с шаблонами

Для чего нужно приложение

Приложение подставляет данные CRM Битрикс24 в подготовленные файлы DOCX и XLSX. Вы один раз оформляете документ в Word или Excel, обозначаете изменяемые поля и таблицы, загружаете шаблон, а затем создаёте документы по карточкам CRM.

Это полезно менеджерам по продажам, сотрудникам, которые готовят коммерческие предложения и спецификации, и специалистам, которым нужны документы с перечнем связанных задач и зарегистрированными трудозатратами.

Основной результат — файл с данными выбранной карточки. Его можно скачать из интерфейса или раздела «Генерации»; при включённом прикреплении файл также появляется в таймлайне CRM-карточки. Перед отправкой клиенту документ необходимо открыть и проверить.

Что можно подготовить

• Коммерческое предложение с данными клиента и таблицей товаров.
• Спецификацию с количеством, ценами, суммами и итогами.
• Документ на основе своего бланка с полями CRM и реквизитами.
• Отчёт по связанным задачам: название, дата создания и зарегистрированное время.

Генерация предусмотрена для лидов, сделок, предложений (КП), счетов и смарт-процессов. Список доступных сущностей и поля определяются в вашем портале. Выбирайте только те сущности, под которые подготовлен шаблон.

Приложение не подменяет проверку содержания договора, бухгалтерского или юридически значимого документа. Текст, расчёты и реквизиты, которые вы используете в своей работе, необходимо согласовать самостоятельно.

Перед первым документом

1. Откройте установленное приложение внутри Битрикс24.
2. Подготовьте контрольную карточку CRM с понятными вам значениями: названием, клиентом, товарами и необходимыми пользовательскими полями.
3. Если документ должен содержать реквизиты, заполните их у связанной компании или контакта. Для банковских данных нужны заполненные банковские реквизиты.
4. Для редактирования макета используйте Word для DOCX или Excel для XLSX. Готовый результат также проверяйте в подходящем офисном редакторе.
5. Откройте раздел «Примеры и инструкция». В нём есть поиск, копирование выражений, примеры для обоих форматов и описание ограничений.

Все организации, имена, суммы и банковские значения ниже — учебные. Их нельзя использовать вместо реквизитов реального клиента.

Быстрый старт через мастер

В разделе «Шаблоны» нажмите «Мастер шаблона».

1. Сценарий документа. Выберите понятный вам вариант, чтобы сориентироваться в мастере.
2. Источник данных. Выберите источник для каталога переменных: сделку, лид, компанию, контакт или ручной JSON. Он определяет подсказки на этом шаге, но не привязывает созданный шаблон к сущности.
3. Базовый пресет. Выберите готовую основу и прочитайте её описание. Именно пресет задаёт формат и совместимые сущности создаваемого шаблона.
4. Переменные и примеры. Просмотрите каталог полей. При необходимости нажмите «Обновить каталог», найдите нужное поле и скопируйте выражение. До загрузки каталога портал может показывать только переменные базового пресета — это не полный перечень ваших полей.
5. Создание шаблона. Укажите понятное название и уникальный код, затем нажмите «Создать из пресета».

Мастер создаёт шаблон на основе выбранного пресета. Он не является редактором произвольной вёрстки документа. Чтобы изменить структуру, шапку или таблицы, нажмите «Скачать пример», отредактируйте файл в Word или Excel и загрузите свой вариант.

Готовые основы также доступны в разделе «Библиотека пресетов». Если уже есть собственный бланк, можно сразу перейти к загрузке.

Как загрузить свой шаблон

1. Сохраните рабочий бланк как .docx или .xlsx.
2. Замените изменяемый текст выражениями полей. Обычные подписи, заголовки и оформление оставьте в файле.
3. В приложении откройте «Шаблоны» → «Новый шаблон».
4. Укажите «Название», «Код», «Тип» и «Файл». Для кода удобно использовать понятное обозначение, например offer_equipment_v1.
5. В блоке «Сущности шаблона» отметьте нужные карточки CRM и смарт-процессы.
6. Нажмите «Открыть поля», чтобы получить актуальные выражения для выбранных сущностей. Если изменили файл после выбора, перед загрузкой выберите его актуальную версию.
7. Нажмите «Загрузить шаблон» и проверьте результат анализа переменных.
8. Устраните ошибки выражений до использования шаблона в работе.

Не переносите номер пользовательского поля или смарт-процесса из чужого примера: на вашем портале он может отличаться. Каталог — основной источник точных кодов.

В карточке шаблона можно скачать исходный файл, открыть редактирование и выполнить тестовую генерацию. Изменение шаблона применяется к новым документам; ранее сформированные файлы не переписываются.

Скачать учебные шаблоны

Файлы собраны как понятные основы для обучения. Они прошли анализ синтаксиса и контрольную подстановку на реализации зафиксированной ревизии. Это не юридически готовые документы: перед работой проверьте текст, реквизиты, суммы, НДС, печатную область и оформление.

• Краткое КП по сделке — DOCX — данные сделки и клиента, товары, рублёвые суммы и итоги.
• Краткое КП по сделке — XLSX — тот же учебный сценарий в Excel с повторяющейся строкой {{#products}}.
• Отчёт по связанным задачам — DOCX — дата, название, секунды и длительность HH:mm:ss.
• Отчёт по связанным задачам — XLSX — отдельная строка на задачу; отсутствующее время выводится как 00:00:00 через duration | default.

Как вставлять поля

В основном синтаксисе путь к полю заключают в двойные фигурные скобки:

Коммерческое предложение
По сделке: {{ deal.title }}
Контрагент: {{ company.name }}
ИНН: {{ company.inn }}
Контактное лицо: {{ contact.formatted_name }}

При генерации выражения заменятся значениями. Например, {{ deal.title }} превратится в «Поставка оборудования».

Как выбрать сущность

Данные	Корень выражения
Сделка	deal
Лид	lead
Предложение (КП)	quote
Счёт	invoice
Компания	company
Контакт	contact
Смарт-процесс	dynamic_NNN, где номер берётся из вашего каталога

Приложение также поддерживает алиасы в одинарных скобках. Например, {Title} используется для названия текущей сущности.

Отметка нескольких сущностей в настройках не превращает deal.title в название лида или счёта. Для общего шаблона выбирайте подходящие алиасы из каталога и проверяйте результат отдельно для каждого типа карточки.

Не меняйте регистр символов в скопированном коде поля. Человекочитаемое название поля в CRM и выражение для документа — не всегда одно и то же.

Какие данные доступны в разных сценариях

• Сделка: deal, связанная компания и контакт, ответственный, products, totals, tasks, my_company.
• Лид: lead, связанная компания и контакт, ответственный, products, totals, tasks, my_company.
• Счёт: invoice, связанная компания и контакт, ответственный, products, totals, tasks, my_company.
• Предложение или КП: quote, связанная компания и контакт, ответственный, products, totals, my_company. Список tasks для quote в проверенной реализации не загружается.
• Смарт-процесс: dynamic_NNN, связанная компания и контакт, ответственный, products, totals, tasks, my_company — в пределах данных и связей конкретного элемента.
• Компания и контакт могут использоваться как текущая сущность; товарный список для них пуст.

На контрольном портале смарт-процесс «Всё включено» имел корень dynamic_1038, поэтому выражение названия выглядело так:

{{ dynamic_1038.title }}

1038 — реальный пример из контрольного каталога, а не универсальный номер. Для другого портала скопируйте собственный dynamic_NNN.

Реальные коды пользовательских полей из контрольного каталога

В проверенной сделке использовались:

• текст — UF_CRM_1787148491040;
• дата и время — UF_CRM_1787148514204;
• список — UF_CRM_1787148581370;
• число — UF_CRM_1787148609337;
• флаг — UF_CRM_1787148631471.

Копируемые примеры для текущей сущности:

{UF_CRM_1787148491040}
{UF_CRM_1787148514204~d.m.Y H:i}
{UF_CRM_1787148581370}
{UF_CRM_1787148609337}
{UF_CRM_1787148631471}

Для сделки те же данные проверялись через прямые пути:

{{ deal.uf_crm_1787148491040 }}
{{ deal.uf_crm_1787148514204 }}
{{ deal.uf_crm_1787148581370 }}
{{ deal.uf_crm_1787148609337 }}
{{ deal.uf_crm_1787148631471 }}

В каталоге конкретного портала написание пути может отличаться. Не собирайте выражение из номера вручную: откройте поля выбранной сущности и скопируйте готовый код.

Контрагент, контакт и банковские реквизиты

Пример блока клиента:

Покупатель: {{ company.name }}
ИНН: {{ company.inn }}
Контакт: {{ contact.formatted_name }}
Банк: {{ company.bank_detail.bank_name }}
Расчётный счёт: {{ company.bank_detail.account_number }}

Если блок пустой, проверьте связь карточки с клиентом, заполнение соответствующих реквизитов и доступность данных. Форматирование не может получить отсутствующие сведения.

Для продавца используйте поля раздела «Моя компания» в каталоге. Не подставляйте реквизиты клиента на место реквизитов собственной организации.

Таблица товаров в Word

Создайте настоящую таблицу Word. В ней нужны строка заголовков, отдельная служебная строка начала цикла, строка данных и отдельная служебная строка конца цикла.

Строка	Содержимое
Заголовок	№, Наименование, Количество, Сумма — в отдельных ячейках
Начало цикла	{%tr for item in products %} в первой ячейке
Данные	{{ loop.index }}, {{ item.name }}, {{ item.qty }}, {{ item.sum | money }} — по соответствующим ячейкам
Конец цикла	{%tr endfor %} в первой ячейке

При генерации служебные строки удаляются, а строка данных повторяется для каждого товара. Заголовок остаётся один. Если товаров нет, строк данных не будет.

Под таблицей можно добавить сумму прописью:

Итого прописью: {{ totals.sum_with_vat | money_words }}

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

Таблица товаров в Excel

В XLSX границы цикла и строка данных также должны занимать отдельные строки листа.

Ячейка	Содержимое
A1–D1	Заголовки: Наименование, Количество, Цена, Сумма
A2	{{#products}}
A3	{{ item.name }}
B3	{{ item.qty }}
C3	{{ item.price | money_no_currency }}
D3	{{ item.sum | money }}
A4	{{/products}}

Строка 3 повторится по числу товаров, служебные строки будут удалены, а расположенные ниже строки сдвинутся. Оформление заголовков и строки данных задайте до загрузки.

Не объединяйте ячейки через границы цикла или условного блока. Отдельно проверяйте формулы, высоту строк, перенос длинных названий и область печати. Денежные фильтры создают оформленное представление суммы; не рассчитывайте на него как на универсальную числовую ячейку для дальнейших вычислений.

Связанные задачи: дата, название и время

Задача должна быть связана с той CRM-сущностью, по которой создаётся документ. Табличный список таких задач доступен как tasks.

Для Word создайте таблицу с тремя столбцами: «Дата создания», «Задача», «Затраченное время». Разместите начало и конец цикла в отдельных служебных строках:

{%tr for item in tasks %}

В трёх ячейках строки данных разместите соответственно:

{{ item.created_date | date }}
{{ item.title }}
{{ item.time_spent_in_logs | duration("HH:mm:ss") }}

В строке завершения:

{%tr endfor %}

Для Excel используйте ту же строку данных, но отдельные строки начала и завершения замените на {{#tasks}} и {{/tasks}}.

time_spent_in_logs — зарегистрированные трудозатраты в секундах. Это не плановая длительность и не время, прошедшее с момента создания задачи. Если трудозатраты не зарегистрированы, значение может отсутствовать.

Как выбрать формат времени

Выражение	Результат для 9300 секунд
{{ item.time_spent_in_logs | duration("seconds") }}	9300
{{ item.time_spent_in_logs | duration("HH:mm:ss") }}	02:35:00
{{ item.time_spent_in_logs | duration }}	02:35:00

Это длительность, а не время суток: 90061 секунда выводится как 25:01:01. Часы не сбрасываются после суток.

Ноль даёт 0 или 00:00:00. Отсутствующее значение остаётся пустым. Чтобы явно показывать ноль вместо пустоты, используйте именно такой порядок фильтров:

{{ item.time_spent_in_logs | duration | default("00:00:00") }}

Поддерживаются только форматы seconds и HH:mm:ss. На входе нужны целые неотрицательные секунды. Строки «2 часа» или «02:35:00», отрицательные и дробные секунды не подходят.

В отдельной ячейке XLSX duration("seconds") сохраняет числовой тип для полученных секунд. Запасное значение default("0") будет текстом. Прежде чем применять новый формат в рабочем шаблоне, сформируйте контрольный файл на своём портале и проверьте задачу с трудозатратами и задачу без них.

Фильтры: как оформить значение

Фильтр пишется после поля через |. Строковые параметры заключаются в обычные прямые кавычки. Несколько фильтров выполняются слева направо.

Фильтр	Пример	Что получится
money	{{ deal.opportunity | money }}	1 250,50 ₽ для 1250.5
money_no_currency	{{ deal.opportunity | money_no_currency }}	1 250,50
money_words	{{ totals.sum_with_vat | money_words }}	Сумма прописью в рублях и копейках
date	{{ item.created_date | date("dd.MM.yyyy HH:mm") }}	Например, 14.09.2026 14:53
duration	{{ item.time_spent_in_logs | duration("HH:mm:ss") }}	Длительность, например 02:35:00
phone	{{ contact.phone | phone }}	Например, +7 (999) 123-45-67
percent	{{ item.tax_rate | percent }}	12,50 % для 12.5
default	{{ contact.email | default("не указан") }}	Запасной текст для пустого значения
upper	{{ company.name | upper }}	Верхний регистр
lower	{{ company.name | lower }}	Нижний регистр
truncate	{{ deal.title | truncate(12) }}	Ограничение длины с многоточием

Денежные фильтры используют рубли и не выбирают символ по валюте CRM. percent не умножает число на 100: значение 0.125 не станет автоматически 12.5%.

В маске даты MM означает месяц, а mm — минуты. Форматирование существующей даты не является переводом в другой часовой пояс. Для телефонов вне показанного российского формата результат может остаться без изменения.

Пустое значение и отсутствующее поле могут обрабатываться по-разному. Проверяйте default на своих данных. Для отсутствующих трудозатрат используйте приведённую выше цепочку duration | default.

Модификаторы через тильду

Помимо фильтров, приложение поддерживает ряд выражений в одинарных скобках с модификатором после ~. Это отдельный синтаксис: не заменяйте в нём маски даты или параметры вариантами из фильтров.

Задача	Выражение
Дата	{item.created_date~d.m.Y}
Фамилия и инициалы	{ContactFormattedName~Format=#LAST_NAME# #NAME_SHORT# #SECOND_NAME_SHORT#}
ФИО в дательном падеже	{ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#,Case=1}
Телефон без пробелов	{contact.phone~format=E.164}
Адрес одной строкой	{company.legal_address~Format=5,Separator=1}
Верхний регистр	{company.name~letterCase=upper}
Сумма в рублях	{Opportunity~money=y}
Запасной текст	{contact.email~default=не указан}
Ограничение длины	{Title~truncate=12}

Для ФИО доступны #LAST_NAME#, #NAME#, #SECOND_NAME#, #NAME_SHORT#, #SECOND_NAME_SHORT#. Значения Case: -1 — именительный, 0 — родительный, 1 — дательный, 2 — винительный, 3 — творительный, 4 — предложный. Склонение конкретного имени проверяйте вручную.

Для множественного значения index=0 или mfirst=y выбирает первый элемент, а all=y объединяет значения. Это применимо, когда поле действительно передано списком. Сначала скопируйте свой путь из каталога, затем добавьте модификатор — не выдумывайте код множественного поля.

duration используется только как фильтр через | в двойных скобках. Полная совместимость со всеми конструкциями стандартного генератора Битрикс24 не предполагается.

Условия и незаполненные поля

Чтобы вывести КПП только при наличии, используйте условие:

{% if company.has_kpp %}КПП: {{ company.kpp }}{% endif %}

Для целых абзацев Word начало {%p if company.has_kpp %} и завершение {%p endif %} должны находиться в отдельных абзацах, между которыми расположен нужный текст. Перенос строки внутри одного абзаца не заменяет отдельный абзац.

В Excel для условного удаления строки разместите три строки:

{{#if company.has_kpp}}
КПП: {{ company.kpp }}
{{/if}}

Условный блок XLSX проверяет заполненность или истинность указанного пути. Произвольные сравнения и else для такого блока не поддерживаются. Используйте готовые логические поля из каталога.

Отсутствующие реквизиты не стоит заменять вымышленными значениями. Лучше убрать соответствующий блок условием или исправить данные клиента.

Как проверить шаблон и получить документ

Тестовая генерация

В карточке шаблона откройте «Тестовая генерация». Эта проверка использует заданные тестовые данные в формате JSON. Нажмите «Проверить JSON», затем «Сформировать документ», скачайте результат и откройте его.

Тест показывает, как шаблон обрабатывает переданные данные. Он не подтверждает, что такие же поля заполнены в реальной карточке CRM. Если вы не работаете с JSON, начните с готового примера и обязательно выполните следующий шаг — создание из контрольной карточки.

Создание из CRM

1. Откройте нужный лид, сделку, КП, счёт или элемент смарт-процесса внутри портала.
2. Запустите действие приложения «Сформировать документ».
3. Проверьте выбранную сущность и подходящий шаблон.
4. Запустите формирование и дождитесь результата.
5. Скачайте новый файл из интерфейса или раздела «Генерации»; при включённом прикреплении его можно найти и в таймлайне карточки. Откройте файл.
6. Сверьте название карточки, клиента, реквизиты, даты, товары, суммы и задачи с CRM.

При ошибке найдите попытку в разделе «Генерации» и прочитайте сообщение. Исправьте шаблон или исходные данные, затем выполните новый запуск: повторная генерация создаёт новый результат.

Контроль перед использованием

• В документе не осталось {{ ... }}, {% ... %} и других служебных выражений.
• Контрагент и своя организация не перепутаны.
• Длинные названия, кириллица, кавычки и переносы строк читаются корректно.
• Таблица проверена без элементов, с одним элементом и с несколькими.
• Суммы, скидки, налоги и нулевые значения соответствуют исходным данным.
• Даты и время показаны в нужном формате.
• Связанные задачи проверены с трудозатратами и без них.
• В Excel нет обрезанного текста, повреждённых формул и неожиданных разрывов области печати.

Если результат отличается от ожидаемого

Ситуация	Что проверить
Поле пустое	Код и регистр выражения, наличие значения, связь с клиентом, выбранную сущность и доступность данных
Пользовательское поле не найдено	Актуальный каталог вашего портала; номер поля в другом портале не подходит
Таблица не повторяется	Отдельные строки начала и конца, имя списка, одинаковое имя item внутри цикла
Нет задач	Связь задач с текущей карточкой CRM
Нет затраченного времени	Зарегистрированные трудозатраты; плановая оценка не равна затраченному времени
Ошибка duration	Формат seconds или HH:mm:ss и целые неотрицательные секунды на входе
Не копируется пример	Выделите текст и скопируйте вручную: браузер может ограничить доступ к буферу
Шаблон подходит сделке, но не лиду	Прямые пути вроде deal.title, выбор сущностей и использование подходящих алиасов
Файл создан, но оформление нарушено	Макет в Word или Excel, высоту строк, объединённые ячейки, длинный текст и печать

Ограничения и дополнительные возможности

Основные форматы шаблонов и результатов — DOCX и XLSX. Возможность «Сформировать PDF» зависит от настроенного преобразования в среде приложения. Проверяйте PDF отдельно; доступность флажка не заменяет проверку готового файла.

Изображения, QR- и штрихкоды требуют специально подготовленных данных. Произвольная ссылка в текстовом поле не гарантирует вставку изображения. Для первого шаблона используйте готовые основы, а сложные элементы добавляйте после успешной проверки обычных полей и таблиц.

Каталог не означает, что каждое поле заполнено в каждой карточке. Нет универсального шаблона, который без адаптации охватит любые пользовательские поля, все смарт-процессы и все варианты реквизитов. Подготовьте контрольный пример для каждого рабочего сценария.

Что в итоге должно быть у пользователя

Рабочий файл-шаблон, понятное назначение и список совместимых сущностей, проверенный документ из реальной карточки и сохранённый образец для дальнейшего сравнения. После этого можно использовать шаблон в повторяющихся операциях, проверяя важные данные перед отправкой документа.