Библиотека готовых форм закрывает типовые документы, но рано или поздно упирается в бланк, который у компании свой: договор от юристов, акт с фирменным оформлением, спецификация с нестандартной таблицей. Разбираем, как подключить собственный шаблон .docx в Битрикс24 и какие плейсхолдеры в нём расставлять.
Как работает шаблонизация
Идея простая: вы берёте обычный файл Word, ставите в нужных местах метки вида {company.name}, загружаете его в приложение — а оно при генерации заменяет метки данными сделки. Формат .docx остаётся вашим: шрифты, колонтитулы, логотип, таблицы, нумерация — всё сохраняется, потому что документ не пересобирается, а заполняется.
Отсюда главное правило: сначала доводите вёрстку в Word, потом расставляйте метки. Обратный порядок приводит к тому, что метка разрывается форматированием на несколько фрагментов и перестаёт находиться.
Каталог полей: что можно подставить
Ваша компания и клиент
{company.name}, {company.inn}, {company.kpp}, {company.ogrn}, {company.address}, {company.bank_name}, {company.bik}, {company.account}, {company.corr_account} — и такой же набор с префиксом client. для контрагента.
Документ
{doc.number} — номер, {doc.date} — дата, {doc.doc_number} — номер с годом вида 2026-00001, {doc.seq} — сквозной номер из нумератора, {doc.title} — название сделки.
Таблица товаров
Строка таблицы оборачивается в цикл: {#items} в первой ячейке и {/items} в последней. Внутри доступны {n} — порядковый номер, {name}, {qty}, {unit}, {price}, {sum}, {vat_rate}, {vat_sum}. Строк в готовом документе будет столько, сколько позиций в сделке.
Итоги
{total}, {total_words} — сумма прописью, {vat_total}, {items_count}.
Условные блоки
{#is_company}…{/is_company} — фрагмент выводится только если клиент юрлицо; {#has_vat}…{/has_vat} — только при наличии НДС. Один шаблон вместо двух редакций, которые неизбежно расходятся при правках.
QR оплаты
Маркер @@QR@@ — на его месте встаёт платёжный QR-код по ГОСТ Р 56042. Если банковские реквизиты не заполнены, код построить не из чего, и маркер вместе с подписью к нему из документа убирается.
Как подключить свой файл
- Откройте менеджер шаблонов приложения ДокМастер24.
- Скопируйте нужные плейсхолдеры из каталога полей — они кликабельны, копируются в один клик.
- Расставьте их в своём
.docxи загрузите файл. - Проверьте предпросмотром на реальной сделке — до того, как документ уйдёт клиенту.
Готовые формы библиотеки можно выключать по отдельности или переопределять своим файлом: тогда в списке у менеджера останется только то, чем компания реально пользуется, и никто не выберет случайно не ту форму.
Три ошибки при вёрстке шаблона
1. Метка разорвана форматированием
Если начать печатать метку, потом выделить её часть и изменить шрифт, Word разрежет её на несколько фрагментов. Визуально это незаметно, но подстановка не сработает. Лечится так: удалить метку целиком и напечатать заново одним куском, не меняя форматирование по ходу.
2. Цикл товаров не в тех ячейках
{#items} должен стоять в первой ячейке повторяемой строки, а {/items} — в последней ячейке той же строки. Если поставить их в соседние строки, размножится не то, что нужно.
3. Проверка на пустом
Шаблон, проверенный на сделке с одной позицией и без НДС, ничего не говорит о том, как он поведёт себя на пятнадцати позициях с разными ставками. Проверяйте на реальной, «толстой» сделке.
Частые вопросы
Что будет со шаблоном при обновлении библиотеки?
Ничего. Обновляются только готовые формы разработчика, ваши файлы не затрагиваются.
Можно ли использовать колонтитулы и логотип?
Да, оформление файла сохраняется полностью — документ заполняется, а не пересобирается.
Формируется PDF или .docx?
И то и другое: PDF собирается на стороне приложения, поэтому вёрстка одинакова у всех получателей.
Коротко
Свой шаблон — это ваш файл Word плюс метки из каталога полей. Условные блоки убирают дублирование редакций, цикл товаров закрывает таблицу любой длины, предпросмотр ловит ошибки вёрстки до клиента. Подробный разбор приложения — в статье «Генератор документов для Битрикс24: обзор ДокМастер24».
Нужна помощь с шаблонами документов в Битрикс24? ArtisMedia занимается внедрением и поддержкой портала. Наши контакты.