Формирование документов Битрикс24. Модификаторы

Многие компании имеют дело с обширным объемом документов, включая накладные, контракты и счета. Обычно слово «документ» вызывает ассоциации с множеством бумаг, которые необходимо грамотно организовать и поддерживать в порядке.

Бумага уходит в прошлое, и документы теперь хранятся на жестких дисках и в облаке. 

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

CRM-система Битрикс24 позволяет быстро и удобно создавать документы всего в пару кликов с помощью конструктора документов. 

В CRM Битрикс24 карточки содержат поля с данными, которые автоматически подставляются в шаблоны документов. Это позволяет быстро создавать и отправлять документы клиентам.

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

Переменные данные, например, номер документа и информация о клиенте, меняются в каждом документе. 

Отображение в документе переменных данных можно вывести в желаемом формате благодаря модификаторам. 

Полезная информация!

В активити бизнес-процесса для создания документов можно использовать как собственные значения, так и нестандартные, присваивая им данные из бизнес-процесса. Это позволяет гибко настраивать процесс и адаптировать его под конкретные нужды организации.

Например, в вашем документе имеется пользовательское поле, где вы определяете условия возврата товара. Эти условия варьируются в зависимости от того, заключаете ли вы договор с физическим или юридическим лицом. 

Используя опцию “Поля документа”, вы можете вставить в это поле необходимый текст, например, из переменной.

Более детально описано в статье “Подробнее о роботах: создание документа CRM”, автор Эдуард Узлов: https://helpdesk.bitrix24.ru/open/15535158/

Модификатор — это уникальный код, который изменяет формат отображения поля. Например, поле Ф.И.О. стандартно показывается в именительном падеже, как Виктор Попов. Чтобы в Битрикс24 отобразить его в родительном падеже, например, как Виктора Попова, необходимо добавить к символьному коду определенный модификатор.

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

ВАЖНО! Модификаторы применяются только к полям с указанным типом в списке полей.

Чтобы посмотреть список символьных кодов, откройте элемент, например, сделку:

1–2. Нажмите Документ > Добавить новый шаблон.
3–4. Нажмите Настройки (⚙️) > Список полей.

Виды модификаторов

Модификаторы применяются к датам, именам, адресам, деньги и регистру текста. Давайте рассмотрим модификаторы для каждого из этих типов.

Модификаторы для даты и времени

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

Модификаторы даты:

• d.m.y — 28.08.23

• d.m.Y — 28.08.2023

• j, n, Y — 28, 08, 2023

• j F, Y — 28 Августа, 2023

Модификаторы времени:

• H:i:s — 10:24:18

Модификаторы даты и времени можно комбинировать:

• Y-m-d H:i:s — 2023-08-28 10:24:18

Полный список модификаторов даты и времени есть в документации для разработчиков.
Дополнительные параметры даты и времени: https://dev.1c-bitrix.ru/api_help/main/functions/date/formatdate.php

Для изменения порядка используйте параметр ~format=. 

Эти модификаторы применяются только к системным полям.

Системные поля в CRM:

#TITLE# — обращение  

#NAME# — имя  

#LAST_NAME# — фамилия  

#SECOND_NAME# — отчество  

#NAME_SHORT# — первая буква имени с точкой  

#LAST_NAME_SHORT# — первая буква фамилии с точкой  

#SECOND_NAME_SHORT# — первая буква отчества с точкой  

