Appearance
Переменные шаблонов
Переменные позволяют подставлять данные из SNABZHENETS+ в печатные формы. Синтаксис переменной: {{path.to.value}}.
Модификатор добавляется через |: {{document.date|date}}. Значение по умолчанию задаётся так: {{document.subject|default:поставка товаров}}.
Основные группы
| Группа | Что содержит | Примеры |
|---|---|---|
| Документ | Номер, дата, сумма, валюта, тема, условия | {{document.number}}, {{document.totalAmount|money}} |
| Нумерация | Текущий формат номера шаблона | {{numbering.preview}}, {{numbering.prefix}} |
| Моя компания | Наименование и реквизиты продавца | {{seller.fullName}}, {{seller.inn}} |
| Банк | Банковские реквизиты моей компании | {{bank.bankName}}, {{bank.checkingAccount}} |
| Контрагент | Данные покупателя | {{buyer.fullName}}, {{buyer.legalAddress}} |
| Контакт контрагента | Контактное лицо покупателя | {{buyerContact.fullName}}, {{buyerContact.email}} |
| Заявка | Связанная заявка, если документ создан из неё | {{request.number}}, {{request.projectRef}} |
| Закупка/сделка | Связанная PO/закупка | {{procurement.number}}, {{procurement.responsible.email}} |
| Связанные документы | Номера КП, счёта или договора | {{related.proposalNumber}}, {{related.contractNumber}} |
| Позиции | Строки документа и табличные блоки | {{items.count}}, {{items.table}} |
| Пользователи | Создатель и ответственный | {{users.createdBy.name}}, {{users.assignedTo.email}} |
| Системные | Текущая дата и название продукта | {{system.today|date}}, {{system.productName}} |
Таблицы позиций
Для строк документа доступны готовые табличные переменные:
| Переменная | Что выводит |
|---|---|
{{items.table}} | Стандартная таблица: номер, наименование, количество, единица, цена, НДС, сумма |
{{items.table.compact}} | Компактная таблица: номер, наименование, количество, сумма |
{{items.table.withVat}} | Таблица с явным акцентом на сумму с НДС |
{{items.table.noPrices}} | Таблица без цен: подходит для договоров и приложений |
Табличную переменную лучше ставить отдельной строкой в поле Условия / текст шаблона.
Модификаторы
| Модификатор | Назначение | Пример |
|---|---|---|
date | Форматирует дату | {{document.date|date}} |
datetime | Форматирует дату и время | {{system.now|datetime}} |
money | Форматирует сумму с валютой документа | {{document.totalAmount|money}} |
number | Форматирует число | {{items.count|number}} |
uppercase | Переводит текст в верхний регистр | {{buyer.fullName|uppercase}} |
lowercase | Переводит текст в нижний регистр | {{buyer.email|lowercase}} |
initials | Сокращает ФИО до инициалов | {{buyerContact.fullName|initials}} |
default:текст | Подставляет резервный текст, если данных нет | {{document.subject|default:без темы}} |
Модификаторы можно комбинировать. Например: {{document.validUntil|date|default:не указан}}.
Пустые значения
Если документ не связан с заявкой, закупкой или контактом, соответствующие переменные будут пустыми. В предпросмотре такие поля выводятся в предупреждении, чтобы администратор мог заменить переменную или добавить default:.
Для рабочих файлов пустые значения не ломают генерацию: система оставляет место пустым и продолжает формировать документ.