Генератор документов в Битрикс24 собирает счёт, акт или коммерческое предложение из DOCX-шаблона и данных CRM: полей сделки, компании, контакта, товарных позиций и реквизитов. Звучит просто, но на практике документ выходит чистым только тогда, когда до вёрстки проделана подготовительная работа.
Сначала карта данных
До того как открывать DOCX, стоит составить карту данных: для каждого места в форме определить источник — текущий элемент CRM, компания, контакт, реквизиты своей компании, товарная позиция или поле экземпляра документа. Без этого после генерации остаются пустые строки, которые менеджер правит руками.
Коды не пишут вручную. В карточке элемента открывают «Документ» → «Добавить новый шаблон» → «Настройки» → «Список полей». Битрикс24 показывает поля и коды, доступные именно в этом контексте. Это особенно важно для пользовательских полей: их код выглядит как {UfCrm…}, но точное значение формируется на конкретном портале. Код из чужого шаблона может ссылаться на поле, которого на вашем портале нет.
Шаблон и товарные позиции
Для товаров используют повторяемый блок {PRODUCTS.BLOCK_START} / {PRODUCTS.BLOCK_END} либо строку таблицы с кодами товаров. Битрикс24 повторяет блок для каждой позиции. Настройка «Табличная часть» определяет, выводятся товары, услуги или оба типа. Сами данные сделки она не трогает.
У кодов есть модификаторы. Например, {DocumentCreateTime~d.m.Y} выводит дату в формате день.месяц.год, ~format=E.164 форматирует телефон, а mfirst берёт первое значение множественного поля. Каждое поле проверяют по трём пунктам: источник, код и формат. Для даты — значение в карточке, потом формат отображения. Для суммы — валюта, дробная часть и текстовое представление.
Подписи, печати и нумерация
Изображение подписи или печати не является электронной подписью и не влияет на юридическую значимость документа. Это просто картинка. Для теста вместо реальных ИНН и счетов используют заглушки — «ООО TEST», «TEST-РЕКВИЗИТ», «TEST-БАНК», — чтобы тестовый файл нельзя было принять за рабочий.
Следующий номер проверяют и меняют в настройках нумератора. Это пригождается, когда нумерацию продолжают после другой системы. Для лидов и сделок действует стандартная нумерация, которую справка не предлагает менять.
Права и робот
Права на документы настраивают по ролям и делят на настройки, шаблоны и сами документы. Для шаблонов есть уровни «Нет доступа», «Свои», «Свои + своего отдела» и «Любые». Для документов отдельно задают просмотр и изменение.
Чтобы убрать ручной запуск, робота «Создать документ» вешают на нужную стадию CRM. В параметрах выбирают шаблон. Робот может ждать конвертацию в PDF, добавлять подпись и печать, создавать публичную ссылку и подставлять реквизиты своей компании.
Типовые ошибки
Большинство ошибок связано не с созданием файла, а с исходными данными, кодами и правами. Поле осталось пустым — проверьте исходное поле и связь с компанией или контактом. В документ попало не то значение — сверьте код со списком полей в текущем контексте. Не работает пользовательское поле — скопируйте фактический {UfCrm…} со своего портала. Номер оказался неожиданным — проверьте нумератор, часовой пояс и период сброса.
Штатный генератор работает с шаблонами и данными CRM. Он не заменяет отдельную СЭД, не гарантирует заполненность карточек и не ведёт версии при повторном создании. Но для повторяемых документов по структурированным данным его хватает.
Top comments (0)