При подготовке документов в Битрикс24 КЭДО можно использовать модификаторы. Это специальные коды, которые изменяют формат данных и способ их отображения в документе. Например, с помощью модификатора можно вывести дату в нужном формате или фамилию сотрудника в нужном падеже.

Типы модификаторов

В Битрикс24 КЭДО можно использовать несколько типов модификаторов:

• даты и времени,
• имени,
• телефона,
• адреса,
• регистра текста.

Модификаторы работают внутри символьных кодов в шаблоне документа. Чтобы применить модификатор, добавьте его к символьному коду через тильду (~). Например, в коде {Ext.Emp.Date~d.m.Y H:i:s} Ext.Emp.Date — это код поля, d.m.Y H:i:s — модификатор. Формат задается с помощью шаблона: каждая буква отвечает за часть даты или времени. Например, d — день, m — месяц, Y — год.
Символьные коды в Битрикс24 КЭДО: что это и как с ними работать

Модификаторы бывают двух типов:

• простые — например, формат даты d.m.Y — задают формат напрямую,
• с параметрами — в формате параметр=значение, например format=E.164.

Если используете несколько параметров, перечисляйте их через запятую: {...~Case=0,letterCase=upper}.

Модификаторы даты и времени. Позволяют указывать время и дату в нужном формате. Например, в трудовом договоре можно вывести дату создания документа в формате 28 марта 2026.
Список модификаторов даты и времени

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

• d.m.y — 28.03.26,
• d.m.Y — 28.03.2026,
• j, n, Y — 28, 3, 2026,
• j F, Y — 28 марта, 2026.

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

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

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

• Y-m-d H:i:s — 2026-03-28 10:24:18.

Рассмотрим на примере, как преобразовать дату документа в нужный формат. Для этого добавьте к символьному коду {Ext.Emp.Date} модификатор ~d.m.Y H:i:s. Код будет таким — {Ext.Emp.Date~d.m.Y H:i:s}. Дата создания документа будет выведена в формате 28.03.2026 10:24:18.

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

Чтобы изменить падеж, используйте параметр ~Case=:

• -1 — именительный,
• 0 — родительный,
• 1 — дательный,
• 2 — винительный,
• 3 — творительный,
• 4 — предложный.

Рассмотрим на примере, как вывести имя и фамилию в родительном падеже. К символьному коду {User.Emp.Name} {User.Emp.LastName} нужно добавить параметр:

• ~Case= — чтобы задать падеж,
• 0 — родительный падеж.

Получим такой код {User.Emp.Name~Case=0} {User.Emp.LastName~Case=0}. В документе имя будет выведено в родительном падеже, например Марьяны Колосковой.

Модификаторы телефона. Изменяют формат номера телефона. Для этого используется модификатор ~format=.

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

• E.164 — +7900xxxxxxx
• International — +7 900 xxx-xx-xx
• National — 8 (900) xxx-xx-xx

Значения форматов регистрозависимы — вводить их нужно как указано в списке.

Рассмотрим на примере, как вывести номер телефона компании в формате +7 и без пробелов. Для этого к символьному коду {Com.Rep.Phone} нужно добавить параметры:

1. ~format= — чтобы задать формат номера телефона,
2. E.164 — формат с кодом страны без пробелов.

Код будет таким {Com.Rep.Phone~format=E.164}. В документе номер телефона будет отображаться в формате +7XXXXXXXXXX без пробелов. Например, +79581425367.

Модификаторы адреса. С их помощью можно изменить формат адреса и разделитель между его частями.

Адрес состоит из нескольких полей:

• ADDRESS_1 — улица, дом, корпус, строение,
• ADDRESS_2 — квартира или офис,
• CITY — город,
• REGION — район,
• PROVINCE — область,
• POSTAL_CODE — индекс,
• COUNTRY — страна.

Чтобы задать формат адреса, используйте параметр ~Format=:

• 1 — Европа: улица, индекс, город, регион и область одной строкой, страна. Например, Friedrichstraße 123, 10117 Berlin Brandenburg, Germany.
• 2 — Великобритания: каждое поле на отдельной строке, город, регион, область и индекс — заглавными буквами. Например, 221B Baker Street, LONDON, NW1 6XE, United Kingdom.
• 3 — Северная Америка: улица, город, регион, область и индекс одной строкой, страна — заглавными буквами. Например, 1600 Pennsylvania Avenue, Washington DC 20500, UNITED STATES.
• 4 — Россия: улица, город, регион, страна, индекс последним. Например, ул. Генерала Толстикова 23, Калининград, Калининградская обл., Россия, 235869.
• 5 — Россия: индекс, страна, область, регион, город, улица. Например, 235869, Россия, Калининградская обл., Калининград, ул. Генерала Толстикова 23.
• 6 — Узбекистан — аналогичен формату 5 Россия.

Чтобы задать разделитель между частями адреса, используйте параметр ~Separator=:

• 1 — запятая,
• 2 — перенос строки (\n),
• 3 — HTML-перенос строки <br />.

Рассмотрим на примере, как вывести фактический адрес компании в формате «страна > улица» и разделить его на строки. Для этого к символьному коду {Com.Rep.AddrPrim} нужно добавить параметры:

1. ~Format= — чтобы задать формат адреса,
2. 5 — формат «Россия (страна > улица)»,
3. ~Separator= — чтобы задать разделитель,
4. 3 — перенос строки.

Получим такой код {Com.Rep.AddrPrim~Format=5,Separator=3}. В документе каждая часть адреса отобразится с новой строки. Например,

235869
Россия
Калининград
улица Генерала Толстикова, 23

Модификаторы регистра текста. С их помощью можно изменить регистр текста в документе. Например, в заголовке дата может быть написана строчными буквами — 25 апреля 2026, а не 25 Апреля 2026.

Чтобы задать регистр, используйте параметр ~letterCase=.

Доступные значения модификатора:

• upper — ВЕРХНИЙ РЕГИСТР,
• lower — нижний регистр,
• title — Первая Буква Каждого Слова С Заглавной.

Рассмотрим на примере, как вывести фамилию сотрудника заглавными буквами. Для этого к символьному коду {User.Emp.LastName} нужно добавить параметры:

1. ~letterCase= — чтобы задать регистр,
2. upper — модификатор регистра текста.

Код будет таким {User.Emp.LastName~letterCase=upper}. В документе фамилия отобразится заглавными буквами. Например, КОЛОСКОВА вместо Колоскова.

Как вывести одно или все значения из поля

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

С помощью модификаторов можно выбрать, что вывести в документ: только одно значение или сразу все.

Вывести первое значение из списка. Для этого используйте параметр ~mfirst=y.

Например, чтобы вывести из нескольких номеров телефонов сотрудника только первый, используйте код {User.Emp.Str1731454357238~mfirst=y,mseparator=2}.

В документе будет выведен первый номер из списка — +71241258963.

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

• 0 — первый элемент,
• 1 — второй,
• 2 — третий.

Например, чтобы вывести первое значение из поля Количество сотрудников, используйте код {Com.Rep.Employees~index=0}. В документе отобразится первый вариант из списка — например, 1–5.

Вывести все значения — используйте параметр ~all=y. Например, код {User.Emp.Str1731454357238~all=y} выведет все телефоны сотрудника.

В каждом Битрикс24 могут быть свои коды полей. Актуальные коды смотрите в слайдере с символьными кодами в Битрикс24 КЭДО.
Символьные коды в Битрикс24 КЭДО: что это и как с ними работать

Рекомендуем прочитать:

• Комплекты документов в Битрикс24 КЭДО: как создать и отправить
• Как создать шаблон документов в Битрикс24 КЭДО