[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"app-document-templates":3},{"slug":4,"title":5,"summary":6,"published":7,"logoImage":8,"previewImage":9,"heroImage":9,"installUrl":10,"marketUrl":10,"featureSlugs":11,"headMarkup":12,"lifecycleId":53,"preview":6,"bodyMd":54,"bodyHtml":55,"installMd":56,"installHtml":57,"hasInstallGuide":7,"featureSectionTitle":58},"document-templates","Генератор документов","Создавайте документы Word и Excel по своим шаблонам из данных CRM Битрикс24: поля, товары, реквизиты и связанные задачи.",true,"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Foriginals\u002Flogo.png","\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-01-library.webp",null,[],[13,25],{"tag":14,"type":15,"key":16,"json":17},"script","application\u002Fld+json","app-document-templates-software",{"@context":18,"@type":19,"@id":20,"name":5,"description":21,"operatingSystem":22,"applicationCategory":23,"url":24},"https:\u002F\u002Fschema.org","SoftwareApplication","software-document-templates","Создание документов DOCX и XLSX по пользовательским шаблонам из данных CRM Битрикс24.","Web","BusinessApplication","https:\u002F\u002Fs-webs24.ru\u002Fapps\u002Fdocument-templates\u002F",{"tag":14,"type":15,"key":26,"json":27},"faq-app-document-templates",{"@context":18,"@type":28,"@id":29,"mainEntity":30},"FAQPage","faq-document-templates",[31,37,41,45,49],{"@type":32,"name":33,"acceptedAnswer":34},"Question","Можно ли использовать свой шаблон?",{"@type":35,"text":36},"Answer","Да. Подготовьте файл DOCX или XLSX в Word или Excel, вставьте выражения из каталога и загрузите его. Для старта можно взять готовую основу из библиотеки. Внутри приложения есть примеры полей, таблиц и форматирования.",{"@type":32,"name":38,"acceptedAnswer":39},"Как вывести таблицу товаров?",{"@type":35,"text":40},"В шаблоне оформляется одна строка данных и отдельные служебные строки начала и конца повторения. При генерации строка данных повторится для товаров карточки. Примеры для Word и Excel находятся в разделе «Примеры и инструкция».",{"@type":32,"name":42,"acceptedAnswer":43},"Почему контрагент, контакт или банковские реквизиты остались пустыми?",{"@type":35,"text":44},"Проверьте, что клиент связан с карточкой, нужные реквизиты заполнены и используются правильные поля. Поля собственной организации и клиента различаются. Модификатор меняет отображение значения, но не получает отсутствующие данные.",{"@type":32,"name":46,"acceptedAnswer":47},"Можно ли вывести задачи сделки и время в формате ч:м:с?",{"@type":35,"text":48},"Да, для задач, связанных с CRM-карточкой. В таблицу добавляются название, дата создания и зарегистрированные трудозатраты. Например, 9300 секунд можно показать как 9300 или 02:35:00. Если время не зарегистрировано, значение может остаться пустым.",{"@type":32,"name":50,"acceptedAnswer":51},"Где найти готовый документ и изменится ли он после правки шаблона?",{"@type":35,"text":52},"Готовый документ можно скачать из интерфейса или раздела «Генерации». При включённом прикреплении он также появляется в таймлайне CRM-карточки. Скачайте и проверьте файл перед использованием. Изменения шаблона применяются к новым генерациям, а ранее сформированные файлы не переписываются. Для PDF нужна отдельная проверка доступности преобразования.","lc_843f9def781783b40e22d39cd5561e4e","Готовите коммерческие предложения, спецификации или клиентские документы по одному бланку? «Генератор документов» помогает менеджерам и сотрудникам, работающим с документами, переносить данные из CRM Битрикс24 в подготовленные шаблоны DOCX и XLSX.\n\nОформите файл в Word или Excel, добавьте поля из каталога и загрузите шаблон. Затем выбирайте его в нужной карточке CRM. Готовый файл можно скачать из интерфейса или раздела «Генерации»; при включённом прикреплении он также появится в таймлайне карточки. Откройте файл, сверьте данные и подготовьте его к отправке клиенту — с меньшим объёмом повторного копирования.\n\n![Библиотека готовых основ DOCX и XLSX в приложении](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-01-library.webp)\n\n## Что можно делать\n\n- **Готовить коммерческие предложения по карточкам CRM.** Выберите шаблон с данными клиента и нужными полями — получите документ по выбранной карточке. Подготовленная структура пригодится для следующих предложений.\n- **Создавать спецификации с таблицей товаров.** Добавьте в шаблон повторяющуюся строку с наименованием, количеством, ценой и суммой. При формировании строки заполнятся по товарам карточки — их не придётся переносить по одной.\n- **Использовать собственные бланки.** Загрузите свой DOCX или XLSX либо скачайте готовую основу из библиотеки и адаптируйте её. Каталог с копированием полей и раздел «Примеры и инструкция» помогут разобраться с подстановкой данных, таблицами и форматированием.\n- **Собирать документ по связанным задачам.** Добавьте таблицу с названием задачи, датой создания и зарегистрированными трудозатратами. Время можно вывести числом секунд или в формате часы:минуты:секунды, не переписывая сведения из каждой задачи вручную.\n\nЗапуск предусмотрен для лидов, сделок, компаний, контактов, предложений, счетов и выбранных смарт-процессов. Связанные задачи доступны не для всех типов: для предложений (КП) их список в проверенной реализации не загружается. Для каждого рабочего сценария подготовьте совместимый шаблон и проверьте его на данных своего портала.\n\n![Мастер шаблона с выбором сделки и переменных товаров](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-02-wizard.webp)\n\n## Скачать учебные шаблоны\n\nФайлы собраны как понятные основы для обучения. Они прошли анализ синтаксиса и контрольную подстановку на реализации зафиксированной ревизии. Это не юридически готовые документы: перед работой проверьте текст, реквизиты, суммы, НДС, печатную область и оформление.\n\n- [Краткое КП по сделке — DOCX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.docx) — данные сделки и клиента, товары, рублёвые суммы и итоги.\n- [Краткое КП по сделке — XLSX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.xlsx) — тот же учебный сценарий в Excel с повторяющейся строкой `{{#products}}`.\n- [Отчёт по связанным задачам — DOCX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.docx) — дата, название, секунды и длительность `HH:mm:ss`.\n- [Отчёт по связанным задачам — XLSX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.xlsx) — отдельная строка на задачу; отсутствующее время выводится как `00:00:00` через `duration | default`.\n\n## Как начать\n\n1. Установите приложение в свой Битрикс24 с помощью администратора или уполномоченного специалиста.\n2. В настройках встроек CRM выберите карточки, где нужно действие «Сформировать документ», и сохраните настройки.\n3. Откройте «Шаблоны»: создайте основу через мастер или загрузите свой файл. Укажите подходящие сущности и проверьте поля по каталогу.\n4. Сформируйте документ из контрольной карточки. Скачайте результат из интерфейса или раздела «Генерации»; если включено прикрепление к таймлайну, файл появится и там. Проверьте его в Word или Excel.\n\nВ разделе «Примеры и инструкция» собраны копируемые выражения для полей, товаров, связанных задач, дат и модификаторов. В разделе «Генерации» можно найти попытку формирования и сообщение об ошибке, если результат не получен.\n\n## Условия использования\n\n- Приложение работает внутри портала Битрикс24. Поля, связи с клиентом, реквизиты и трудозатраты должны быть заполнены и доступны. Точные коды пользовательских полей берите из каталога своего портала.\n- Макет редактируется в Word или Excel. Мастер создаёт шаблон из готовой основы, а не заменяет редактор произвольного оформления. Готовые основы не являются юридическим заключением: содержание и реквизиты проверяет пользователь.\n- Основные форматы — DOCX и XLSX. Формирование PDF зависит от настроенного преобразования и проверяется отдельно. Денежные фильтры используют рубли и не выбирают валюту автоматически.\n- В таблице задач выводятся зарегистрированные трудозатраты, а не плановая оценка и не время с момента создания. Перед использованием проверьте задачи с заполненным и пустым временем.\n- До установки уточните требования к тарифу и редакции, актуальные разрешения и условия сохранения данных при переустановке. Поддержку коробочной редакции и мобильного приложения необходимо согласовать отдельно.\n\nПеред отправкой клиенту проверяйте готовый файл: особенно суммы, реквизиты, длинные названия, таблицы и печатное оформление.\n\n## Вопросы и ответы\n\n### Можно ли использовать свой шаблон?\n\nДа. Подготовьте файл DOCX или XLSX в Word или Excel, вставьте выражения из каталога и загрузите его. Для старта можно взять готовую основу из библиотеки. Внутри приложения есть примеры полей, таблиц и форматирования.\n\n### Как вывести таблицу товаров?\n\nВ шаблоне оформляется одна строка данных и отдельные служебные строки начала и конца повторения. При генерации строка данных повторится для товаров карточки. Примеры для Word и Excel находятся в разделе «Примеры и инструкция».\n\n### Почему контрагент, контакт или банковские реквизиты остались пустыми?\n\nПроверьте, что клиент связан с карточкой, нужные реквизиты заполнены и используются правильные поля. Поля собственной организации и клиента различаются. Модификатор меняет отображение значения, но не получает отсутствующие данные.\n\n### Можно ли вывести задачи сделки и время в формате ч:м:с?\n\nДа, для задач, связанных с CRM-карточкой. В таблицу добавляются название, дата создания и зарегистрированные трудозатраты. Например, 9300 секунд можно показать как `9300` или `02:35:00`. Если время не зарегистрировано, значение может остаться пустым.\n\n### Где найти готовый документ и изменится ли он после правки шаблона?\n\nГотовый документ можно скачать из интерфейса или раздела «Генерации». При включённом прикреплении он также появляется в таймлайне CRM-карточки. Скачайте и проверьте файл перед использованием. Изменения шаблона применяются к новым генерациям, а ранее сформированные файлы не переписываются. Для PDF нужна отдельная проверка доступности преобразования.\n","\u003Cp>Готовите коммерческие предложения, спецификации или клиентские документы по одному бланку? «Генератор документов» помогает менеджерам и сотрудникам, работающим с документами, переносить данные из CRM Битрикс24 в подготовленные шаблоны DOCX и XLSX.\u003C\u002Fp>\n\u003Cp>Оформите файл в Word или Excel, добавьте поля из каталога и загрузите шаблон. Затем выбирайте его в нужной карточке CRM. Готовый файл можно скачать из интерфейса или раздела «Генерации»; при включённом прикреплении он также появится в таймлайне карточки. Откройте файл, сверьте данные и подготовьте его к отправке клиенту — с меньшим объёмом повторного копирования.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-01-library.webp\" alt=\"Библиотека готовых основ DOCX и XLSX в приложении\">\u003C\u002Fp>\n\u003Ch2>Что можно делать\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Готовить коммерческие предложения по карточкам CRM.\u003C\u002Fstrong> Выберите шаблон с данными клиента и нужными полями — получите документ по выбранной карточке. Подготовленная структура пригодится для следующих предложений.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Создавать спецификации с таблицей товаров.\u003C\u002Fstrong> Добавьте в шаблон повторяющуюся строку с наименованием, количеством, ценой и суммой. При формировании строки заполнятся по товарам карточки — их не придётся переносить по одной.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Использовать собственные бланки.\u003C\u002Fstrong> Загрузите свой DOCX или XLSX либо скачайте готовую основу из библиотеки и адаптируйте её. Каталог с копированием полей и раздел «Примеры и инструкция» помогут разобраться с подстановкой данных, таблицами и форматированием.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Собирать документ по связанным задачам.\u003C\u002Fstrong> Добавьте таблицу с названием задачи, датой создания и зарегистрированными трудозатратами. Время можно вывести числом секунд или в формате часы:минуты:секунды, не переписывая сведения из каждой задачи вручную.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Запуск предусмотрен для лидов, сделок, компаний, контактов, предложений, счетов и выбранных смарт-процессов. Связанные задачи доступны не для всех типов: для предложений (КП) их список в проверенной реализации не загружается. Для каждого рабочего сценария подготовьте совместимый шаблон и проверьте его на данных своего портала.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-02-wizard.webp\" alt=\"Мастер шаблона с выбором сделки и переменных товаров\">\u003C\u002Fp>\n\u003Ch2>Скачать учебные шаблоны\u003C\u002Fh2>\n\u003Cp>Файлы собраны как понятные основы для обучения. Они прошли анализ синтаксиса и контрольную подстановку на реализации зафиксированной ревизии. Это не юридически готовые документы: перед работой проверьте текст, реквизиты, суммы, НДС, печатную область и оформление.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.docx\">Краткое КП по сделке — DOCX\u003C\u002Fa> — данные сделки и клиента, товары, рублёвые суммы и итоги.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.xlsx\">Краткое КП по сделке — XLSX\u003C\u002Fa> — тот же учебный сценарий в Excel с повторяющейся строкой \u003Ccode>{{#products}}\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.docx\">Отчёт по связанным задачам — DOCX\u003C\u002Fa> — дата, название, секунды и длительность \u003Ccode>HH:mm:ss\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.xlsx\">Отчёт по связанным задачам — XLSX\u003C\u002Fa> — отдельная строка на задачу; отсутствующее время выводится как \u003Ccode>00:00:00\u003C\u002Fcode> через \u003Ccode>duration | default\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Как начать\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Установите приложение в свой Битрикс24 с помощью администратора или уполномоченного специалиста.\u003C\u002Fli>\n\u003Cli>В настройках встроек CRM выберите карточки, где нужно действие «Сформировать документ», и сохраните настройки.\u003C\u002Fli>\n\u003Cli>Откройте «Шаблоны»: создайте основу через мастер или загрузите свой файл. Укажите подходящие сущности и проверьте поля по каталогу.\u003C\u002Fli>\n\u003Cli>Сформируйте документ из контрольной карточки. Скачайте результат из интерфейса или раздела «Генерации»; если включено прикрепление к таймлайну, файл появится и там. Проверьте его в Word или Excel.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>В разделе «Примеры и инструкция» собраны копируемые выражения для полей, товаров, связанных задач, дат и модификаторов. В разделе «Генерации» можно найти попытку формирования и сообщение об ошибке, если результат не получен.\u003C\u002Fp>\n\u003Ch2>Условия использования\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Приложение работает внутри портала Битрикс24. Поля, связи с клиентом, реквизиты и трудозатраты должны быть заполнены и доступны. Точные коды пользовательских полей берите из каталога своего портала.\u003C\u002Fli>\n\u003Cli>Макет редактируется в Word или Excel. Мастер создаёт шаблон из готовой основы, а не заменяет редактор произвольного оформления. Готовые основы не являются юридическим заключением: содержание и реквизиты проверяет пользователь.\u003C\u002Fli>\n\u003Cli>Основные форматы — DOCX и XLSX. Формирование PDF зависит от настроенного преобразования и проверяется отдельно. Денежные фильтры используют рубли и не выбирают валюту автоматически.\u003C\u002Fli>\n\u003Cli>В таблице задач выводятся зарегистрированные трудозатраты, а не плановая оценка и не время с момента создания. Перед использованием проверьте задачи с заполненным и пустым временем.\u003C\u002Fli>\n\u003Cli>До установки уточните требования к тарифу и редакции, актуальные разрешения и условия сохранения данных при переустановке. Поддержку коробочной редакции и мобильного приложения необходимо согласовать отдельно.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Перед отправкой клиенту проверяйте готовый файл: особенно суммы, реквизиты, длинные названия, таблицы и печатное оформление.\u003C\u002Fp>\n\u003Ch2>Вопросы и ответы\u003C\u002Fh2>\n\u003Ch3>Можно ли использовать свой шаблон?\u003C\u002Fh3>\n\u003Cp>Да. Подготовьте файл DOCX или XLSX в Word или Excel, вставьте выражения из каталога и загрузите его. Для старта можно взять готовую основу из библиотеки. Внутри приложения есть примеры полей, таблиц и форматирования.\u003C\u002Fp>\n\u003Ch3>Как вывести таблицу товаров?\u003C\u002Fh3>\n\u003Cp>В шаблоне оформляется одна строка данных и отдельные служебные строки начала и конца повторения. При генерации строка данных повторится для товаров карточки. Примеры для Word и Excel находятся в разделе «Примеры и инструкция».\u003C\u002Fp>\n\u003Ch3>Почему контрагент, контакт или банковские реквизиты остались пустыми?\u003C\u002Fh3>\n\u003Cp>Проверьте, что клиент связан с карточкой, нужные реквизиты заполнены и используются правильные поля. Поля собственной организации и клиента различаются. Модификатор меняет отображение значения, но не получает отсутствующие данные.\u003C\u002Fp>\n\u003Ch3>Можно ли вывести задачи сделки и время в формате ч:м:с?\u003C\u002Fh3>\n\u003Cp>Да, для задач, связанных с CRM-карточкой. В таблицу добавляются название, дата создания и зарегистрированные трудозатраты. Например, 9300 секунд можно показать как \u003Ccode>9300\u003C\u002Fcode> или \u003Ccode>02:35:00\u003C\u002Fcode>. Если время не зарегистрировано, значение может остаться пустым.\u003C\u002Fp>\n\u003Ch3>Где найти готовый документ и изменится ли он после правки шаблона?\u003C\u002Fh3>\n\u003Cp>Готовый документ можно скачать из интерфейса или раздела «Генерации». При включённом прикреплении он также появляется в таймлайне CRM-карточки. Скачайте и проверьте файл перед использованием. Изменения шаблона применяются к новым генерациям, а ранее сформированные файлы не переписываются. Для PDF нужна отдельная проверка доступности преобразования.\u003C\u002Fp>\n","Это руководство ведёт от установки и первого DOCX до товаров, реквизитов, пользовательских полей, лидов, сделок, КП, счетов, смарт-процессов, связанных задач, условий, дат, длительности и модификаторов.\n\n## Перед установкой\n\nПоручите установку администратору вашего Битрикс24 или специалисту, которому разрешено устанавливать приложения и настраивать CRM.\n\nДля первой проверки подготовьте:\n\n- Карточку CRM с контрольными данными и доступом к ней.\n- Небольшой шаблон DOCX или XLSX либо готовность воспользоваться библиотекой пресетов.\n- Word или Excel для проверки соответствующего файла после формирования.\n\nОткрывайте приложение внутри своего портала Битрикс24. Прямое открытие страницы приложения вне портала не заменяет установку и подключение к CRM.\n\n## Установка\n\nЭти шаги применяются, когда карточка «Генератор документов» доступна для установки в вашем Битрикс24. Если приложение не находится в Маркете, уточните у разработчика его доступность и ссылку для вашего портала.\n\n1. Войдите в нужный портал Битрикс24 под учётной записью, которой разрешена установка приложений.\n2. Откройте в Маркете карточку «Генератор документов».\n3. Ознакомьтесь с условиями и запрошенными разрешениями в карточке.\n4. Запустите установку доступным в карточке действием.\n5. Дождитесь завершения экрана «Установка приложения». Во время работы на нём отображаются этапы подготовки и завершения установки.\n6. Убедитесь, что появилось сообщение «Установка завершена».\n7. Откройте установленное приложение внутри этого же портала.\n\n![Раздел со встроенной справкой и копируемыми примерами](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Finstall-01-guide.webp)\n\nСообщение «Не удалось завершить установку» означает, что установка не завершена. Не принимайте открывшуюся страницу или частично заполненную полосу прогресса за успешный результат.\n\n## Разрешения и доступ\n\nДля подготовки документа приложению нужны данные той CRM-карточки, которую вы выбираете. Если используются связанные компания, контакт, реквизиты или задачи, соответствующие сведения должны быть заполнены и доступны. Для прикрепления результата требуется возможность работы с файлами в портале.\n\nПроверяйте точный перечень запрашиваемых разрешений в окне установки. Если нужные сведения не загружаются, обратитесь к администратору или разработчику; не пытайтесь исправить это созданием собственных ключей или передачей паролей.\n\nУстановка приложения не является подтверждением того, что каждому сотруднику доступны все карточки и поля. Перед рабочим использованием проверьте выбранный сценарий под учётной записью будущего пользователя.\n\n## Первая настройка\n\n### Подключите действие в нужных карточках CRM\n\n1. В меню приложения откройте раздел «Bitrix24».\n2. Найдите блок «Встройки в карточках CRM».\n3. Нажмите «Открыть настройки встроек».\n4. На странице «Встройки CRM» отметьте нужные стандартные сущности.\n5. В блоке «Смарт-процессы» отметьте нужные процессы, если они есть в списке.\n6. Нажмите «Сохранить и зарегистрировать».\n7. Дождитесь сообщения «Сохранено» с количеством зарегистрированных встроек.\n8. Откройте контрольную карточку выбранной сущности и проверьте наличие действия «Сформировать документ» в верхней панели.\n\nВ списке могут быть лиды, сделки, счета, предложения и доступные смарт-процессы. Выбирайте только необходимые места запуска. Не считайте, что действие включено во всех карточках сразу после установки: проверьте сохранённые настройки.\n\nЕсли нужный смарт-процесс добавлен позднее, нажмите «Обновить список смартов», выберите его и снова сохраните настройки. Сообщение об отсутствии дополнительных смарт-процессов само по себе не означает ошибку установки приложения.\n\n### Подготовьте один контрольный шаблон\n\n1. Откройте «Шаблоны» → «Мастер шаблона».\n2. Выберите источник данных для каталога переменных: сделку, лид, компанию, контакт или ручной JSON. Этот выбор помогает получить подсказки, но сам по себе не задаёт совместимость создаваемого шаблона.\n3. Выберите базовый пресет. Формат и совместимые сущности будущего шаблона наследуются от выбранного пресета — проверьте их до создания.\n4. Просмотрите «Переменные и примеры» и при необходимости обновите каталог.\n5. Укажите название и уникальный код шаблона.\n6. Нажмите «Создать из пресета».\n\nЕсли используете собственный файл, выберите «Шаблоны» → «Новый шаблон», заполните название, код, тип и файл, отметьте совместимые сущности и нажмите «Загрузить шаблон».\n\nПодробные правила подготовки DOCX, XLSX, полей и таблиц находятся в разделе «Примеры и инструкция». Наличие шаблона обязательно для контрольной генерации, но сложный рабочий макет не нужен для проверки самой установки.\n\n## Проверка установки\n\nПроверьте не только сообщение о завершении, но и весь первый сценарий:\n\n1. Откройте главную страницу приложения внутри портала и убедитесь, что интерфейс загрузился.\n2. Откройте «Шаблоны» и найдите созданный контрольный шаблон.\n3. Проверьте каталог полей для его CRM-сущности.\n4. Откройте соответствующую контрольную карточку CRM.\n5. Нажмите «Сформировать документ» и выберите совместимый шаблон.\n6. Дождитесь формирования. Скачайте файл из интерфейса или раздела «Генерации»; при включённом прикреплении он также появится в таймлайне карточки.\n7. Откройте файл в Word или Excel.\n8. Сверьте несколько известных значений с карточкой и убедитесь, что служебные выражения заменились данными.\n\nУспешный результат: приложение открывается в портале, нужное действие доступно в карточке, шаблон выбирается, новый документ создаётся и его данные соответствуют контрольному примеру.\n\nНачните с DOCX или XLSX. PDF — отдельная возможность, зависящая от настроенного преобразования, и её проверяют после успешного основного сценария.\n\n## Частые проблемы первой настройки\n\n| Ситуация | Безопасное действие |\n| --- | --- |\n| Приложение не находится в Маркете | Уточните у разработчика доступность и правильную карточку для вашего портала |\n| «Не удалось завершить установку» | Сохраните текст ошибки и сообщите администратору или разработчику, на каком этапе она возникла |\n| Приложение открыто отдельно от портала | Вернитесь в Битрикс24 и откройте установленное приложение оттуда |\n| Нет действия «Сформировать документ» | Проверьте выбранные сущности во «Встройках CRM» и результат «Сохранить и зарегистрировать» |\n| Не виден нужный смарт-процесс | Нажмите «Обновить список смартов» и проверьте наличие процесса в самом портале |\n| Нет совместимого шаблона | Создайте или загрузите шаблон для выбранного типа карточки |\n| Каталог полей пустой или не загрузился | Убедитесь, что приложение открыто внутри портала; повторите обновление каталога и прочитайте сообщение об ошибке |\n| Реквизиты или контакт в документе пустые | Проверьте связи и заполнение данных в контрольной карточке; это не обязательно ошибка установки |\n| Документ не сформирован | Найдите попытку в разделе «Генерации», прочитайте сообщение и исправьте указанные данные или шаблон |\n\nПри обращении за помощью достаточно указать действие, время ошибки и её текст. Не отправляйте пароли, коды доступа или документы с конфиденциальными данными без необходимости.\n\n## Перед удалением или повторной установкой\n\nНе используйте удаление приложения как первый способ исправления ошибки. Сначала сохраните исходные шаблоны и необходимые сформированные документы, затем уточните у разработчика порядок повторной установки и сохранность данных.\n\n## Что уточнить перед установкой\n\n- Доступность карточки приложения для вашего портала, если её ещё нельзя установить из Маркета.\n- Требования к тарифу и редакции вашего Битрикс24.\n- Окончательный перечень разрешений в доступной для установки версии.\n- Сохранение шаблонов, настроек и истории при удалении или повторной установке.\n\nПоддержку коробочной редакции, мобильного приложения и формирование PDF при необходимости согласуйте отдельно до использования этих сценариев.\n\n\n## Подробная работа с шаблонами\n\n## Для чего нужно приложение\n\nПриложение подставляет данные CRM Битрикс24 в подготовленные файлы DOCX и XLSX. Вы один раз оформляете документ в Word или Excel, обозначаете изменяемые поля и таблицы, загружаете шаблон, а затем создаёте документы по карточкам CRM.\n\nЭто полезно менеджерам по продажам, сотрудникам, которые готовят коммерческие предложения и спецификации, и специалистам, которым нужны документы с перечнем связанных задач и зарегистрированными трудозатратами.\n\nОсновной результат — файл с данными выбранной карточки. Его можно скачать из интерфейса или раздела «Генерации»; при включённом прикреплении файл также появляется в таймлайне CRM-карточки. Перед отправкой клиенту документ необходимо открыть и проверить.\n\n## Что можно подготовить\n\n- Коммерческое предложение с данными клиента и таблицей товаров.\n- Спецификацию с количеством, ценами, суммами и итогами.\n- Документ на основе своего бланка с полями CRM и реквизитами.\n- Отчёт по связанным задачам: название, дата создания и зарегистрированное время.\n\nГенерация предусмотрена для лидов, сделок, предложений (КП), счетов и смарт-процессов. Список доступных сущностей и поля определяются в вашем портале. Выбирайте только те сущности, под которые подготовлен шаблон.\n\nПриложение не подменяет проверку содержания договора, бухгалтерского или юридически значимого документа. Текст, расчёты и реквизиты, которые вы используете в своей работе, необходимо согласовать самостоятельно.\n\n## Перед первым документом\n\n1. Откройте установленное приложение внутри Битрикс24.\n2. Подготовьте контрольную карточку CRM с понятными вам значениями: названием, клиентом, товарами и необходимыми пользовательскими полями.\n3. Если документ должен содержать реквизиты, заполните их у связанной компании или контакта. Для банковских данных нужны заполненные банковские реквизиты.\n4. Для редактирования макета используйте Word для DOCX или Excel для XLSX. Готовый результат также проверяйте в подходящем офисном редакторе.\n5. Откройте раздел «Примеры и инструкция». В нём есть поиск, копирование выражений, примеры для обоих форматов и описание ограничений.\n\nВсе организации, имена, суммы и банковские значения ниже — учебные. Их нельзя использовать вместо реквизитов реального клиента.\n\n## Быстрый старт через мастер\n\nВ разделе «Шаблоны» нажмите «Мастер шаблона».\n\n1. **Сценарий документа.** Выберите понятный вам вариант, чтобы сориентироваться в мастере.\n2. **Источник данных.** Выберите источник для каталога переменных: сделку, лид, компанию, контакт или ручной JSON. Он определяет подсказки на этом шаге, но не привязывает созданный шаблон к сущности.\n3. **Базовый пресет.** Выберите готовую основу и прочитайте её описание. Именно пресет задаёт формат и совместимые сущности создаваемого шаблона.\n4. **Переменные и примеры.** Просмотрите каталог полей. При необходимости нажмите «Обновить каталог», найдите нужное поле и скопируйте выражение. До загрузки каталога портал может показывать только переменные базового пресета — это не полный перечень ваших полей.\n5. **Создание шаблона.** Укажите понятное название и уникальный код, затем нажмите «Создать из пресета».\n\nМастер создаёт шаблон на основе выбранного пресета. Он не является редактором произвольной вёрстки документа. Чтобы изменить структуру, шапку или таблицы, нажмите «Скачать пример», отредактируйте файл в Word или Excel и загрузите свой вариант.\n\nГотовые основы также доступны в разделе «Библиотека пресетов». Если уже есть собственный бланк, можно сразу перейти к загрузке.\n\n![Мастер шаблона: формат DOCX, источник «Сделка» и каталог товаров](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-02-wizard.webp)\n\n## Как загрузить свой шаблон\n\n1. Сохраните рабочий бланк как `.docx` или `.xlsx`.\n2. Замените изменяемый текст выражениями полей. Обычные подписи, заголовки и оформление оставьте в файле.\n3. В приложении откройте «Шаблоны» → «Новый шаблон».\n4. Укажите «Название», «Код», «Тип» и «Файл». Для кода удобно использовать понятное обозначение, например `offer_equipment_v1`.\n5. В блоке «Сущности шаблона» отметьте нужные карточки CRM и смарт-процессы.\n6. Нажмите «Открыть поля», чтобы получить актуальные выражения для выбранных сущностей. Если изменили файл после выбора, перед загрузкой выберите его актуальную версию.\n7. Нажмите «Загрузить шаблон» и проверьте результат анализа переменных.\n8. Устраните ошибки выражений до использования шаблона в работе.\n\nНе переносите номер пользовательского поля или смарт-процесса из чужого примера: на вашем портале он может отличаться. Каталог — основной источник точных кодов.\n\nВ карточке шаблона можно скачать исходный файл, открыть редактирование и выполнить тестовую генерацию. Изменение шаблона применяется к новым документам; ранее сформированные файлы не переписываются.\n\n## Скачать учебные шаблоны\n\nФайлы собраны как понятные основы для обучения. Они прошли анализ синтаксиса и контрольную подстановку на реализации зафиксированной ревизии. Это не юридически готовые документы: перед работой проверьте текст, реквизиты, суммы, НДС, печатную область и оформление.\n\n- [Краткое КП по сделке — DOCX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.docx) — данные сделки и клиента, товары, рублёвые суммы и итоги.\n- [Краткое КП по сделке — XLSX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.xlsx) — тот же учебный сценарий в Excel с повторяющейся строкой `{{#products}}`.\n- [Отчёт по связанным задачам — DOCX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.docx) — дата, название, секунды и длительность `HH:mm:ss`.\n- [Отчёт по связанным задачам — XLSX](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.xlsx) — отдельная строка на задачу; отсутствующее время выводится как `00:00:00` через `duration | default`.\n\n\n## Как вставлять поля\n\nВ основном синтаксисе путь к полю заключают в двойные фигурные скобки:\n\n```text\nКоммерческое предложение\nПо сделке: {{ deal.title }}\nКонтрагент: {{ company.name }}\nИНН: {{ company.inn }}\nКонтактное лицо: {{ contact.formatted_name }}\n```\n\nПри генерации выражения заменятся значениями. Например, `{{ deal.title }}` превратится в «Поставка оборудования».\n\n### Как выбрать сущность\n\n| Данные | Корень выражения |\n| --- | --- |\n| Сделка | `deal` |\n| Лид | `lead` |\n| Предложение (КП) | `quote` |\n| Счёт | `invoice` |\n| Компания | `company` |\n| Контакт | `contact` |\n| Смарт-процесс | `dynamic_NNN`, где номер берётся из вашего каталога |\n\nПриложение также поддерживает алиасы в одинарных скобках. Например, `{Title}` используется для названия текущей сущности.\n\nОтметка нескольких сущностей в настройках не превращает `deal.title` в название лида или счёта. Для общего шаблона выбирайте подходящие алиасы из каталога и проверяйте результат отдельно для каждого типа карточки.\n\nНе меняйте регистр символов в скопированном коде поля. Человекочитаемое название поля в CRM и выражение для документа — не всегда одно и то же.\n\n### Какие данные доступны в разных сценариях\n\n- Сделка: `deal`, связанная компания и контакт, ответственный, `products`, `totals`, `tasks`, `my_company`.\n- Лид: `lead`, связанная компания и контакт, ответственный, `products`, `totals`, `tasks`, `my_company`.\n- Счёт: `invoice`, связанная компания и контакт, ответственный, `products`, `totals`, `tasks`, `my_company`.\n- Предложение или КП: `quote`, связанная компания и контакт, ответственный, `products`, `totals`, `my_company`. Список `tasks` для `quote` в проверенной реализации не загружается.\n- Смарт-процесс: `dynamic_NNN`, связанная компания и контакт, ответственный, `products`, `totals`, `tasks`, `my_company` — в пределах данных и связей конкретного элемента.\n- Компания и контакт могут использоваться как текущая сущность; товарный список для них пуст.\n\nНа контрольном портале смарт-процесс «Всё включено» имел корень `dynamic_1038`, поэтому выражение названия выглядело так:\n\n```text\n{{ dynamic_1038.title }}\n```\n\n`1038` — реальный пример из контрольного каталога, а не универсальный номер. Для другого портала скопируйте собственный `dynamic_NNN`.\n\n### Реальные коды пользовательских полей из контрольного каталога\n\nВ проверенной сделке использовались:\n\n- текст — `UF_CRM_1787148491040`;\n- дата и время — `UF_CRM_1787148514204`;\n- список — `UF_CRM_1787148581370`;\n- число — `UF_CRM_1787148609337`;\n- флаг — `UF_CRM_1787148631471`.\n\nКопируемые примеры для текущей сущности:\n\n```text\n{UF_CRM_1787148491040}\n{UF_CRM_1787148514204~d.m.Y H:i}\n{UF_CRM_1787148581370}\n{UF_CRM_1787148609337}\n{UF_CRM_1787148631471}\n```\n\nДля сделки те же данные проверялись через прямые пути:\n\n```text\n{{ deal.uf_crm_1787148491040 }}\n{{ deal.uf_crm_1787148514204 }}\n{{ deal.uf_crm_1787148581370 }}\n{{ deal.uf_crm_1787148609337 }}\n{{ deal.uf_crm_1787148631471 }}\n```\n\nВ каталоге конкретного портала написание пути может отличаться. Не собирайте выражение из номера вручную: откройте поля выбранной сущности и скопируйте готовый код.\n\n### Контрагент, контакт и банковские реквизиты\n\nПример блока клиента:\n\n```text\nПокупатель: {{ company.name }}\nИНН: {{ company.inn }}\nКонтакт: {{ contact.formatted_name }}\nБанк: {{ company.bank_detail.bank_name }}\nРасчётный счёт: {{ company.bank_detail.account_number }}\n```\n\nЕсли блок пустой, проверьте связь карточки с клиентом, заполнение соответствующих реквизитов и доступность данных. Форматирование не может получить отсутствующие сведения.\n\nДля продавца используйте поля раздела «Моя компания» в каталоге. Не подставляйте реквизиты клиента на место реквизитов собственной организации.\n\n## Таблица товаров в Word\n\nСоздайте настоящую таблицу Word. В ней нужны строка заголовков, отдельная служебная строка начала цикла, строка данных и отдельная служебная строка конца цикла.\n\n| Строка | Содержимое |\n| --- | --- |\n| Заголовок | №, Наименование, Количество, Сумма — в отдельных ячейках |\n| Начало цикла | `{%tr for item in products %}` в первой ячейке |\n| Данные | `{{ loop.index }}`, `{{ item.name }}`, `{{ item.qty }}`, `{{ item.sum \\| money }}` — по соответствующим ячейкам |\n| Конец цикла | `{%tr endfor %}` в первой ячейке |\n\nПри генерации служебные строки удаляются, а строка данных повторяется для каждого товара. Заголовок остаётся один. Если товаров нет, строк данных не будет.\n\nПод таблицей можно добавить сумму прописью:\n\n```text\nИтого прописью: {{ totals.sum_with_vat | money_words }}\n```\n\nДля цены, скидки и налога выбирайте нужные поля каталога и сверяйте результат с карточкой. Не заменяйте итог произвольным выражением, если не проверили его смысл для ваших цен и налогов.\n\n## Таблица товаров в Excel\n\nВ XLSX границы цикла и строка данных также должны занимать отдельные строки листа.\n\n| Ячейка | Содержимое |\n| --- | --- |\n| A1–D1 | Заголовки: Наименование, Количество, Цена, Сумма |\n| A2 | `{{#products}}` |\n| A3 | `{{ item.name }}` |\n| B3 | `{{ item.qty }}` |\n| C3 | `{{ item.price \\| money_no_currency }}` |\n| D3 | `{{ item.sum \\| money }}` |\n| A4 | `{{\u002Fproducts}}` |\n\nСтрока 3 повторится по числу товаров, служебные строки будут удалены, а расположенные ниже строки сдвинутся. Оформление заголовков и строки данных задайте до загрузки.\n\nНе объединяйте ячейки через границы цикла или условного блока. Отдельно проверяйте формулы, высоту строк, перенос длинных названий и область печати. Денежные фильтры создают оформленное представление суммы; не рассчитывайте на него как на универсальную числовую ячейку для дальнейших вычислений.\n\n## Связанные задачи: дата, название и время\n\nЗадача должна быть связана с той CRM-сущностью, по которой создаётся документ. Табличный список таких задач доступен как `tasks`.\n\nДля Word создайте таблицу с тремя столбцами: «Дата создания», «Задача», «Затраченное время». Разместите начало и конец цикла в отдельных служебных строках:\n\n```text\n{%tr for item in tasks %}\n```\n\nВ трёх ячейках строки данных разместите соответственно:\n\n```text\n{{ item.created_date | date }}\n{{ item.title }}\n{{ item.time_spent_in_logs | duration(\"HH:mm:ss\") }}\n```\n\nВ строке завершения:\n\n```text\n{%tr endfor %}\n```\n\nДля Excel используйте ту же строку данных, но отдельные строки начала и завершения замените на `{{#tasks}}` и `{{\u002Ftasks}}`.\n\n`time_spent_in_logs` — зарегистрированные трудозатраты в секундах. Это не плановая длительность и не время, прошедшее с момента создания задачи. Если трудозатраты не зарегистрированы, значение может отсутствовать.\n\n### Как выбрать формат времени\n\n| Выражение | Результат для 9300 секунд |\n| --- | --- |\n| `{{ item.time_spent_in_logs \\| duration(\"seconds\") }}` | `9300` |\n| `{{ item.time_spent_in_logs \\| duration(\"HH:mm:ss\") }}` | `02:35:00` |\n| `{{ item.time_spent_in_logs \\| duration }}` | `02:35:00` |\n\nЭто длительность, а не время суток: 90061 секунда выводится как `25:01:01`. Часы не сбрасываются после суток.\n\nНоль даёт `0` или `00:00:00`. Отсутствующее значение остаётся пустым. Чтобы явно показывать ноль вместо пустоты, используйте именно такой порядок фильтров:\n\n```text\n{{ item.time_spent_in_logs | duration | default(\"00:00:00\") }}\n```\n\nПоддерживаются только форматы `seconds` и `HH:mm:ss`. На входе нужны целые неотрицательные секунды. Строки «2 часа» или «02:35:00», отрицательные и дробные секунды не подходят.\n\nВ отдельной ячейке XLSX `duration(\"seconds\")` сохраняет числовой тип для полученных секунд. Запасное значение `default(\"0\")` будет текстом. Прежде чем применять новый формат в рабочем шаблоне, сформируйте контрольный файл на своём портале и проверьте задачу с трудозатратами и задачу без них.\n\n![Копируемые примеры duration: секунды и HH:mm:ss](\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Finstall-02-duration.webp)\n\n## Фильтры: как оформить значение\n\nФильтр пишется после поля через `|`. Строковые параметры заключаются в обычные прямые кавычки. Несколько фильтров выполняются слева направо.\n\n| Фильтр | Пример | Что получится |\n| --- | --- | --- |\n| `money` | `{{ deal.opportunity \\| money }}` | `1 250,50 ₽` для 1250.5 |\n| `money_no_currency` | `{{ deal.opportunity \\| money_no_currency }}` | `1 250,50` |\n| `money_words` | `{{ totals.sum_with_vat \\| money_words }}` | Сумма прописью в рублях и копейках |\n| `date` | `{{ item.created_date \\| date(\"dd.MM.yyyy HH:mm\") }}` | Например, `14.09.2026 14:53` |\n| `duration` | `{{ item.time_spent_in_logs \\| duration(\"HH:mm:ss\") }}` | Длительность, например `02:35:00` |\n| `phone` | `{{ contact.phone \\| phone }}` | Например, `+7 (999) 123-45-67` |\n| `percent` | `{{ item.tax_rate \\| percent }}` | `12,50 %` для 12.5 |\n| `default` | `{{ contact.email \\| default(\"не указан\") }}` | Запасной текст для пустого значения |\n| `upper` | `{{ company.name \\| upper }}` | Верхний регистр |\n| `lower` | `{{ company.name \\| lower }}` | Нижний регистр |\n| `truncate` | `{{ deal.title \\| truncate(12) }}` | Ограничение длины с многоточием |\n\nДенежные фильтры используют рубли и не выбирают символ по валюте CRM. `percent` не умножает число на 100: значение 0.125 не станет автоматически 12.5%.\n\nВ маске даты `MM` означает месяц, а `mm` — минуты. Форматирование существующей даты не является переводом в другой часовой пояс. Для телефонов вне показанного российского формата результат может остаться без изменения.\n\nПустое значение и отсутствующее поле могут обрабатываться по-разному. Проверяйте `default` на своих данных. Для отсутствующих трудозатрат используйте приведённую выше цепочку `duration | default`.\n\n## Модификаторы через тильду\n\nПомимо фильтров, приложение поддерживает ряд выражений в одинарных скобках с модификатором после `~`. Это отдельный синтаксис: не заменяйте в нём маски даты или параметры вариантами из фильтров.\n\n| Задача | Выражение |\n| --- | --- |\n| Дата | `{item.created_date~d.m.Y}` |\n| Фамилия и инициалы | `{ContactFormattedName~Format=#LAST_NAME# #NAME_SHORT# #SECOND_NAME_SHORT#}` |\n| ФИО в дательном падеже | `{ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#,Case=1}` |\n| Телефон без пробелов | `{contact.phone~format=E.164}` |\n| Адрес одной строкой | `{company.legal_address~Format=5,Separator=1}` |\n| Верхний регистр | `{company.name~letterCase=upper}` |\n| Сумма в рублях | `{Opportunity~money=y}` |\n| Запасной текст | `{contact.email~default=не указан}` |\n| Ограничение длины | `{Title~truncate=12}` |\n\nДля ФИО доступны `#LAST_NAME#`, `#NAME#`, `#SECOND_NAME#`, `#NAME_SHORT#`, `#SECOND_NAME_SHORT#`. Значения `Case`: `-1` — именительный, `0` — родительный, `1` — дательный, `2` — винительный, `3` — творительный, `4` — предложный. Склонение конкретного имени проверяйте вручную.\n\nДля множественного значения `index=0` или `mfirst=y` выбирает первый элемент, а `all=y` объединяет значения. Это применимо, когда поле действительно передано списком. Сначала скопируйте свой путь из каталога, затем добавьте модификатор — не выдумывайте код множественного поля.\n\n`duration` используется только как фильтр через `|` в двойных скобках. Полная совместимость со всеми конструкциями стандартного генератора Битрикс24 не предполагается.\n\n## Условия и незаполненные поля\n\nЧтобы вывести КПП только при наличии, используйте условие:\n\n```text\n{% if company.has_kpp %}КПП: {{ company.kpp }}{% endif %}\n```\n\nДля целых абзацев Word начало `{%p if company.has_kpp %}` и завершение `{%p endif %}` должны находиться в отдельных абзацах, между которыми расположен нужный текст. Перенос строки внутри одного абзаца не заменяет отдельный абзац.\n\nВ Excel для условного удаления строки разместите три строки:\n\n```text\n{{#if company.has_kpp}}\nКПП: {{ company.kpp }}\n{{\u002Fif}}\n```\n\nУсловный блок XLSX проверяет заполненность или истинность указанного пути. Произвольные сравнения и `else` для такого блока не поддерживаются. Используйте готовые логические поля из каталога.\n\nОтсутствующие реквизиты не стоит заменять вымышленными значениями. Лучше убрать соответствующий блок условием или исправить данные клиента.\n\n## Как проверить шаблон и получить документ\n\n### Тестовая генерация\n\nВ карточке шаблона откройте «Тестовая генерация». Эта проверка использует заданные тестовые данные в формате JSON. Нажмите «Проверить JSON», затем «Сформировать документ», скачайте результат и откройте его.\n\nТест показывает, как шаблон обрабатывает переданные данные. Он не подтверждает, что такие же поля заполнены в реальной карточке CRM. Если вы не работаете с JSON, начните с готового примера и обязательно выполните следующий шаг — создание из контрольной карточки.\n\n### Создание из CRM\n\n1. Откройте нужный лид, сделку, КП, счёт или элемент смарт-процесса внутри портала.\n2. Запустите действие приложения «Сформировать документ».\n3. Проверьте выбранную сущность и подходящий шаблон.\n4. Запустите формирование и дождитесь результата.\n5. Скачайте новый файл из интерфейса или раздела «Генерации»; при включённом прикреплении его можно найти и в таймлайне карточки. Откройте файл.\n6. Сверьте название карточки, клиента, реквизиты, даты, товары, суммы и задачи с CRM.\n\nПри ошибке найдите попытку в разделе «Генерации» и прочитайте сообщение. Исправьте шаблон или исходные данные, затем выполните новый запуск: повторная генерация создаёт новый результат.\n\n### Контроль перед использованием\n\n- В документе не осталось `{{ ... }}`, `{% ... %}` и других служебных выражений.\n- Контрагент и своя организация не перепутаны.\n- Длинные названия, кириллица, кавычки и переносы строк читаются корректно.\n- Таблица проверена без элементов, с одним элементом и с несколькими.\n- Суммы, скидки, налоги и нулевые значения соответствуют исходным данным.\n- Даты и время показаны в нужном формате.\n- Связанные задачи проверены с трудозатратами и без них.\n- В Excel нет обрезанного текста, повреждённых формул и неожиданных разрывов области печати.\n\n## Если результат отличается от ожидаемого\n\n| Ситуация | Что проверить |\n| --- | --- |\n| Поле пустое | Код и регистр выражения, наличие значения, связь с клиентом, выбранную сущность и доступность данных |\n| Пользовательское поле не найдено | Актуальный каталог вашего портала; номер поля в другом портале не подходит |\n| Таблица не повторяется | Отдельные строки начала и конца, имя списка, одинаковое имя `item` внутри цикла |\n| Нет задач | Связь задач с текущей карточкой CRM |\n| Нет затраченного времени | Зарегистрированные трудозатраты; плановая оценка не равна затраченному времени |\n| Ошибка `duration` | Формат `seconds` или `HH:mm:ss` и целые неотрицательные секунды на входе |\n| Не копируется пример | Выделите текст и скопируйте вручную: браузер может ограничить доступ к буферу |\n| Шаблон подходит сделке, но не лиду | Прямые пути вроде `deal.title`, выбор сущностей и использование подходящих алиасов |\n| Файл создан, но оформление нарушено | Макет в Word или Excel, высоту строк, объединённые ячейки, длинный текст и печать |\n\n## Ограничения и дополнительные возможности\n\nОсновные форматы шаблонов и результатов — DOCX и XLSX. Возможность «Сформировать PDF» зависит от настроенного преобразования в среде приложения. Проверяйте PDF отдельно; доступность флажка не заменяет проверку готового файла.\n\nИзображения, QR- и штрихкоды требуют специально подготовленных данных. Произвольная ссылка в текстовом поле не гарантирует вставку изображения. Для первого шаблона используйте готовые основы, а сложные элементы добавляйте после успешной проверки обычных полей и таблиц.\n\nКаталог не означает, что каждое поле заполнено в каждой карточке. Нет универсального шаблона, который без адаптации охватит любые пользовательские поля, все смарт-процессы и все варианты реквизитов. Подготовьте контрольный пример для каждого рабочего сценария.\n\n## Что в итоге должно быть у пользователя\n\nРабочий файл-шаблон, понятное назначение и список совместимых сущностей, проверенный документ из реальной карточки и сохранённый образец для дальнейшего сравнения. После этого можно использовать шаблон в повторяющихся операциях, проверяя важные данные перед отправкой документа.\n","\u003Cp>Это руководство ведёт от установки и первого DOCX до товаров, реквизитов, пользовательских полей, лидов, сделок, КП, счетов, смарт-процессов, связанных задач, условий, дат, длительности и модификаторов.\u003C\u002Fp>\n\u003Ch2>Перед установкой\u003C\u002Fh2>\n\u003Cp>Поручите установку администратору вашего Битрикс24 или специалисту, которому разрешено устанавливать приложения и настраивать CRM.\u003C\u002Fp>\n\u003Cp>Для первой проверки подготовьте:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Карточку CRM с контрольными данными и доступом к ней.\u003C\u002Fli>\n\u003Cli>Небольшой шаблон DOCX или XLSX либо готовность воспользоваться библиотекой пресетов.\u003C\u002Fli>\n\u003Cli>Word или Excel для проверки соответствующего файла после формирования.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Открывайте приложение внутри своего портала Битрикс24. Прямое открытие страницы приложения вне портала не заменяет установку и подключение к CRM.\u003C\u002Fp>\n\u003Ch2>Установка\u003C\u002Fh2>\n\u003Cp>Эти шаги применяются, когда карточка «Генератор документов» доступна для установки в вашем Битрикс24. Если приложение не находится в Маркете, уточните у разработчика его доступность и ссылку для вашего портала.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Войдите в нужный портал Битрикс24 под учётной записью, которой разрешена установка приложений.\u003C\u002Fli>\n\u003Cli>Откройте в Маркете карточку «Генератор документов».\u003C\u002Fli>\n\u003Cli>Ознакомьтесь с условиями и запрошенными разрешениями в карточке.\u003C\u002Fli>\n\u003Cli>Запустите установку доступным в карточке действием.\u003C\u002Fli>\n\u003Cli>Дождитесь завершения экрана «Установка приложения». Во время работы на нём отображаются этапы подготовки и завершения установки.\u003C\u002Fli>\n\u003Cli>Убедитесь, что появилось сообщение «Установка завершена».\u003C\u002Fli>\n\u003Cli>Откройте установленное приложение внутри этого же портала.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Cimg src=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Finstall-01-guide.webp\" alt=\"Раздел со встроенной справкой и копируемыми примерами\">\u003C\u002Fp>\n\u003Cp>Сообщение «Не удалось завершить установку» означает, что установка не завершена. Не принимайте открывшуюся страницу или частично заполненную полосу прогресса за успешный результат.\u003C\u002Fp>\n\u003Ch2>Разрешения и доступ\u003C\u002Fh2>\n\u003Cp>Для подготовки документа приложению нужны данные той CRM-карточки, которую вы выбираете. Если используются связанные компания, контакт, реквизиты или задачи, соответствующие сведения должны быть заполнены и доступны. Для прикрепления результата требуется возможность работы с файлами в портале.\u003C\u002Fp>\n\u003Cp>Проверяйте точный перечень запрашиваемых разрешений в окне установки. Если нужные сведения не загружаются, обратитесь к администратору или разработчику; не пытайтесь исправить это созданием собственных ключей или передачей паролей.\u003C\u002Fp>\n\u003Cp>Установка приложения не является подтверждением того, что каждому сотруднику доступны все карточки и поля. Перед рабочим использованием проверьте выбранный сценарий под учётной записью будущего пользователя.\u003C\u002Fp>\n\u003Ch2>Первая настройка\u003C\u002Fh2>\n\u003Ch3>Подключите действие в нужных карточках CRM\u003C\u002Fh3>\n\u003Col>\n\u003Cli>В меню приложения откройте раздел «Bitrix24».\u003C\u002Fli>\n\u003Cli>Найдите блок «Встройки в карточках CRM».\u003C\u002Fli>\n\u003Cli>Нажмите «Открыть настройки встроек».\u003C\u002Fli>\n\u003Cli>На странице «Встройки CRM» отметьте нужные стандартные сущности.\u003C\u002Fli>\n\u003Cli>В блоке «Смарт-процессы» отметьте нужные процессы, если они есть в списке.\u003C\u002Fli>\n\u003Cli>Нажмите «Сохранить и зарегистрировать».\u003C\u002Fli>\n\u003Cli>Дождитесь сообщения «Сохранено» с количеством зарегистрированных встроек.\u003C\u002Fli>\n\u003Cli>Откройте контрольную карточку выбранной сущности и проверьте наличие действия «Сформировать документ» в верхней панели.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>В списке могут быть лиды, сделки, счета, предложения и доступные смарт-процессы. Выбирайте только необходимые места запуска. Не считайте, что действие включено во всех карточках сразу после установки: проверьте сохранённые настройки.\u003C\u002Fp>\n\u003Cp>Если нужный смарт-процесс добавлен позднее, нажмите «Обновить список смартов», выберите его и снова сохраните настройки. Сообщение об отсутствии дополнительных смарт-процессов само по себе не означает ошибку установки приложения.\u003C\u002Fp>\n\u003Ch3>Подготовьте один контрольный шаблон\u003C\u002Fh3>\n\u003Col>\n\u003Cli>Откройте «Шаблоны» → «Мастер шаблона».\u003C\u002Fli>\n\u003Cli>Выберите источник данных для каталога переменных: сделку, лид, компанию, контакт или ручной JSON. Этот выбор помогает получить подсказки, но сам по себе не задаёт совместимость создаваемого шаблона.\u003C\u002Fli>\n\u003Cli>Выберите базовый пресет. Формат и совместимые сущности будущего шаблона наследуются от выбранного пресета — проверьте их до создания.\u003C\u002Fli>\n\u003Cli>Просмотрите «Переменные и примеры» и при необходимости обновите каталог.\u003C\u002Fli>\n\u003Cli>Укажите название и уникальный код шаблона.\u003C\u002Fli>\n\u003Cli>Нажмите «Создать из пресета».\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Если используете собственный файл, выберите «Шаблоны» → «Новый шаблон», заполните название, код, тип и файл, отметьте совместимые сущности и нажмите «Загрузить шаблон».\u003C\u002Fp>\n\u003Cp>Подробные правила подготовки DOCX, XLSX, полей и таблиц находятся в разделе «Примеры и инструкция». Наличие шаблона обязательно для контрольной генерации, но сложный рабочий макет не нужен для проверки самой установки.\u003C\u002Fp>\n\u003Ch2>Проверка установки\u003C\u002Fh2>\n\u003Cp>Проверьте не только сообщение о завершении, но и весь первый сценарий:\u003C\u002Fp>\n\u003Col>\n\u003Cli>Откройте главную страницу приложения внутри портала и убедитесь, что интерфейс загрузился.\u003C\u002Fli>\n\u003Cli>Откройте «Шаблоны» и найдите созданный контрольный шаблон.\u003C\u002Fli>\n\u003Cli>Проверьте каталог полей для его CRM-сущности.\u003C\u002Fli>\n\u003Cli>Откройте соответствующую контрольную карточку CRM.\u003C\u002Fli>\n\u003Cli>Нажмите «Сформировать документ» и выберите совместимый шаблон.\u003C\u002Fli>\n\u003Cli>Дождитесь формирования. Скачайте файл из интерфейса или раздела «Генерации»; при включённом прикреплении он также появится в таймлайне карточки.\u003C\u002Fli>\n\u003Cli>Откройте файл в Word или Excel.\u003C\u002Fli>\n\u003Cli>Сверьте несколько известных значений с карточкой и убедитесь, что служебные выражения заменились данными.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Успешный результат: приложение открывается в портале, нужное действие доступно в карточке, шаблон выбирается, новый документ создаётся и его данные соответствуют контрольному примеру.\u003C\u002Fp>\n\u003Cp>Начните с DOCX или XLSX. PDF — отдельная возможность, зависящая от настроенного преобразования, и её проверяют после успешного основного сценария.\u003C\u002Fp>\n\u003Ch2>Частые проблемы первой настройки\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Ситуация\u003C\u002Fth>\n\u003Cth>Безопасное действие\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Приложение не находится в Маркете\u003C\u002Ftd>\n\u003Ctd>Уточните у разработчика доступность и правильную карточку для вашего портала\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>«Не удалось завершить установку»\u003C\u002Ftd>\n\u003Ctd>Сохраните текст ошибки и сообщите администратору или разработчику, на каком этапе она возникла\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Приложение открыто отдельно от портала\u003C\u002Ftd>\n\u003Ctd>Вернитесь в Битрикс24 и откройте установленное приложение оттуда\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Нет действия «Сформировать документ»\u003C\u002Ftd>\n\u003Ctd>Проверьте выбранные сущности во «Встройках CRM» и результат «Сохранить и зарегистрировать»\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Не виден нужный смарт-процесс\u003C\u002Ftd>\n\u003Ctd>Нажмите «Обновить список смартов» и проверьте наличие процесса в самом портале\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Нет совместимого шаблона\u003C\u002Ftd>\n\u003Ctd>Создайте или загрузите шаблон для выбранного типа карточки\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Каталог полей пустой или не загрузился\u003C\u002Ftd>\n\u003Ctd>Убедитесь, что приложение открыто внутри портала; повторите обновление каталога и прочитайте сообщение об ошибке\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Реквизиты или контакт в документе пустые\u003C\u002Ftd>\n\u003Ctd>Проверьте связи и заполнение данных в контрольной карточке; это не обязательно ошибка установки\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Документ не сформирован\u003C\u002Ftd>\n\u003Ctd>Найдите попытку в разделе «Генерации», прочитайте сообщение и исправьте указанные данные или шаблон\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>При обращении за помощью достаточно указать действие, время ошибки и её текст. Не отправляйте пароли, коды доступа или документы с конфиденциальными данными без необходимости.\u003C\u002Fp>\n\u003Ch2>Перед удалением или повторной установкой\u003C\u002Fh2>\n\u003Cp>Не используйте удаление приложения как первый способ исправления ошибки. Сначала сохраните исходные шаблоны и необходимые сформированные документы, затем уточните у разработчика порядок повторной установки и сохранность данных.\u003C\u002Fp>\n\u003Ch2>Что уточнить перед установкой\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Доступность карточки приложения для вашего портала, если её ещё нельзя установить из Маркета.\u003C\u002Fli>\n\u003Cli>Требования к тарифу и редакции вашего Битрикс24.\u003C\u002Fli>\n\u003Cli>Окончательный перечень разрешений в доступной для установки версии.\u003C\u002Fli>\n\u003Cli>Сохранение шаблонов, настроек и истории при удалении или повторной установке.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Поддержку коробочной редакции, мобильного приложения и формирование PDF при необходимости согласуйте отдельно до использования этих сценариев.\u003C\u002Fp>\n\u003Ch2>Подробная работа с шаблонами\u003C\u002Fh2>\n\u003Ch2>Для чего нужно приложение\u003C\u002Fh2>\n\u003Cp>Приложение подставляет данные CRM Битрикс24 в подготовленные файлы DOCX и XLSX. Вы один раз оформляете документ в Word или Excel, обозначаете изменяемые поля и таблицы, загружаете шаблон, а затем создаёте документы по карточкам CRM.\u003C\u002Fp>\n\u003Cp>Это полезно менеджерам по продажам, сотрудникам, которые готовят коммерческие предложения и спецификации, и специалистам, которым нужны документы с перечнем связанных задач и зарегистрированными трудозатратами.\u003C\u002Fp>\n\u003Cp>Основной результат — файл с данными выбранной карточки. Его можно скачать из интерфейса или раздела «Генерации»; при включённом прикреплении файл также появляется в таймлайне CRM-карточки. Перед отправкой клиенту документ необходимо открыть и проверить.\u003C\u002Fp>\n\u003Ch2>Что можно подготовить\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Коммерческое предложение с данными клиента и таблицей товаров.\u003C\u002Fli>\n\u003Cli>Спецификацию с количеством, ценами, суммами и итогами.\u003C\u002Fli>\n\u003Cli>Документ на основе своего бланка с полями CRM и реквизитами.\u003C\u002Fli>\n\u003Cli>Отчёт по связанным задачам: название, дата создания и зарегистрированное время.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Генерация предусмотрена для лидов, сделок, предложений (КП), счетов и смарт-процессов. Список доступных сущностей и поля определяются в вашем портале. Выбирайте только те сущности, под которые подготовлен шаблон.\u003C\u002Fp>\n\u003Cp>Приложение не подменяет проверку содержания договора, бухгалтерского или юридически значимого документа. Текст, расчёты и реквизиты, которые вы используете в своей работе, необходимо согласовать самостоятельно.\u003C\u002Fp>\n\u003Ch2>Перед первым документом\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Откройте установленное приложение внутри Битрикс24.\u003C\u002Fli>\n\u003Cli>Подготовьте контрольную карточку CRM с понятными вам значениями: названием, клиентом, товарами и необходимыми пользовательскими полями.\u003C\u002Fli>\n\u003Cli>Если документ должен содержать реквизиты, заполните их у связанной компании или контакта. Для банковских данных нужны заполненные банковские реквизиты.\u003C\u002Fli>\n\u003Cli>Для редактирования макета используйте Word для DOCX или Excel для XLSX. Готовый результат также проверяйте в подходящем офисном редакторе.\u003C\u002Fli>\n\u003Cli>Откройте раздел «Примеры и инструкция». В нём есть поиск, копирование выражений, примеры для обоих форматов и описание ограничений.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Все организации, имена, суммы и банковские значения ниже — учебные. Их нельзя использовать вместо реквизитов реального клиента.\u003C\u002Fp>\n\u003Ch2>Быстрый старт через мастер\u003C\u002Fh2>\n\u003Cp>В разделе «Шаблоны» нажмите «Мастер шаблона».\u003C\u002Fp>\n\u003Col>\n\u003Cli>\u003Cstrong>Сценарий документа.\u003C\u002Fstrong> Выберите понятный вам вариант, чтобы сориентироваться в мастере.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Источник данных.\u003C\u002Fstrong> Выберите источник для каталога переменных: сделку, лид, компанию, контакт или ручной JSON. Он определяет подсказки на этом шаге, но не привязывает созданный шаблон к сущности.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Базовый пресет.\u003C\u002Fstrong> Выберите готовую основу и прочитайте её описание. Именно пресет задаёт формат и совместимые сущности создаваемого шаблона.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Переменные и примеры.\u003C\u002Fstrong> Просмотрите каталог полей. При необходимости нажмите «Обновить каталог», найдите нужное поле и скопируйте выражение. До загрузки каталога портал может показывать только переменные базового пресета — это не полный перечень ваших полей.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Создание шаблона.\u003C\u002Fstrong> Укажите понятное название и уникальный код, затем нажмите «Создать из пресета».\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Мастер создаёт шаблон на основе выбранного пресета. Он не является редактором произвольной вёрстки документа. Чтобы изменить структуру, шапку или таблицы, нажмите «Скачать пример», отредактируйте файл в Word или Excel и загрузите свой вариант.\u003C\u002Fp>\n\u003Cp>Готовые основы также доступны в разделе «Библиотека пресетов». Если уже есть собственный бланк, можно сразу перейти к загрузке.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fdescription-02-wizard.webp\" alt=\"Мастер шаблона: формат DOCX, источник «Сделка» и каталог товаров\">\u003C\u002Fp>\n\u003Ch2>Как загрузить свой шаблон\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Сохраните рабочий бланк как \u003Ccode>.docx\u003C\u002Fcode> или \u003Ccode>.xlsx\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Замените изменяемый текст выражениями полей. Обычные подписи, заголовки и оформление оставьте в файле.\u003C\u002Fli>\n\u003Cli>В приложении откройте «Шаблоны» → «Новый шаблон».\u003C\u002Fli>\n\u003Cli>Укажите «Название», «Код», «Тип» и «Файл». Для кода удобно использовать понятное обозначение, например \u003Ccode>offer_equipment_v1\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>В блоке «Сущности шаблона» отметьте нужные карточки CRM и смарт-процессы.\u003C\u002Fli>\n\u003Cli>Нажмите «Открыть поля», чтобы получить актуальные выражения для выбранных сущностей. Если изменили файл после выбора, перед загрузкой выберите его актуальную версию.\u003C\u002Fli>\n\u003Cli>Нажмите «Загрузить шаблон» и проверьте результат анализа переменных.\u003C\u002Fli>\n\u003Cli>Устраните ошибки выражений до использования шаблона в работе.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Не переносите номер пользовательского поля или смарт-процесса из чужого примера: на вашем портале он может отличаться. Каталог — основной источник точных кодов.\u003C\u002Fp>\n\u003Cp>В карточке шаблона можно скачать исходный файл, открыть редактирование и выполнить тестовую генерацию. Изменение шаблона применяется к новым документам; ранее сформированные файлы не переписываются.\u003C\u002Fp>\n\u003Ch2>Скачать учебные шаблоны\u003C\u002Fh2>\n\u003Cp>Файлы собраны как понятные основы для обучения. Они прошли анализ синтаксиса и контрольную подстановку на реализации зафиксированной ревизии. Это не юридически готовые документы: перед работой проверьте текст, реквизиты, суммы, НДС, печатную область и оформление.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.docx\">Краткое КП по сделке — DOCX\u003C\u002Fa> — данные сделки и клиента, товары, рублёвые суммы и итоги.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Fcommercial-offer-deal.xlsx\">Краткое КП по сделке — XLSX\u003C\u002Fa> — тот же учебный сценарий в Excel с повторяющейся строкой \u003Ccode>{{#products}}\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.docx\">Отчёт по связанным задачам — DOCX\u003C\u002Fa> — дата, название, секунды и длительность \u003Ccode>HH:mm:ss\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Frelated-tasks-report.xlsx\">Отчёт по связанным задачам — XLSX\u003C\u002Fa> — отдельная строка на задачу; отсутствующее время выводится как \u003Ccode>00:00:00\u003C\u002Fcode> через \u003Ccode>duration | default\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Как вставлять поля\u003C\u002Fh2>\n\u003Cp>В основном синтаксисе путь к полю заключают в двойные фигурные скобки:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Коммерческое предложение\nПо сделке: {{ deal.title }}\nКонтрагент: {{ company.name }}\nИНН: {{ company.inn }}\nКонтактное лицо: {{ contact.formatted_name }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>При генерации выражения заменятся значениями. Например, \u003Ccode>{{ deal.title }}\u003C\u002Fcode> превратится в «Поставка оборудования».\u003C\u002Fp>\n\u003Ch3>Как выбрать сущность\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Данные\u003C\u002Fth>\n\u003Cth>Корень выражения\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Сделка\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>deal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Лид\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>lead\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Предложение (КП)\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>quote\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Счёт\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>invoice\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Компания\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>company\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Контакт\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>contact\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Смарт-процесс\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>dynamic_NNN\u003C\u002Fcode>, где номер берётся из вашего каталога\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Приложение также поддерживает алиасы в одинарных скобках. Например, \u003Ccode>{Title}\u003C\u002Fcode> используется для названия текущей сущности.\u003C\u002Fp>\n\u003Cp>Отметка нескольких сущностей в настройках не превращает \u003Ccode>deal.title\u003C\u002Fcode> в название лида или счёта. Для общего шаблона выбирайте подходящие алиасы из каталога и проверяйте результат отдельно для каждого типа карточки.\u003C\u002Fp>\n\u003Cp>Не меняйте регистр символов в скопированном коде поля. Человекочитаемое название поля в CRM и выражение для документа — не всегда одно и то же.\u003C\u002Fp>\n\u003Ch3>Какие данные доступны в разных сценариях\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Сделка: \u003Ccode>deal\u003C\u002Fcode>, связанная компания и контакт, ответственный, \u003Ccode>products\u003C\u002Fcode>, \u003Ccode>totals\u003C\u002Fcode>, \u003Ccode>tasks\u003C\u002Fcode>, \u003Ccode>my_company\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Лид: \u003Ccode>lead\u003C\u002Fcode>, связанная компания и контакт, ответственный, \u003Ccode>products\u003C\u002Fcode>, \u003Ccode>totals\u003C\u002Fcode>, \u003Ccode>tasks\u003C\u002Fcode>, \u003Ccode>my_company\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Счёт: \u003Ccode>invoice\u003C\u002Fcode>, связанная компания и контакт, ответственный, \u003Ccode>products\u003C\u002Fcode>, \u003Ccode>totals\u003C\u002Fcode>, \u003Ccode>tasks\u003C\u002Fcode>, \u003Ccode>my_company\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Предложение или КП: \u003Ccode>quote\u003C\u002Fcode>, связанная компания и контакт, ответственный, \u003Ccode>products\u003C\u002Fcode>, \u003Ccode>totals\u003C\u002Fcode>, \u003Ccode>my_company\u003C\u002Fcode>. Список \u003Ccode>tasks\u003C\u002Fcode> для \u003Ccode>quote\u003C\u002Fcode> в проверенной реализации не загружается.\u003C\u002Fli>\n\u003Cli>Смарт-процесс: \u003Ccode>dynamic_NNN\u003C\u002Fcode>, связанная компания и контакт, ответственный, \u003Ccode>products\u003C\u002Fcode>, \u003Ccode>totals\u003C\u002Fcode>, \u003Ccode>tasks\u003C\u002Fcode>, \u003Ccode>my_company\u003C\u002Fcode> — в пределах данных и связей конкретного элемента.\u003C\u002Fli>\n\u003Cli>Компания и контакт могут использоваться как текущая сущность; товарный список для них пуст.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>На контрольном портале смарт-процесс «Всё включено» имел корень \u003Ccode>dynamic_1038\u003C\u002Fcode>, поэтому выражение названия выглядело так:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{{ dynamic_1038.title }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>1038\u003C\u002Fcode> — реальный пример из контрольного каталога, а не универсальный номер. Для другого портала скопируйте собственный \u003Ccode>dynamic_NNN\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch3>Реальные коды пользовательских полей из контрольного каталога\u003C\u002Fh3>\n\u003Cp>В проверенной сделке использовались:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>текст — \u003Ccode>UF_CRM_1787148491040\u003C\u002Fcode>;\u003C\u002Fli>\n\u003Cli>дата и время — \u003Ccode>UF_CRM_1787148514204\u003C\u002Fcode>;\u003C\u002Fli>\n\u003Cli>список — \u003Ccode>UF_CRM_1787148581370\u003C\u002Fcode>;\u003C\u002Fli>\n\u003Cli>число — \u003Ccode>UF_CRM_1787148609337\u003C\u002Fcode>;\u003C\u002Fli>\n\u003Cli>флаг — \u003Ccode>UF_CRM_1787148631471\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Копируемые примеры для текущей сущности:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{UF_CRM_1787148491040}\n{UF_CRM_1787148514204~d.m.Y H:i}\n{UF_CRM_1787148581370}\n{UF_CRM_1787148609337}\n{UF_CRM_1787148631471}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Для сделки те же данные проверялись через прямые пути:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{{ deal.uf_crm_1787148491040 }}\n{{ deal.uf_crm_1787148514204 }}\n{{ deal.uf_crm_1787148581370 }}\n{{ deal.uf_crm_1787148609337 }}\n{{ deal.uf_crm_1787148631471 }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>В каталоге конкретного портала написание пути может отличаться. Не собирайте выражение из номера вручную: откройте поля выбранной сущности и скопируйте готовый код.\u003C\u002Fp>\n\u003Ch3>Контрагент, контакт и банковские реквизиты\u003C\u002Fh3>\n\u003Cp>Пример блока клиента:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Покупатель: {{ company.name }}\nИНН: {{ company.inn }}\nКонтакт: {{ contact.formatted_name }}\nБанк: {{ company.bank_detail.bank_name }}\nРасчётный счёт: {{ company.bank_detail.account_number }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Если блок пустой, проверьте связь карточки с клиентом, заполнение соответствующих реквизитов и доступность данных. Форматирование не может получить отсутствующие сведения.\u003C\u002Fp>\n\u003Cp>Для продавца используйте поля раздела «Моя компания» в каталоге. Не подставляйте реквизиты клиента на место реквизитов собственной организации.\u003C\u002Fp>\n\u003Ch2>Таблица товаров в Word\u003C\u002Fh2>\n\u003Cp>Создайте настоящую таблицу Word. В ней нужны строка заголовков, отдельная служебная строка начала цикла, строка данных и отдельная служебная строка конца цикла.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Строка\u003C\u002Fth>\n\u003Cth>Содержимое\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Заголовок\u003C\u002Ftd>\n\u003Ctd>№, Наименование, Количество, Сумма — в отдельных ячейках\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Начало цикла\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{%tr for item in products %}\u003C\u002Fcode> в первой ячейке\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Данные\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ loop.index }}\u003C\u002Fcode>, \u003Ccode>{{ item.name }}\u003C\u002Fcode>, \u003Ccode>{{ item.qty }}\u003C\u002Fcode>, \u003Ccode>{{ item.sum | money }}\u003C\u002Fcode> — по соответствующим ячейкам\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Конец цикла\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{%tr endfor %}\u003C\u002Fcode> в первой ячейке\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>При генерации служебные строки удаляются, а строка данных повторяется для каждого товара. Заголовок остаётся один. Если товаров нет, строк данных не будет.\u003C\u002Fp>\n\u003Cp>Под таблицей можно добавить сумму прописью:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">Итого прописью: {{ totals.sum_with_vat | money_words }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Для цены, скидки и налога выбирайте нужные поля каталога и сверяйте результат с карточкой. Не заменяйте итог произвольным выражением, если не проверили его смысл для ваших цен и налогов.\u003C\u002Fp>\n\u003Ch2>Таблица товаров в Excel\u003C\u002Fh2>\n\u003Cp>В XLSX границы цикла и строка данных также должны занимать отдельные строки листа.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Ячейка\u003C\u002Fth>\n\u003Cth>Содержимое\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>A1–D1\u003C\u002Ftd>\n\u003Ctd>Заголовки: Наименование, Количество, Цена, Сумма\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A2\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{#products}}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A3\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.name }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>B3\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.qty }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>C3\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.price | money_no_currency }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>D3\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.sum | money }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A4\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{\u002Fproducts}}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Строка 3 повторится по числу товаров, служебные строки будут удалены, а расположенные ниже строки сдвинутся. Оформление заголовков и строки данных задайте до загрузки.\u003C\u002Fp>\n\u003Cp>Не объединяйте ячейки через границы цикла или условного блока. Отдельно проверяйте формулы, высоту строк, перенос длинных названий и область печати. Денежные фильтры создают оформленное представление суммы; не рассчитывайте на него как на универсальную числовую ячейку для дальнейших вычислений.\u003C\u002Fp>\n\u003Ch2>Связанные задачи: дата, название и время\u003C\u002Fh2>\n\u003Cp>Задача должна быть связана с той CRM-сущностью, по которой создаётся документ. Табличный список таких задач доступен как \u003Ccode>tasks\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Для Word создайте таблицу с тремя столбцами: «Дата создания», «Задача», «Затраченное время». Разместите начало и конец цикла в отдельных служебных строках:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{%tr for item in tasks %}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>В трёх ячейках строки данных разместите соответственно:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{{ item.created_date | date }}\n{{ item.title }}\n{{ item.time_spent_in_logs | duration("HH:mm:ss") }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>В строке завершения:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{%tr endfor %}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Для Excel используйте ту же строку данных, но отдельные строки начала и завершения замените на \u003Ccode>{{#tasks}}\u003C\u002Fcode> и \u003Ccode>{{\u002Ftasks}}\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>\u003Ccode>time_spent_in_logs\u003C\u002Fcode> — зарегистрированные трудозатраты в секундах. Это не плановая длительность и не время, прошедшее с момента создания задачи. Если трудозатраты не зарегистрированы, значение может отсутствовать.\u003C\u002Fp>\n\u003Ch3>Как выбрать формат времени\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Выражение\u003C\u002Fth>\n\u003Cth>Результат для 9300 секунд\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>{{ item.time_spent_in_logs | duration("seconds") }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>9300\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>{{ item.time_spent_in_logs | duration("HH:mm:ss") }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>02:35:00\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>{{ item.time_spent_in_logs | duration }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>02:35:00\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Это длительность, а не время суток: 90061 секунда выводится как \u003Ccode>25:01:01\u003C\u002Fcode>. Часы не сбрасываются после суток.\u003C\u002Fp>\n\u003Cp>Ноль даёт \u003Ccode>0\u003C\u002Fcode> или \u003Ccode>00:00:00\u003C\u002Fcode>. Отсутствующее значение остаётся пустым. Чтобы явно показывать ноль вместо пустоты, используйте именно такой порядок фильтров:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{{ item.time_spent_in_logs | duration | default("00:00:00") }}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Поддерживаются только форматы \u003Ccode>seconds\u003C\u002Fcode> и \u003Ccode>HH:mm:ss\u003C\u002Fcode>. На входе нужны целые неотрицательные секунды. Строки «2 часа» или «02:35:00», отрицательные и дробные секунды не подходят.\u003C\u002Fp>\n\u003Cp>В отдельной ячейке XLSX \u003Ccode>duration("seconds")\u003C\u002Fcode> сохраняет числовой тип для полученных секунд. Запасное значение \u003Ccode>default("0")\u003C\u002Fcode> будет текстом. Прежде чем применять новый формат в рабочем шаблоне, сформируйте контрольный файл на своём портале и проверьте задачу с трудозатратами и задачу без них.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"\u002Fcontent-media\u002Fapps\u002Fdocument-templates\u002Fassets\u002Finstall-02-duration.webp\" alt=\"Копируемые примеры duration: секунды и HH:mm:ss\">\u003C\u002Fp>\n\u003Ch2>Фильтры: как оформить значение\u003C\u002Fh2>\n\u003Cp>Фильтр пишется после поля через \u003Ccode>|\u003C\u002Fcode>. Строковые параметры заключаются в обычные прямые кавычки. Несколько фильтров выполняются слева направо.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Фильтр\u003C\u002Fth>\n\u003Cth>Пример\u003C\u002Fth>\n\u003Cth>Что получится\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>money\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ deal.opportunity | money }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>1 250,50 ₽\u003C\u002Fcode> для 1250.5\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>money_no_currency\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ deal.opportunity | money_no_currency }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>1 250,50\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>money_words\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ totals.sum_with_vat | money_words }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Сумма прописью в рублях и копейках\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>date\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.created_date | date("dd.MM.yyyy HH:mm") }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Например, \u003Ccode>14.09.2026 14:53\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>duration\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.time_spent_in_logs | duration("HH:mm:ss") }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Длительность, например \u003Ccode>02:35:00\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>phone\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ contact.phone | phone }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Например, \u003Ccode>+7 (999) 123-45-67\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>percent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ item.tax_rate | percent }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>12,50 %\u003C\u002Fcode> для 12.5\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>default\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ contact.email | default("не указан") }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Запасной текст для пустого значения\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>upper\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ company.name | upper }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Верхний регистр\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lower\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ company.name | lower }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Нижний регистр\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>truncate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{{ deal.title | truncate(12) }}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Ограничение длины с многоточием\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Денежные фильтры используют рубли и не выбирают символ по валюте CRM. \u003Ccode>percent\u003C\u002Fcode> не умножает число на 100: значение 0.125 не станет автоматически 12.5%.\u003C\u002Fp>\n\u003Cp>В маске даты \u003Ccode>MM\u003C\u002Fcode> означает месяц, а \u003Ccode>mm\u003C\u002Fcode> — минуты. Форматирование существующей даты не является переводом в другой часовой пояс. Для телефонов вне показанного российского формата результат может остаться без изменения.\u003C\u002Fp>\n\u003Cp>Пустое значение и отсутствующее поле могут обрабатываться по-разному. Проверяйте \u003Ccode>default\u003C\u002Fcode> на своих данных. Для отсутствующих трудозатрат используйте приведённую выше цепочку \u003Ccode>duration | default\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>Модификаторы через тильду\u003C\u002Fh2>\n\u003Cp>Помимо фильтров, приложение поддерживает ряд выражений в одинарных скобках с модификатором после \u003Ccode>~\u003C\u002Fcode>. Это отдельный синтаксис: не заменяйте в нём маски даты или параметры вариантами из фильтров.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Задача\u003C\u002Fth>\n\u003Cth>Выражение\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Дата\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{item.created_date~d.m.Y}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Фамилия и инициалы\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{ContactFormattedName~Format=#LAST_NAME# #NAME_SHORT# #SECOND_NAME_SHORT#}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>ФИО в дательном падеже\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#,Case=1}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Телефон без пробелов\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{contact.phone~format=E.164}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Адрес одной строкой\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{company.legal_address~Format=5,Separator=1}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Верхний регистр\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{company.name~letterCase=upper}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Сумма в рублях\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{Opportunity~money=y}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Запасной текст\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{contact.email~default=не указан}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Ограничение длины\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{Title~truncate=12}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Для ФИО доступны \u003Ccode>#LAST_NAME#\u003C\u002Fcode>, \u003Ccode>#NAME#\u003C\u002Fcode>, \u003Ccode>#SECOND_NAME#\u003C\u002Fcode>, \u003Ccode>#NAME_SHORT#\u003C\u002Fcode>, \u003Ccode>#SECOND_NAME_SHORT#\u003C\u002Fcode>. Значения \u003Ccode>Case\u003C\u002Fcode>: \u003Ccode>-1\u003C\u002Fcode> — именительный, \u003Ccode>0\u003C\u002Fcode> — родительный, \u003Ccode>1\u003C\u002Fcode> — дательный, \u003Ccode>2\u003C\u002Fcode> — винительный, \u003Ccode>3\u003C\u002Fcode> — творительный, \u003Ccode>4\u003C\u002Fcode> — предложный. Склонение конкретного имени проверяйте вручную.\u003C\u002Fp>\n\u003Cp>Для множественного значения \u003Ccode>index=0\u003C\u002Fcode> или \u003Ccode>mfirst=y\u003C\u002Fcode> выбирает первый элемент, а \u003Ccode>all=y\u003C\u002Fcode> объединяет значения. Это применимо, когда поле действительно передано списком. Сначала скопируйте свой путь из каталога, затем добавьте модификатор — не выдумывайте код множественного поля.\u003C\u002Fp>\n\u003Cp>\u003Ccode>duration\u003C\u002Fcode> используется только как фильтр через \u003Ccode>|\u003C\u002Fcode> в двойных скобках. Полная совместимость со всеми конструкциями стандартного генератора Битрикс24 не предполагается.\u003C\u002Fp>\n\u003Ch2>Условия и незаполненные поля\u003C\u002Fh2>\n\u003Cp>Чтобы вывести КПП только при наличии, используйте условие:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{% if company.has_kpp %}КПП: {{ company.kpp }}{% endif %}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Для целых абзацев Word начало \u003Ccode>{%p if company.has_kpp %}\u003C\u002Fcode> и завершение \u003Ccode>{%p endif %}\u003C\u002Fcode> должны находиться в отдельных абзацах, между которыми расположен нужный текст. Перенос строки внутри одного абзаца не заменяет отдельный абзац.\u003C\u002Fp>\n\u003Cp>В Excel для условного удаления строки разместите три строки:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">{{#if company.has_kpp}}\nКПП: {{ company.kpp }}\n{{\u002Fif}}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Условный блок XLSX проверяет заполненность или истинность указанного пути. Произвольные сравнения и \u003Ccode>else\u003C\u002Fcode> для такого блока не поддерживаются. Используйте готовые логические поля из каталога.\u003C\u002Fp>\n\u003Cp>Отсутствующие реквизиты не стоит заменять вымышленными значениями. Лучше убрать соответствующий блок условием или исправить данные клиента.\u003C\u002Fp>\n\u003Ch2>Как проверить шаблон и получить документ\u003C\u002Fh2>\n\u003Ch3>Тестовая генерация\u003C\u002Fh3>\n\u003Cp>В карточке шаблона откройте «Тестовая генерация». Эта проверка использует заданные тестовые данные в формате JSON. Нажмите «Проверить JSON», затем «Сформировать документ», скачайте результат и откройте его.\u003C\u002Fp>\n\u003Cp>Тест показывает, как шаблон обрабатывает переданные данные. Он не подтверждает, что такие же поля заполнены в реальной карточке CRM. Если вы не работаете с JSON, начните с готового примера и обязательно выполните следующий шаг — создание из контрольной карточки.\u003C\u002Fp>\n\u003Ch3>Создание из CRM\u003C\u002Fh3>\n\u003Col>\n\u003Cli>Откройте нужный лид, сделку, КП, счёт или элемент смарт-процесса внутри портала.\u003C\u002Fli>\n\u003Cli>Запустите действие приложения «Сформировать документ».\u003C\u002Fli>\n\u003Cli>Проверьте выбранную сущность и подходящий шаблон.\u003C\u002Fli>\n\u003Cli>Запустите формирование и дождитесь результата.\u003C\u002Fli>\n\u003Cli>Скачайте новый файл из интерфейса или раздела «Генерации»; при включённом прикреплении его можно найти и в таймлайне карточки. Откройте файл.\u003C\u002Fli>\n\u003Cli>Сверьте название карточки, клиента, реквизиты, даты, товары, суммы и задачи с CRM.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>При ошибке найдите попытку в разделе «Генерации» и прочитайте сообщение. Исправьте шаблон или исходные данные, затем выполните новый запуск: повторная генерация создаёт новый результат.\u003C\u002Fp>\n\u003Ch3>Контроль перед использованием\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>В документе не осталось \u003Ccode>{{ ... }}\u003C\u002Fcode>, \u003Ccode>{% ... %}\u003C\u002Fcode> и других служебных выражений.\u003C\u002Fli>\n\u003Cli>Контрагент и своя организация не перепутаны.\u003C\u002Fli>\n\u003Cli>Длинные названия, кириллица, кавычки и переносы строк читаются корректно.\u003C\u002Fli>\n\u003Cli>Таблица проверена без элементов, с одним элементом и с несколькими.\u003C\u002Fli>\n\u003Cli>Суммы, скидки, налоги и нулевые значения соответствуют исходным данным.\u003C\u002Fli>\n\u003Cli>Даты и время показаны в нужном формате.\u003C\u002Fli>\n\u003Cli>Связанные задачи проверены с трудозатратами и без них.\u003C\u002Fli>\n\u003Cli>В Excel нет обрезанного текста, повреждённых формул и неожиданных разрывов области печати.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Если результат отличается от ожидаемого\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Ситуация\u003C\u002Fth>\n\u003Cth>Что проверить\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Поле пустое\u003C\u002Ftd>\n\u003Ctd>Код и регистр выражения, наличие значения, связь с клиентом, выбранную сущность и доступность данных\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Пользовательское поле не найдено\u003C\u002Ftd>\n\u003Ctd>Актуальный каталог вашего портала; номер поля в другом портале не подходит\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Таблица не повторяется\u003C\u002Ftd>\n\u003Ctd>Отдельные строки начала и конца, имя списка, одинаковое имя \u003Ccode>item\u003C\u002Fcode> внутри цикла\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Нет задач\u003C\u002Ftd>\n\u003Ctd>Связь задач с текущей карточкой CRM\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Нет затраченного времени\u003C\u002Ftd>\n\u003Ctd>Зарегистрированные трудозатраты; плановая оценка не равна затраченному времени\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Ошибка \u003Ccode>duration\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Формат \u003Ccode>seconds\u003C\u002Fcode> или \u003Ccode>HH:mm:ss\u003C\u002Fcode> и целые неотрицательные секунды на входе\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Не копируется пример\u003C\u002Ftd>\n\u003Ctd>Выделите текст и скопируйте вручную: браузер может ограничить доступ к буферу\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Шаблон подходит сделке, но не лиду\u003C\u002Ftd>\n\u003Ctd>Прямые пути вроде \u003Ccode>deal.title\u003C\u002Fcode>, выбор сущностей и использование подходящих алиасов\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Файл создан, но оформление нарушено\u003C\u002Ftd>\n\u003Ctd>Макет в Word или Excel, высоту строк, объединённые ячейки, длинный текст и печать\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Ch2>Ограничения и дополнительные возможности\u003C\u002Fh2>\n\u003Cp>Основные форматы шаблонов и результатов — DOCX и XLSX. Возможность «Сформировать PDF» зависит от настроенного преобразования в среде приложения. Проверяйте PDF отдельно; доступность флажка не заменяет проверку готового файла.\u003C\u002Fp>\n\u003Cp>Изображения, QR- и штрихкоды требуют специально подготовленных данных. Произвольная ссылка в текстовом поле не гарантирует вставку изображения. Для первого шаблона используйте готовые основы, а сложные элементы добавляйте после успешной проверки обычных полей и таблиц.\u003C\u002Fp>\n\u003Cp>Каталог не означает, что каждое поле заполнено в каждой карточке. Нет универсального шаблона, который без адаптации охватит любые пользовательские поля, все смарт-процессы и все варианты реквизитов. Подготовьте контрольный пример для каждого рабочего сценария.\u003C\u002Fp>\n\u003Ch2>Что в итоге должно быть у пользователя\u003C\u002Fh2>\n\u003Cp>Рабочий файл-шаблон, понятное назначение и список совместимых сущностей, проверенный документ из реальной карточки и сохранённый образец для дальнейшего сравнения. После этого можно использовать шаблон в повторяющихся операциях, проверяя важные данные перед отправкой документа.\u003C\u002Fp>\n","Возможности и модули"]