Генератор КП в Битрикс24: как настроить шаблоны и создавать документы из сделки

Meta description: Как настроить генератор КП в Битрикс24: шаблоны Word/PDF с подстановкой данных из CRM, ограничения, кейс настройки для B2B-продаж с услугами и оборудованием.

Breadcrumb: Главная / Блог / Генератор КП в Битрикс24

publishedAt: 2026-07-06

---

Менеджер закрыл встречу с клиентом. Теперь надо подготовить КП. Открывает старый документ в Word, вручную меняет название компании, сумму, список позиций, дату. Тратит 15-20 минут. Если клиентов 10 в день: потеряно 2-3 часа на механическую работу.

Битрикс24 позволяет генерировать КП из карточки сделки за 30 секунд: все данные клиента, позиции, суммы подставляются автоматически. Нужен правильно настроенный шаблон.

В этой статье: как работает стандартный генератор документов, как создать шаблон КП, что делать когда стандартных возможностей не хватает.

---

Как работает генератор документов в Битрикс24

Битрикс24 использует систему шаблонов документов. Шаблон — файл Word (.docx) с метками-подстановками. При генерации система берёт данные из карточки сделки и заменяет метки на реальные значения.

Где находится: CRM / Сделки / открыть карточку сделки / кнопка «Документы» (или раздел «Документы» в правой части карточки) / «Создать документ» / выбрать шаблон.

Что подставляется автоматически:

• Название компании и контактного лица
• Дата документа
• Номер сделки
• Позиции (товары/услуги) из раздела «Товары» в карточке сделки
• Суммы (с НДС и без, итоговые)
• Данные из кастомных полей сделки

Результат: готовый документ открывается в редакторе Битрикс24 или скачивается как .docx / .pdf.

---

Как создать шаблон КП

Шаг 1. Подготовить базовый Word-файл

Создайте документ в Microsoft Word или LibreOffice Writer. Это будет ваш шаблон КП: с логотипом компании, реквизитами, структурой предложения, условиями.

Места где нужны данные из CRM: замените на метки в формате `{FieldName}`.

---

Шаг 2. Узнать правильные названия меток

В Битрикс24 метки называются «переменными» или «полями шаблона». Стандартные метки для сделки:

Данные компании-получателя:

• `{COMPANY_TITLE}`: название компании
• `{CONTACT_NAME}`: имя контакта
• `{CONTACT_LAST_NAME}`: фамилия контакта
• `{CONTACT_PHONE}`: телефон контакта

Данные сделки:

• `{DEAL_TITLE}`: название сделки
• `{DEAL_ID}`: номер сделки
• `{DEAL_DATE_CREATE}`: дата создания сделки
• `{DEAL_CLOSEDATE}`: планируемая дата закрытия

Даты:

• `{CURRENT_DATE}`: текущая дата при генерации документа
• `{CURRENT_DATE_SHORT}`: дата в кратком формате

Данные менеджера:

• `{USER_NAME}`: имя менеджера ответственного за сделку
• `{USER_LAST_NAME}`: фамилия
• `{USER_PHONE}`: телефон
• `{USER_EMAIL}`: email

Полный список переменных: CRM / Документы / «Шаблоны документов» / нажать «Переменные» при редактировании шаблона.

---

Шаг 3. Добавить таблицу позиций

Самая важная часть КП: список позиций с ценами.

В Битрикс24 позиции (товары/услуги) хранятся в разделе «Товары» карточки сделки. Для их вывода в шаблоне используется специальный блок-цикл:

``` {#PRODUCTS} {PRODUCT_NAME} | {PRODUCT_PRICE} | {PRODUCT_QUANTITY} | {PRODUCT_SUM} {/PRODUCTS} ```

Этот блок повторится для каждой позиции. В реальном шаблоне это оформляется как строки таблицы Word:

| Наименование | Цена | Кол-во | Сумма | | `{PRODUCT_NAME}` | `{PRODUCT_PRICE}` | `{PRODUCT_QUANTITY}` | `{PRODUCT_SUM}` |

Итоговые суммы:

• `{DEAL_OPPORTUNITY}`: итого без НДС
• `{DEAL_TAX_VALUE}`: сумма НДС
• `{DEAL_OPPORTUNITY_WITH_TAX}`: итого с НДС

---

Шаг 4. Загрузить шаблон в Битрикс24

CRM / Документы / «Шаблоны документов» / «Добавить» / загрузить .docx файл. Указать к какому типу привязан шаблон: «Сделки», «Лиды», «Контакты».

После загрузки: кнопка «Проверить» запустит тест с фиктивными данными. Система покажет ошибки в синтаксисе меток если они есть.

---

Шаг 5. Протестировать генерацию

