Коротко о главном

• Синтаксис: модификаторы ставятся после тильды ~ внутри фигурных скобок символьного кода поля.
  Пример: {DocumentCreateTime~d.m.Y H:i:s} {DocumentCreateTime~format=d F Y, letterCase=lower}
• Где взять коды полей: в карточке элемента CRM → Документ → Добавить новый шаблон → ⚙️ → Список полей.
• Что можно форматировать: дату и время, имя (падеж и порядок), адрес, денежные суммы, телефон, регистр текста, а также множественные поля.

---

Базовый синтаксис

{<СИМВОЛЬНЫЙ_КОД>~<модификаторы через запятую>}

• Параметры задаются как ключ=значение.
• Для даты можно использовать как «короткий» формат (~d.m.Y), так и через format=.

---

Где посмотреть список кодов полей

• В карточке CRM → Документы → Добавить шаблон → ⚙️ → Список полей.
• Внутри отображаются коды для реквизитов, контактов, компании, товаров, сумм, налогов и т.д.

---

Справочник модификаторов

1) Дата и время

Что	Ключ	Значения/формат	Пример	Результат
Формат даты	format или без ключа	d.m.Y, j F Y, Y-m-d H:i:s и др.	{DocumentCreateTime~d.m.Y H:i}	28.08.2025 15:30
Дата словами	format	d F Y	{DocumentCreateTime~format=d F Y}	28 августа 2025

---

2) Имя (ФИО): порядок и падеж

Задача	Ключ	Значения	Пример	Результат
Порядок частей ФИО	Format	#TITLE# #NAME# #LAST_NAME# #SECOND_NAME# (+ варианты с *_SHORT)	{ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#}	«Иванов Иван Иванович»
Падеж	Case	-1 именит., 0 родит., 1 дат., 2 винит., 3 творит., 4 предлог.	{ContactFormattedName~Format=#LAST_NAME# #NAME#, Case=0}	«Иванова Ивана»

---

3) Адрес

| Ключ | Значения | Пример | Результат |

| Format | 1 Европа, 2 Великобритания, 3 Северная Америка, 4 Россия (улица > страна), 5 Россия (страна > улица) | {ContactAddress~Format=5} | «Россия, Москва, ул. Ленина, д. 10» |
| Separator | 1 запятая, 2 без разделителя, 3 перенос строки | {ContactAddress~Format=5,Separator=3} | каждая часть адреса с новой строки |

---

4) Денежные суммы и налоги

Ключ	Значение	Что делает	Пример
WZ	Y/N	Показывать/убирать незначащие нули	{TotalSum~WZ=N} → 12
NS	Y	Прятать знак валюты	{TotalSum~NS=Y}
W	Y	Сумма прописью (для RUB, BYN, UAH, KZT)	{TotalSum~W=Y}
SN	Y	Выводить ставку без слова «НДС»	{TaxesTaxRate~SN=Y} → 20
WP	Y	Добавить знак процента	{TaxesTaxRate~WP=Y} → 20%

---

5) Телефон

| Ключ | Значения | Пример | Результат |

| format | E.164, International, National | {ContactPhone~format=E.164} | +79001234567 |

---

6) Регистр текста

| Ключ | Значения | Пример | Результат |

| letterCase | upper, lower, title | {DocumentCreateTime~format=d F Y, letterCase=lower} | «28 августа 2025» |

---

7) Множественные поля

| Ключ | Значение | Пример | Результат |

| mfirst | y/n | {ContactPhone~mfirst=n} | вывод всех телефонов |
| mseparator | 1 запятая, 2 перенос строки | {ContactPhone~mfirst=n,mseparator=2} | телефоны построчно |
| index | 0,1,2,... | {ProductsProductName~index=2} | название 3-го товара |
| all | y | {<Поле>~all=y} | все значения привязанных элементов |

---

Готовые сниппеты для копирования

Даты

• Дата счета в формате «ДД.ММ.ГГГГ»:
  {DocumentCreateTime~d.m.Y}
• Дата словами:
  {DocumentCreateTime~format=d F Y} → «28 августа 2025»

ФИО

