Переменные документов
Основные ключи для DOCX шаблонов договоров, путёвок и сопутствующих документов.
Переменные вставляются в DOCX в двойных фигурных скобках, например {{parent_full_name}}. Они работают в шаблонах договоров, путёвок и сопутствующих документов. Общий справочник находится в Настройки → Документы → Шаблоны документов, в раскрывающемся блоке Как подготовить шаблон Word. В нём есть поиск, примеры, копирование и фильтр Тип документа. У каждой переменной отмечено, где она заполняется.
Родитель
parent_full_name, parent_phone, parent_email, parent_birth_date и переменные паспортных данных и адреса.
parent_relationship — кем представитель приходится ребёнку: Мать, Отец, Усыновитель, Опекун или Попечитель. Для роли Иное подставляется введённое уточнение, например Бабушка. Как указать роль и уточнение.
Для строки в DOCX используйте Представитель ребёнка: {{parent_relationship}}. Значение берётся из связи родителя заказа с конкретным ребёнком. Если такой связи нет, поле остаётся пустым. В льготных путёвках связь с профилем родителя не хранится, поэтому переменная остаётся пустой, в том числе в предпросмотре.
Ребёнок
child_full_name, child_birth_date, child_document_type, серия и номер документа.
| Переменная | Значение |
|---|---|
child_document_issued_date | Дата выдачи документа ребёнка в формате ДД.ММ.ГГГГ, например 01.10.2016 |
child_document_issued_by | Кем выдан документ ребёнка, например Отдел ЗАГС |
Для строки в DOCX используйте Выдан {{child_document_issued_date}}, {{child_document_issued_by}}. Данные берутся из карточки ребёнка; если значение не заполнено, соответствующая переменная остаётся пустой. Для свидетельства о рождении дату выдачи и выдавший орган нужно заполнить до оформления нового заказа. В льготных путёвках эти два поля не хранятся и остаются пустыми, в том числе в предпросмотре.
Программа
Тип программы доступен в шаблонах договоров, путёвок, ваучеров и сопутствующих документов:
| Переменная | Значение |
|---|---|
program_type | camp для лагеря, sports_camp для спортивных сборов |
program_type_display | Название типа программы |
document_title | Заголовок путёвки или ваучера |
Например, заголовок своего бланка можно задать строкой {{document_title}} № {{voucher_number}}. Переменная номера доступна в бланках путёвок и ваучеров. Статичный текст Word-файла система не меняет: проверьте его соответствие программе.
Название, даты и длительность
session_name, session_start_date, session_end_date, session_days, session_days_text, session_price.
session_days — количество дней смены, включая день заезда и день выезда. Например, для смены с 1 по 21 июля подставится 21, а для смены в один день — 1. Переменная доступна в договорах, обычных и льготных путёвках, сопутствующих документах и документах комплекта ПЭП.
session_days_text — та же длительность с правильной формой слова: 1 день, 2 дня, 5 дней, 11 дней, 21 день, 22 дня, 25 дней. Доступна в тех же документах; в предпросмотре показан пример 21 день. Числовая переменная session_days по-прежнему подставляет только число.
Для строки со стоимостью вставьте в DOCX: Стоимость одной путёвки на {{ session_days_text }}. Слово «день» уже входит в значение переменной — дописывать «дней» после неё не нужно.
Фактическое пребывание
actual_days — количество календарных дней, фактически проведённых в лагере по отметкам заезда и отъезда. Дни заезда и отъезда включаются, полные дни временного отсутствия исключаются. Расчёт идёт в часовом поясе лагеря; до заезда подставляется 0, без отметки отъезда — число дней по сегодня, максимум до конца смены.
actual_arrival_date и actual_departure_date — отмеченные даты заезда и окончательного отъезда в формате дд.мм.гггг. До соответствующей отметки поле пустое. Эти переменные доступны в путёвках, льготных путёвках и сопутствующих документах. В сопутствующем документе на заказ с несколькими детьми значения пустые — используйте шаблон Для каждого ребёнка.
Для количества дней вставьте {{actual_days}}. Плановые даты и {{session_days}} остаются отдельными переменными.
Лагерь
Данные берутся из настроек лагеря и в готовых документах, и в PDF-предпросмотре. Пустые поля не заменяются вымышленными реквизитами.
| Переменная | Значение |
|---|---|
camp_name | Название лагеря |
camp_legal_name | Юридическое наименование организации, выдавшей документ |
camp_director_name | Полное ФИО руководителя |
camp_director_short_name | Фамилия и инициалы руководителя, например Петров П. П. |
camp_inn | ИНН организации |
camp_legal_address | Юридический адрес |
camp_contact_phone | Контактный телефон организации |
camp_contact_email | Email организации |
camp_bank_name | Название банка |
camp_bik | БИК банка |
camp_checking_account | Расчётный счёт |
camp_correspondent_account | Корреспондентский счёт |
Для сокращённого имени укажите в настройках ФИО руководителя в порядке «Фамилия Имя Отчество». Место для подписи оставьте в самом Word-шаблоне.
Заказ и договор
contract_number, order_number, order_id, order_date, base_price, total_price, total_price_words, price, current_date.
В сопутствующем документе Для каждого ребёнка contract_number подставляет номер сформированного договора по соответствующей путёвке. Если для этой путёвки индивидуальный договор не формируется, значение остаётся пустым. Для лагеря с публичной офертой включите Генерировать дополнительно договоры и активируйте DOCX-шаблон договора. При включённой дополнительной генерации недостающий договор создаётся перед сопутствующим документом, в том числе при повторном формировании.
При подготовке комплекта ПЭП номер закрепляется за путёвкой, если для неё опубликован документ категории Договор. Общий договор заказа получает номер только при одной позиции в заказе. Договор и приложения Для каждого ребёнка используют этот номер; при повторной подготовке он сохраняется. Если договора в комплекте ПЭП нет, новый номер не присваивается. Уже подписанный экземпляр, в том числе старый договор без номера, не переписывается.
order_number — отдельный номер заказа. current_date — дата формирования документа; при повторном формировании она обновляется.
Плательщик и направившая организация
Эти переменные доступны в договорах, сопутствующих документах и путёвках. Они нужны, чтобы один шаблон договора подходил и для обычных заказов, и для заказов организаций.
| Переменная | Значение |
|---|---|
payer_name | Кто оплачивает: ФИО родителя или полное название организации |
organization_name | Организация, направившая ребёнка; в обычном заказе пусто |
organization_inn | ИНН организации |
organization_kpp | КПП организации |
organization_address | Юридический адрес организации |
organization_contract_number | Номер договора лагеря с организацией |
organization_contract_date | Дата договора с организацией |
Например, в разделе об оплате: Оплату производит {{payer_name}}. В льготных путёвках эти переменные пустые.
Путёвки
Дополнительно в своих шаблонах путёвок доступны:
| Переменная | Значение |
|---|---|
voucher_number | Номер путёвки |
voucher_issue_date | Дата выдачи |
voucher_issue_day | День даты выдачи двумя цифрами, например 01 |
voucher_issue_month | Месяц даты выдачи словами, например октября |
voucher_issue_year | Год даты выдачи, например 2026 |
voucher_issue_month_year | Месяц даты выдачи словами и год, например октября 2026 |
session_start_day | День начала смены двумя цифрами, например 01 |
session_start_month | Месяц начала смены словами, например октября |
session_start_year | Год начала смены, например 2026 |
session_start_month_year | Месяц начала смены словами и год, например октября 2026 |
session_end_day | День окончания смены двумя цифрами, например 21 |
session_end_month | Месяц окончания смены словами, например октября |
session_end_year | Год окончания смены, например 2026 |
session_end_month_year | Месяц окончания смены словами и год, например октября 2026 |
voucher_type | Обычная или льготная |
voucher_price | Стоимость с копейками, например 45 000.50 |
voucher_price_words | Стоимость прописью, включая копейки |
vat_text | Информация об НДС |
transfer_to_address | Адрес отправления в лагерь |
transfer_to_departure | Дата и время отправления в лагерь по Москве |
transfer_to_price | Стоимость трансфера в лагерь |
transfer_from_address | Адрес обратного трансфера |
transfer_from_departure | Дата и время обратного отправления по Москве |
transfer_from_price | Стоимость обратного трансфера |
Для даты выдачи с месяцем словами вставьте в шаблон обычной или льготной путёвки: «{{voucher_issue_day}}» {{voucher_issue_month_year}} г.. Например, для 1 октября 2026 года получится «01» октября 2026 г..
Если день, месяц и год размещены в отдельных ячейках бланка, используйте {{voucher_issue_day}}, {{voucher_issue_month}} и {{voucher_issue_year}}. При перегенерации путёвки дата первоначальной выдачи и все её части сохраняются.
Для даты начала смены в обычной или льготной путёвке используйте «{{session_start_day}}» {{session_start_month}} {{session_start_year}} г. или «{{session_start_day}}» {{session_start_month_year}} г.. Значения берутся из даты начала выбранной смены; при её изменении перегенерированный PDF получит новую дату начала. Для формата ДД.ММ.ГГГГ по-прежнему доступна {{session_start_date}}.
Для даты в обратном талоне используйте последний день смены: «{{session_end_day}}» {{session_end_month}} {{session_end_year}} г.. Можно объединить месяц и год: «{{session_end_day}}» {{session_end_month_year}} г.. Значения берутся из даты окончания выбранной смены; при её изменении перегенерированный PDF получит новую дату окончания. Для формата ДД.ММ.ГГГГ по-прежнему доступна {{session_end_date}}.
Полный список с примерами и копированием находится в Настройки → Документы → Шаблоны документов → Справочник переменных. При загрузке неизвестные имена переменных вызывают ошибку.
У льготных путёвок нет заказа, договора, email и даты рождения родителя, а также трансферов: соответствующие переменные остаются пустыми. Другие незаполненные данные тоже остаются пустыми. Общие переменные на весь заказ из следующего раздела в шаблонах путёвок недоступны.
Общие документы на заказ
Для сопутствующего документа с режимом Один на заказ дополнительно доступны:
children_count— количество детей в заказе;children_full_names— ФИО детей с новой строки;sessions_names— названия смен через запятую;order_base_price— стоимость заказа без скидок;order_total_price— итоговая стоимость заказа;order_total_price_words— итоговая стоимость прописью;document_name— название шаблона документа.
В документе Для каждого ребёнка переменные ребёнка, смены и цены заполняются по соответствующей путёвке. В режиме Один на заказ contract_number заполняется только при одной позиции в заказе и наличии её договора. При нескольких позициях поле остаётся пустым: у них отдельные договоры.
В общем документе заказа parent_relationship, child_document_issued_date и child_document_issued_by заполняются, если все позиции относятся к одному ребёнку, в том числе на нескольких сменах. При нескольких разных детях эти поля остаются пустыми; используйте документы Для каждого ребёнка, чтобы указать роль представителя и реквизиты документа отдельно для каждого.
В режиме Один на заказ session_days и session_days_text заполняются, если все позиции относятся к одной смене. Если смены разные, оба поля остаются пустыми; длительность каждой смены можно указать в документах Для каждого ребёнка.
Если общий документ объединяет лагерную смену и спортивные сборы, program_type остаётся пустым, program_type_display содержит Разные программы, а document_title — Документ. Для отдельного заголовка путёвки или ваучера используйте документ Для каждого ребёнка.
Правила шаблона
- Не меняйте латинское имя внутри фигурных скобок.
- Не разбивайте одну переменную разным форматированием Word.
- Всегда проверяйте PDF-предпросмотр с реквизитами лагеря и демонстрационными данными получателя.
- Сохраняйте файл в DOCX, не в старом DOC или PDF.
- После новой версии активируйте нужный шаблон.