Открыть любую тестовую сделку с заполненными полями / нажать «Документы» / выбрать новый шаблон / «Создать». Просмотреть результат: все ли поля заполнились, правильно ли выводятся позиции.

---

Ограничения стандартного шаблонизатора

Стандартный генератор подходит для простых КП. Для сложных сценариев возможностей не хватает.

Ограничение 1. Условные блоки ограничены.

Сложная логика вида «если тип клиента = VIP, добавить специальные условия» в стандартном шаблонизаторе реализована ограниченно. Базовые условия (`{if}...{/if}`) поддерживаются, но сложные вложенные условия дают ошибки.

Ограничение 2. Нет мультивалютных расчётов.

Если нужно показать цены в рублях и в евро одновременно с актуальным курсом: стандартный шаблон этого не умеет. Данные нужно вводить вручную или добавлять через кастомные поля.

Ограничение 3. Смешанные позиции (услуги + товары + работы).

Стандартный блок `{#PRODUCTS}` выводит все позиции одним списком. Разбить на категории («Оборудование», «Услуги», «Работы») в стандартном шаблоне нельзя без дополнительных решений.

Ограничение 4. Сложное форматирование.

Большие таблицы с условным форматированием строк, чередующиеся цвета, вложенные таблицы — всё это часто ломается при генерации. Word и Битрикс24 по-разному трактуют сложное форматирование.

Ограничение 5. Нет версионирования.

Стандартный инструмент не отслеживает версии КП. «КП v2» и «КП v3» хранятся в карточке как отдельные файлы, но нет автоматического сравнения версий.

---

Решения для сложных КП

Вариант 1. Улучшить шаблон вручную

Если задача разовая и небольшая: настроить шаблон под конкретный формат КП самостоятельно. Для простых B2B КП (3-10 строк, однородные позиции) стандартного шаблонизатора обычно достаточно.

Вариант 2. Приложения из маркетплейса Б24

В Маркет Битрикс24 есть специализированные приложения для генерации КП: «КП Генератор», «Конструктор документов», другие. Они добавляют условные блоки, мультивалютность, группировку позиций.

Путь: CRM / Документы / «Расширения» или Левая панель / «Приложения» / Маркет / поиск «КП».

Вариант 3. Разработка кастомного решения

Для компаний с высокими требованиями к документам: разработка собственного генератора через REST API Битрикс24. Система забирает данные из сделки через API, генерирует PDF по собственным шаблонам (через сторонние библиотеки), возвращает файл в карточку.

Это позволяет сделать КП любой сложности: сложные таблицы, графики, фирменные цвета, несколько страниц с разными секциями.

---

Кейс: КП для B2B с услугами и оборудованием

Задача: торговая компания продаёт оборудование + монтаж + сервисное обслуживание. КП должно разбивать позиции на три секции с отдельными итогами по каждой.

Проблема со стандартным шаблоном: `{#PRODUCTS}` выводит всё в одну таблицу. Нельзя автоматически разделить «Оборудование» от «Монтажа».

Решение через кастомные поля:

1. В каждой позиции каталога добавить поле «Категория» (оборудование / монтаж / обслуживание).
2. В шаблоне использовать три отдельных блока с фильтром по категории. Это требует поддержки приложением или разработкой: стандартный шаблонизатор Битрикс24 фильтрацию внутри `{#PRODUCTS}` не поддерживает.
3. Интегратор настроил кастомный генератор через REST API: при нажатии кнопки в карточке сделки скрипт забирает позиции, сортирует по категориям, генерирует PDF. Файл автоматически прикрепляется к сделке и отправляется клиенту.

Результат: время подготовки КП сократилось с 20-25 минут до 2 минут. Ошибки в суммах устранены полностью (ручной ввод заменён автоматическим расчётом).

---

С чего начать

Если КП у вас простые (одна категория позиций, фиксированный формат): начните со стандартного шаблонизатора. Настройка занимает 2-3 часа, результат: готовый генератор КП без дополнительных затрат.

Если КП сложные или у вас больше трёх форматов КП для разных продуктов: сначала проверьте текущее состояние системы. Скачайте аудит-чеклист — он покажет насколько правильно заполнены карточки сделок и товарный каталог. Без корректных данных в CRM любой генератор будет выдавать документы с ошибками.

---

Полезные материалы

• Аудит-чеклист Битрикс24 : проверьте заполнение карточек и каталога перед настройкой шаблона
• Шаблоны задач для отдела продаж : задача «Подготовить КП» как этап воронки
• Шаблоны писем клиентам : письмо после отправки КП клиенту
• Чек-лист РОПа: 30 вопросов на планёрке : как контролировать конверсию КП в сделки