• Фамилия Имя Отчество в родительном падеже:
  {ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#, Case=0}

Адрес

• Российский формат с переносами строк:
  {ContactAddress~Format=5,Separator=3}

Деньги

• Сумма без нулей и без валюты:
  {TotalSum~WZ=N,NS=Y}
• Сумма прописью:
  {TotalSum~W=Y}
• Налог «20%» без текста «НДС»:
  {TaxesTaxRate~WP=Y,SN=Y}

Телефон

• Международный формат:
  {ContactPhone~format=E.164}

Товары

• Название 3-го товара:
  {ProductsProductName~index=2}

---

Таблица модификаторов для Битрикс24

Категория	Задача	Сниппет	Пример результата
Даты	Дата «ДД.ММ.ГГГГ»	{DocumentCreateTime~d.m.Y}	28.08.2025
	Дата словами	{DocumentCreateTime~format=j F Y}	28 августа 2025
	День недели и дата	{DocumentCreateTime~format=l, d F Y}	Четверг, 28 августа 2025
	Полная дата и время	{DocumentCreateTime~Y-m-d H:i:s}	2025-08-28 15:30:00
ФИО	Фамилия Имя Отчество	{ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#}	Иванов Иван Иванович
	Фамилия + инициалы	{ContactFormattedName~Format=#LAST_NAME# #NAME_SHORT#.#SECOND_NAME_SHORT#.}	Иванов И.И.
	ФИО в родительном падеже	{ContactFormattedName~Format=#LAST_NAME# #NAME# #SECOND_NAME#, Case=0}	Иванова Ивана Ивановича
	Имя и отчество в дательном падеже	{ContactFormattedName~Format=#NAME# #SECOND_NAME#, Case=1}	Ивану Ивановичу
	Фамилия заглавными буквами	{ContactLastName~letterCase=upper}	ИВАНОВ
Адреса	Российский формат (страна → улица)	{ContactAddress~Format=5}	Россия, Москва, ул. Ленина, д. 10
	Российский формат с переносами строк	{ContactAddress~Format=5,Separator=3}	Россия ⏎ Москва ⏎ ул. Ленина, д. 10
	Европейский формат	{ContactAddress~Format=1}	Straße 1, Berlin, 12345, Deutschland
Суммы и налоги	Сумма с валютой (по умолчанию)	{TotalSum}	1200,00 ₽
	Сумма без копеек	{TotalSum~WZ=N}	1200
	Сумма без валюты	{TotalSum~NS=Y}	1200,00
	Сумма прописью	{TotalSum~W=Y}	Одна тысяча двести рублей 00 копеек
	НДС 20% без «НДС»	{TaxesTaxRate~WP=Y,SN=Y}	20%
Телефоны	Первый телефон	{ContactPhone~mfirst=y}	+7 900 123-45-67
	Все телефоны через запятую	{ContactPhone~mfirst=n,mseparator=1}	+7 900 123-45-67, +7 495 123-45-67
	Все телефоны построчно	{ContactPhone~mfirst=n,mseparator=2}	+7 900 123-45-67 ⏎ +7 495 123-45-67
	Телефон в формате E.164	{ContactPhone~format=E.164}	+79001234567
Товары	Название первого товара	{ProductsProductName~index=0}	Роза красная
	Цена второго товара без копеек	{ProductsProductPrice~index=1,WZ=N}	500
	Количество третьего товара	{ProductsProductQuantity~index=2}	15
	Все товары списком	{ProductsProductName}	Роза, Тюльпан, Хризантема
Дополнительно	Имя клиента заглавными буквами	{ContactName~letterCase=upper}	АНДРЕЙ
	Имя клиента с заглавной буквы	{ContactName~letterCase=title}	Андрей
	Должность директора в родительном падеже	{CompanyRequisiteRqDirector~Case=0}	директора Иванова Ивана Ивановича
	Юр. адрес компании с переносами строк	{CompanyAddress~Format=5,Separator=3}	Россия ⏎ Москва ⏎ ул. Ленина, д. 10

Чек-лист при настройке

1. Берите коды полей из списка в шаблоне документа.
2. Пишите модификаторы строго после ~, разделяя запятой.
3. Для дат используйте форматы FormatDate — они дают месяцы и дни недели словами.
4. Для ФИО проверяйте падеж и наличие отчества.
5. В табличной части (товары) учитывайте, что нули и формат валюты зависят от модификаторов.
6. Тестируйте шаблоны на разных сделках.