Разработка шаблонов документов CRM Битрикс24

В Битрикс24 менеджер создаёт сделку, нажимает «Сформировать документ» и получает акт или договор — но с пустыми полями там, где должны быть реквизиты клиента, сумма прописью на русском не совпадает с цифровой, а логотип компании не вставлен. Это типичная картина после первого внедрения: шаблоны документов идут из коробки минимальными, под реальные задачи бизнеса их нужно дорабатывать.

Разработка шаблонов документов CRM Битрикс24

Как работают шаблоны документов в Битрикс24

Шаблоны документов в Битрикс24 доступны в разделе CRM → Настройки → Шаблоны документов (в зависимости от версии — также через карточку сделки/счёта). Функционал входит в модуль crm и работает на базе встроенного шаблонизатора.

Шаблон создаётся в формате docx (Microsoft Word) — это ключевой момент. Битрикс24 использует docx как формат шаблона с плейсхолдерами в двойных фигурных скобках: {ContactName}, {DealTitle}, {TotalPrice}. При генерации документа плейсхолдеры заменяются реальными данными CRM, итоговый файл отдаётся как docx или конвертируется в PDF.

Доступные переменные (плейсхолдеры)

Список доступных переменных зависит от типа документа (сделка, счёт, коммерческое предложение, контакт, компания). Базовые для сделки:

• {DealId}, {DealTitle}, {DealOpportunity} — ID, название, сумма
• {ContactName}, {ContactPhone}, {ContactEmail} — данные контакта
• {CompanyTitle}, {CompanyAddress} — данные компании
• {AssignedName} — ответственный менеджер
• {CreatedDate} — дата создания

Для табличных данных (список товаров в сделке) используются блоки повторения — секции docx с маркерами {#Products}...{/Products}.

Пользовательские поля CRM (UF_CRM_*) также доступны через соответствующие плейсхолдеры — их нужно добавить вручную в список переменных шаблона.

Разработка шаблона в docx

Процесс: создаём docx в Microsoft Word или LibreOffice, расставляем плейсхолдеры в нужных местах, загружаем в Битрикс24. Критически важно:

• Плейсхолдер должен быть одним текстовым run в XML Word. Если плейсхолдер набран посимвольно или часть его форматирована иначе (например, середина жирная) — Word разобьёт его на несколько <w:r> и Битрикс24 его не распознает
• Для проверки открываем docx как ZIP-архив, смотрим word/document.xml — плейсхолдер должен быть внутри одного <w:t>
• Таблицы с повторяющимися строками требуют особой разметки: маркеры {#} и {/} должны быть в отдельных строках таблицы, не смешиваться с данными

Кейс: договор оказания услуг для агентства

Маркетинговое агентство, Битрикс24 облако. Менеджеры создают договоры вручную в Word, копируя данные из CRM — теряют по 20–30 минут на каждый договор, иногда вставляют не те реквизиты.

Разработали шаблон договора: шапка с реквизитами агентства (статичный текст), реквизиты клиента — из полей компании ({CompanyTitle}, кастомные UF-поля ИНН, КПП, адрес), предмет договора — из поля сделки, сумма — {DealOpportunity} + сумма прописью через кастомное UF-поле (менеджер вводит вручную, поскольку автоматическая конвертация в propis не поддерживается нативно). Подписи — статичные строки с пустыми полями.

Результат: договор формируется за 10 секунд, ошибок с реквизитами нет.

Ограничения и обходы

Битрикс24 не умеет нативно: конвертировать числа в пропись, применять сложные условия в шаблоне (IF/ELSE), вставлять изображения из CRM. Обходы: пропись — через кастомное UF-поле или роботы, которые записывают значение; условия — через несколько шаблонов под разные сценарии.

Сроки