Подстановки в шапке и подвале
Шесть реквизитов, которые касса подставляет в текст шапки и подвала до того, как его получит шаблон.
Произвольные тексты документов — шапка и подвал пречека, шапка отчётов — задаются в бэк-офисе, в Администрирование → Шаблоны чеков. В тексте настройки разрешены подстановки вида ${…}, и заводские значения сами на них построены.
Подставляются ровно шесть реквизитов: название и фактический адрес подразделения, название и юридический адрес юридического лица, ИНН и телефон. Имя переменной вне этого списка бэк-офис не даст сохранить.
Раскрывает подстановки касса, до того как значение попадёт в шаблон. Шаблон всегда получает готовую строку: увидеть ${…} в значении свойства невозможно, а подставить что-то своё из шаблона — тем более.
Отсюда два следствия, на которые чаще всего натыкаются.
Реквизиты уже напечатаны. Раз заводская шапка построена на подстановках, название предприятия и ИНН в ней, как правило, уже есть. Печатая рядом CafeName, CafeAddress или TaxId, легко показать читателю одно и то же дважды.
Значение приходит как текст. Встроенные шаблоны его экранируют, поэтому разметка, вписанная в настройку — скажем, тег QR-кода, — напечатается буквально, строкой. Разметка сработает, только если шаблон выводит поле без экранирования. Тогда появляется риск посерьёзнее: амперсанд или угловая скобка в обычном тексте настройки, например в названии «Ромашка & Ко», ломают весь документ, и чек не напечатается вовсе.
Свойства, которые это касается: BillHeader, BillFooter и ReportHeader.