Модификаторы в шаблонах документов CRM Битрикс24: примеры

Шаблоны документов в CRM Битрикс24 автоматически подставляют данные клиента и сделки в договоры, счета и коммерческие предложения — но по умолчанию поля выводятся «как есть»: имя в именительном падеже, дата в стандартном формате, сумма — числом. Для деловой переписки этого часто недостаточно: договор с обращением «Уважаемый Сергей Терехов, оплатите...» вместо «Уважаемому Сергею Терехову...» выглядит небрежно. Модификаторы решают именно эту задачу — меняют формат вывода поля без изменения самих данных в CRM. Разберём, какие они бывают и как их применять на практике.

Шаг 1. Откройте список шаблонов документов

Модификаторы пишутся внутри самого шаблона, поэтому начинаем со списка шаблонов. В Битрикс24 он находится в настройках CRM, в разделе «Шаблоны документов». Здесь видно, какие шаблоны уже подключены, к каким сделкам и воронкам они привязаны и когда их меняли в последний раз. Шаблон — это обычный файл (например, договор или счёт), в текст которого вставлены символьные коды полей. Именно в этих кодах мы и будем добавлять модификаторы.

Новый шаблон загружается кнопкой «Загрузить» в правом верхнем углу списка; существующий можно скачать, поправить коды в текстовом редакторе и загрузить заново.

Шаг 2. Посмотрите, где документ формируется из шаблона

Готовый документ менеджер создаёт из карточки сделки: в верхней панели есть кнопка «Документ», а в меню — список шаблонов, привязанных к этой воронке. Именно в этот момент CRM подставляет данные клиента в коды полей и применяет модификаторы — поэтому проверять результат нужно здесь же, сформировав тестовый документ.

Шаг 3. Что такое модификатор и где его писать

Модификатор — это специальный код, который меняет формат вывода поля в шаблоне документа. Он размещается внутри символьного кода поля после знака тильды (~). Например, в коде {DocumentCreateTime~d.m.Y h:i:s} часть DocumentCreateTime — это сам символьный код поля «Дата создания документа», а d.m.Y h:i:s — модификатор, который задаёт формат даты и времени.

Работать с модификаторами имеет смысл только после того, как вы разобрались с символьными кодами полей — без кода модификатор просто не к чему прикрепить. Важно и то, что модификаторы применяются не ко всем полям подряд, а только к тем, у которых указан определённый тип: дата, имя, адрес, денежная сумма, телефон, текст.

Технически модификатор — это просто дополнительный параметр, который движок шаблонов Битрикс24 распознаёт и обрабатывает при формировании документа. CRM хранит исходное значение поля без изменений, а модификатор влияет только на то, как это значение будет напечатано в конкретном документе — договоре, счёте или акте. Один и тот же символьный код можно использовать в разных шаблонах с разными модификаторами: например, в договоре имя клиента понадобится в родительном падеже, а в письме-напоминании — в именительном, и оба варианта работают от одних и тех же исходных данных карточки.

Шаг 4. Модификаторы даты и времени

По умолчанию дата в документе выводится в формате страны, указанной в настройках шаблона. Модификаторы позволяют задать собственный вид: d.m.y даст «28.08.23», d.m.Y — «28.08.2023», а j F, Y — «28 Августа, 2023». Форматы времени и даты можно комбинировать — например, Y-m-d H:i:s выведет «2023-08-28 10:24:18».

Для деловых документов часто нужен именно текстовый формат даты с названием месяца словами — он читается естественнее, чем набор цифр через точку, особенно в договорах и актах, которые клиент видит впервые.

Шаг 5. Модификаторы имени и падежа

С системными полями ФИО можно управлять и порядком слов, и падежом. Модификатор ~Format= задаёт последовательность частей имени через специальные обозначения: #NAME# — имя, #LAST_NAME# — фамилия, #SECOND_NAME# — отчество, а также их сокращённые варианты с первой буквой и точкой. Например, код {ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#} выведет имя в порядке «фамилия имя отчество».

