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

Модификатор — это специальный код, который меняет формат поля. Например, значение поля Ф.И.О. по умолчанию выводится в именительном падеже. Чтобы CRM вывела поле в дательном падеже, к символьному коду надо добавить специальный модификатор.
Модификаторы расположены внутри символьного кода после знака тильды (~)
Модификаторы работают только с полями, у которых указан тип

Если нужно вывести в документ определенные элементы списка, используем параметр ~index=. Нумерация элементов списка начинается с нуля: 0 - первый, 1- второй, 2-третий
Например, код {ProductsProductName~index=2} выведет третий элемент из списка товаров

В Битрикс24.CRM можно создавать следующие виды документов:

Для ООО данные заполняются автоматических из налоговой при заполнении поля ИНН и БИК
Для ИП реквизиты и ИНН заполняются без адреса

В Битрикс24 есть набор стандартных шаблонов для документов: счетов, актов, коммерческих предложений.
Чтобы в шаблон автоматически подставлялись нужные реквизиты, его можно настроить.
Чтобы настроить шаблон, нужны символьные коды — это значения полей в карточке элемента CRM. У каждого поля — свой код.

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

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

• 1 — Европа
• 2 — Великобритания
• 3 — Северная Америка
• 4 — Россия (улица > страна)
• 5 — Россия (страна > улица)

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

• 1 — запятая
• 2 — без разделителя
• 3 — перевод строки

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

Изменить формат номера телефона можно с помощью модификатора ~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".