ДокМастер24 — как работать с модулем

Модуль формирует документы (счёт, договор, акт, КП, налоговые формы) по данным сделки или счёта CRM и кладёт готовый файл в раздел «Документы» карточки. Ниже — всё, что нужно для работы.

1. Быстрый старт

1. Откройте карточку сделки или счёта в CRM.
2. Нажмите кнопку «ДокМастер24» (панель действий карточки) — откроется виджет со списком доступных форм.
3. Кликните нужную форму — документ сформируется и появится в разделе «Документы» карточки (в форматах .docx и .pdf).

2. Виджет генерации

Открывается кнопкой в карточке. Возможности:

• Одна форма — клик по названию сразу формирует документ.
• Несколько сразу — включите «выбрать несколько», отметьте формы и нажмите «Сформировать выбранные» (например, счёт + договор + акт одним действием).
• ⚙ Управление шаблонами — открывает менеджер шаблонов (см. ниже).

3. Менеджер шаблонов

Открывается плиткой приложения в CRM или ссылкой «Управление шаблонами» из виджета. Здесь вы:

• видите библиотеку готовых форм и свои загруженные шаблоны, сгруппированные по категориям;
• включаете/выключаете формы переключателем — выключенные не показываются в виджете;
• загружаете свои .docx и удаляете их;
• смотрите каталог полей — кликом копируете нужный плейсхолдер;
• делаете предпросмотр любой формы на реальной сделке/счёте.

4. Свой шаблон .docx

Загрузите обычный Word-файл (.docx), в котором на месте подстановок стоят плейсхолдеры в фигурных скобках. При генерации модуль заменит их данными карточки.

1. Сверстайте документ в Word — со своим оформлением, логотипом, подписями.
2. Вместо конкретных значений впишите плейсхолдеры, например {company.name}, {total_words}.
3. Товары оформите одной строкой таблицы, обёрнутой в {#items} … {/items} — строка размножится по числу позиций.
4. Сохраните и загрузите файл в менеджере («Загрузить свой шаблон»).

5. Поля-плейсхолдеры

Полный актуальный список всегда есть в менеджере (блок «Поля для вставки в шаблон»). Основные:

Документ

Плейсхолдер	Значение
{doc.number}	Номер документа (ID сделки/счёта)
{doc.doc_number}	Сквозной номер с годом (2026-00001)
{doc.date}	Дата документа
{doc.title}	Название сделки

Поставщик / Клиент

Одинаковый набор с префиксом company. (наша компания) и client. (контрагент):

Плейсхолдер	Значение
{company.name} / {client.name}	Наименование
…​.inn, …​.kpp, …​.ogrn	ИНН, КПП, ОГРН/ОГРНИП
…​.address	Адрес
…​.bank_name, …​.bik	Банк, БИК
…​.account, …​.corr_account	Расчётный и корр. счёт

Товары (внутри цикла {#items}…{/items})

Плейсхолдер	Значение
{n}	Порядковый №
{name}, {qty}, {unit}	Наименование, количество, ед. изм.
{price}, {sum}	Цена, сумма по строке
{vat_rate}, {vat_sum}	Ставка и сумма НДС

Итоги

Плейсхолдер	Значение
{total}	Итого
{total_words}	Итого прописью (рублями и копейками)
{vat_total}	Итого НДС
{items_count}	Количество позиций

6. Циклы, условия, QR

Строка товаров

В первой ячейке строки таблицы поставьте {#items}, в последней — {/items}, а между ними — поля позиции. Строка автоматически размножится:

| {#items}{n} | {name} | {qty} {unit} | {price} | {sum} |{/items}

Условные блоки

Синтаксис	Показывается
{#is_company}…{/is_company}	только если клиент — юрлицо
{^is_company}…{/is_company}	только если клиент — физлицо
{#has_vat}…{/has_vat}	только если в документе есть НДС

QR-код оплаты

Плейсхолдер {%qr} вставляет QR оплаты по счёту (стандарт ГОСТ Р 56042). Клиент оплатит, отсканировав его в банковском приложении. Ставьте {%qr} там, где нужна картинка.

7. Предпросмотр

В менеджере укажите тип и ID реальной сделки/счёта, затем нажмите «Предпросмотр» у нужной формы — документ отрисуется по её данным (PDF). Так удобно проверять свой шаблон, не создавая файл в карточке.

8. Автоматизация — робот бизнес-процесса

Документ можно формировать автоматически на этапе воронки. В роботах или бизнес-процессе сделки добавьте действие «ДокМастер24: сформировать документ» и укажите код формы в параметре template_code (например invoice, act, upd). Готовый документ ляжет в карточку без участия менеджера.

9. Библиотека форм

Категория	Формы
Базовые	Счёт на оплату, Договор, Акт выполненных работ, Коммерческое предложение
Налоговые (2026)	Счёт-фактура, УПД (форма ПП 26)
Товарные	Товарная накладная ТОРГ-12
Прочие	Спецификация к договору, Дополнительное соглашение, Доверенность на получение ТМЦ (М-2а)

Библиотека обновляется централизованно — новые и актуализированные формы появляются автоматически.

10. Частые вопросы

В карточке нет кнопки «ДокМастер24»

Кнопка ставится при установке приложения. Если её нет — переустановите приложение (Приложения → ДокМастер24), обновите страницу карточки. Кнопка доступна в сделках и счетах.

В документе пустые поля (реквизиты, банк)

Значения берутся из карточки. Проверьте, что у сделки/счёта заполнены реквизиты компании и контрагента (ИНН, банк, счёт) и добавлены товарные позиции. Незаполненное в CRM поле останется пустым и в документе.

Товары не размножаются / попала только одна строка

Убедитесь, что {#items} стоит в первой ячейке строки таблицы, а {/items} — в последней, и обе метки в одной и той же строке. Поля позиции ({name}, {qty}…) — между ними.

Мой плейсхолдер не подставился, остался текстом

Чаще всего Word разбил метку на фрагменты форматированием. Удалите её целиком и наберите заново одним куском, без изменения шрифта/цвета внутри скобок. Сверьте имя поля с каталогом в менеджере.

Нужен PDF, а приходит только .docx

Модуль формирует оба формата. Если PDF недоступен, документ всё равно создаётся в .docx — его можно открыть и сохранить как PDF из Word/CRM.

11. Доступ и подписка

Все функции включены Никаких платных «тарифов» внутри модуля нет: библиотека форм, свои шаблоны, налоговые формы, пакетная генерация, QR оплаты и робот БП доступны всем без ограничений.

Модуль распространяется по подписке через Маркетплейс Битрикс24 — доступ действует, пока активна подписка портала.

Остались вопросы? Напишите в поддержку — контакты указаны на странице приложения в Маркетплейсе.