Для изменения падежа используется модификатор ~Case= со значением от -1 до 4: -1 — именительный, 0 — родительный, 1 — дательный, 2 — винительный, 3 — творительный, 4 — предложный. Склонение работает только для имён на русском языке, где указано отчество. Например, {ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#, Case=0} выведет полное имя в родительном падеже — «для кого документ». Такой же принцип применяется и к отдельным должностям — например, к директору или главному бухгалтеру компании: коды вида {CompanyRequisiteRqDirector~Case=0} позволяют корректно склонять их в тексте договора.

Шаг 6. Модификаторы адреса

Формат адреса по умолчанию тоже определяется страной шаблона, но его можно переопределить модификатором ~Format= с числовым значением: 1 — европейский формат, 2 — британский, 3 — североамериканский, 4 — российский (сначала улица, потом страна), 5 — российский (сначала страна, потом улица). Отдельным параметром ~Separator= задаётся разделитель частей адреса: 1 — запятая, 2 — без разделителя, 3 — перевод строки.

Например, код {ContactAddress~Format=5,Separator=3} выведет адрес в формате «страна → улица» с переводом строки между частями — удобно для официальных бланков, где адрес принято оформлять построчно, а не одной длинной строкой через запятую.

Шаг 7. Модификаторы для денежных сумм

Для полей с деньгами доступно сразу несколько параметров. WZ (With Zeros) управляет незначащими нулями — по умолчанию они показываются в основных суммовых полях, а модификатор WZ=N убирает их, превращая «12.00 рублей» в «12 рублей». NS (No Sign) убирает или показывает знак валюты. W (Words) выводит сумму прописью — эта функция доступна для рублей, белорусских рублей, гривен и тенге. Параметры SN и WP управляют отображением ставки НДС — с процентом или без, с текстом «НДС» или только числом.

Комбинация модификаторов для суммы прописью выглядит так: {TotalSum~W=Y}. Для налоговой ставки с процентом, но без слова «НДС»: {TaxesTaxRate~WP=Y, SN=Y}. На практике сумма прописью — один из самых часто запрашиваемых модификаторов при настройке шаблонов счетов и актов: без неё документ выглядит незавершённым для официального оборота.

Шаг 8. Модификаторы телефона и регистра текста

Формат номера телефона можно изменить модификатором ~format= с одним из трёх значений: E.164 — «+7900xxxxxxx», International — «+7 900 xxx-xx-xx», National — «8 (900) xxx-xx-xx». Выбор формата обычно диктуется требованиями к оформлению конкретного документа — например, для международных партнёров логичнее формат International, для внутренней документации — привычный National.

Для текстовых полей есть модификатор регистра ~letterCase= со значениями upper (ВЕРХНИЙ РЕГИСТР), lower (нижний регистр) и title (Каждое Слово С Заглавной). Он часто применяется вместе с модификатором даты, чтобы месяц в тексте выводился со строчной буквы, как это принято в деловой переписке: «25 апреля 2022» вместо «25 Апреля 2022».

Шаг 9. Вывод значений из множественных полей

Некоторые поля CRM — например, телефон или почта — могут содержать сразу несколько значений. Для таких множественных полей есть три специальных модификатора. ~mfirst= определяет, выводить одно значение или все: mfirst=y — только первое (например, для документа нужен один основной контактный номер), mfirst=n — все значения через запятую, а с добавлением ~mseparator=2 — каждое на отдельной строке, что удобнее для печатных бланков.

Модификатор ~index= выводит конкретный товар из списка товаров сделки: нумерация начинается с нуля, то есть index=0 — первый товар, index=1 — второй и так далее. Он работает только со списком товаров и только если код поля стоит вне таблицы шаблона. Третий модификатор, ~all=y, выводит все элементы, привязанные к сделке через системное поле «Привязка к элементам CRM», — например, все связанные компании или предложения через запятую.

Шаг 10. Проверьте результат на практике

По нашему опыту настройки CRM, шаблоны документов — это тот участок, который компании часто откладывают «на потом», ограничиваясь стандартным набором полей без модификаторов. В результате менеджеры вручную донабирают в готовом договоре обращение в нужном падеже или переписывают сумму словами перед отправкой клиенту — притом что оба действия можно один раз настроить в шаблоне и больше к ним не возвращаться.

Особенно это заметно в компаниях с большим документооборотом: юридических и бухгалтерских услугах, оптовой торговле, строительстве. Там счета и договоры выставляются десятками в месяц, и каждая ручная правка — это не только потерянное время, но и риск ошибки перед отправкой клиенту. Один раз настроенный шаблон с корректными модификаторами снимает эту рутину полностью: документ формируется автоматически в готовом к отправке виде. Настройка таких шаблонов — обычно небольшая, но точечная задача в рамках внедрения или сопровождения CRM, которая быстро окупается за счёт сэкономленного времени менеджеров.

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

Ещё один практический момент — тестировать шаблон с модификаторами нужно на реальной, а не на тестовой сделке с условными данными. Модификаторы падежа и множественных полей особенно чувствительны к тому, насколько аккуратно заполнена сама карточка: если в поле ФИО отчество не указано, склонение по падежам просто не сработает, и это легко принять за ошибку в самом модификаторе, хотя причина — в неполных данных карточки. Поэтому перед массовым внедрением нового шаблона документа стоит один раз пройтись по нескольким реальным клиентам с разными по полноте данными и проверить, как код ведёт себя в каждом случае.

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

Читайте также