Чтобы вывести имя в порядке: обращение, фамилия, имя, отчество, используйте символьный код {ContactFormattedName} с модификаторами: {ContactFormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#}.

Для изменения падежа используйте параметр ~Case=. Склонение по падежам работает только для русских имён с отчеством.

Модификаторы падежа:

-1 — именительный  

0 — родительный  

1 — дательный  

2 — винительный  

3 — творительный  

4 — предложный  

Чтобы создать код для имени в родительном падеже, добавьте модификатор: {ContactFormattedName~Format=#TITLE# #LAST_NAME# #NAME# #SECOND_NAME#, Case=0}.

Если нужно вывести имя главного бухгалтера или директора в родительном падеже, используйте {CompanyRequisiteRqDirector~Case=0} для директора и {CompanyRequisiteRqAccountant~Case=0} для бухгалтера.

Модификаторы адреса 

В Битрикс24 по умолчанию используется формат адреса, соответствующий стране текущего шаблона.

Формат адреса можно изменить и добавить разделитель строк. Для изменения формата используйте параметр ~Format=, а для разделения строк — ~Separator=.

Модификаторы для формата и разделителя:

Для параметра Format:

1 — Европа

2 — Великобритания

3 — Северная Америка

4 — Россия (улица > страна)

5 — Россия (страна > улица)

Для параметра Separator:

1 — запятая

2 — без разделителя

3 — перевод строки

Чтобы задать тип адреса — Россия (страна > улица) с переводом строки между частями адреса, добавьте к коду поля адреса контакта нужные модификаторы: {ContactAddress~Format=5,Separator=3}

Модификаторы для денег 

С помощью специального модификатора можно вывести сумму прописью, доступную для рублей, белорусских рублей, гривен и тенге.

Доступные параметры:

- WZ (With zeros). По умолчанию Битрикс24 отображает незначащие нули в денежных суммах. При WZ=N сумма будет без таких нулей, например, 12.00 рублей станет 12 рублей. Нули по умолчанию выводятся в полях {TotalRaw}, {TaxesTaxRate}, {TotalSum}. В табличных полях, таких как {ProductsProductPriceRawNetto} и {ProductsProductPriceRawSum}, нули отображаются только с модификатором WZ=Y.

- NS (No sign). При NS=Y сумма будет без знака валюты, а при NS=N — со знаком.

- W (Words). При W=Y сумма будет написана прописью.

Чтобы вывести сумму сделки прописью и с обозначением валюты, используйте код суммы и модификаторы: {TotalSum~W=Y,NS=N}.

Одним из таких инструментов являются модификаторы, которые позволяют гибко настраивать отображение данных в шаблонах документов. В данной статье мы рассмотрим, как использовать модификаторы в шаблонах документов Битрикс24, типы модификаторов и как с их помощью вывести значения из множественного поля.

Модификаторы для телефона 

Позволяют изменить формат номера с помощью параметра ~format=.

Доступные форматы:

E.164 — +7900xxxxxxx

International — +7 900 xxx-xx-xx

National — 8 (900) xxx-xx-xx

Чтобы отобразить номер контакта в привычном формате +7 без пробелов, используйте код {ContactPhone~format=E.164}, где {ContactPhone} обозначает поле «Телефон контакта».

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

Позволяют изменить регистр с помощью параметра ~letterCase=.

Модификатор может иметь следующие значения:

upper — ВЕРХНИЙ РЕГИСТР

lower — нижний регистр

title — Верхний Регистр Для Первой Буквы Каждого Слова

Теперь {DocumentCreateTime~format=d F Y, letterCase=lower} отобразит «25 апреля 2022» вместо «25 Апреля 2022».

Модификаторы для вывода значений из множественного поля

В CRM некоторые поля могут содержать несколько значений, например, в полях «Телефон», «Почта», «Мессенджер» можно указать несколько номеров или адресов.

С помощью параметра ~mfirst= можно управлять отображением множественных полей:

mfirst=y — выводит только первое значение

mfirst=n — выводит все значения

Например, если у нас есть множественное поле «Телефон» и нужно вывести все его значения, используем код {ContactPhone~mfirst=n}. По умолчанию значения разделяются запятой. 

Модификатор ~mseparator= позволяет выбрать разделитель: запятая (1) или перенос строки (2) — {ContactPhone~mseparator=2}. Чтобы вывести все значения из поля «Телефон» с разделением переносом строки, используйте код {ContactPhone~mfirst=n,mseparator=2}.

Если необходимо вывести определенные элементы списка, используйте параметр ~index=. 

Нумерация начинается с нуля, поэтому товар с индексом 1 — это второй товар в списке. Например, код {ProductsProductName~index=2} отобразит третий элемент списка товаров.

Модификатор ~all=y выведет все значения множественного поля "Привязка к элементам CRM".

Окончание 1:

Переход на электронный документооборот с использованием CRM-системы Битрикс24 не только упрощает управление документами, но и открывает новые горизонты для Вашего бизнеса. 

Представьте себе мир, где создание, редактирование и отправка документов занимает считанные минуты, а Ваши сотрудники могут сосредоточиться на более важных задачах.

Инвестируя в автоматизацию с Битрикс24, вы не просто оптимизируете процессы — Вы создаете конкурентное преимущество.

Начните трансформировать ваш бизнес уже сегодня и ощутите все преимущества современных технологий!

Окончание 2:

Внедрение электронного документооборота с Битрикс24 — это шаг в будущее вашего бизнеса. 

Забудьте о громоздких бумажных архивах и сложных процессах согласования. 

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

Сделайте выбор в пользу инноваций и дайте вашему бизнесу возможность расти и развиваться вместе с Битрикс24!

Коротко

- Компании переходят от использования бумажных документов к электронным, которые являются более удобными и надежными.

- Битрикс24 позволяет автоматизировать создание документов с помощью конструктора.

- Модификаторы в Битрикс24 помогают настраивать отображение данных в документах.

- Модификаторы применяются к датам, именам, адресам, денежным суммам и тексту.

- Они позволяют изменять формат, регистр и порядок данных.

- Модификаторы помогают управлять выводом множественных полей и отдельных элементов списка.

Статья создана на основании статьи: 

“Модификаторы в шаблонах документов: меняем формат вывода дат, имен и сумм”, Автор: Ксения Цвет. https://helpdesk.bitrix24.ru/open/18175702/

Дополнительные статьи: 

“Как изменить стандартный шаблон документа в СRM”. Автор: Ксения Цвет.https://helpdesk.bitrix24.ru/open/18127788/

“Шаблоны документов в CRM: как настроить, чтобы быстро отправлять счета и акты”. Автор: Ксения Цвет. https://helpdesk.bitrix24.ru/open/18089278/

“Подробнее о роботах: создание документа CRM”, автор Эдуард Узлов: https://helpdesk.bitrix24.ru/open/15535158/