Переменные шаблонов договоров и дополнительных соглашений

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Переменные шаблонов договоров и дополнительных соглашений

В этом справочнике собраны обозначения для Word-шаблонов договоров и дополнительных соглашений. Обычная переменная подставляет значение, парные маркеры выбирают условный текст, а маркер строки помогает построить таблицу объектов. Для актов и КП действуют другие наборы имён.

В этой статье

Выберите нужную часть шаблона

  • Номер, даты или стороны. Найдите соответствующую таблицу и скопируйте полное обозначение со знаком доллара и скобками.
  • Условия предоплаты или постоплаты. Используйте парный блок и проверьте оба маркера.
  • Список объектов. Выберите раздел нужного типа договора: лаборатория, обслуживание или капитальный ремонт. Одинаковое короткое имя в разных маршрутах может означать разные данные.
  • Дополнительное соглашение. Различайте значения исходного договора и самого соглашения.
Первая проверка на коротком примере

Запись Договор №${CNum} на учебных данных может превратиться в «Договор №Д-12». Слово «Договор №» остаётся обычным текстом, а номер подставляется из карточки.

У соглашения номер выводит ${AgNum}. Если вместо него вставить ${CNum}, получится номер основного договора, хотя переменная технически заменится успешно. Поэтому проверяйте смысл результата, а не только отсутствие скобок.

Ниже приведён полный каталог с условиями, особенностями расчёта и ссылками на шаблоны. Для поиска конкретного имени можно также использовать поиск страницы браузера: Ctrl+F на Windows или Cmd+F на Mac.

Готовый шаблон и правила записи

Скачайте готовый шаблон договора периодического технического освидетельствования в Word. Для загрузки может потребоваться вход в личный кабинет на сайте TesLab. Перед изменением сохраните исходную копию файла.

Редактируйте файл в Microsoft Word и сохраняйте его как .docx. Переменная пишется целиком, со знаком доллара и фигурными скобками: ${CNum}. Регистр, дефис и подчёркивание являются частью имени. Например, ${rq-price} и ${rq_price} относятся к разным маршрутам.

В справочнике ниже каждое полное обозначение можно перенести в шаблон. Обычная переменная заменяется значением. Парные маркеры ограничивают условный фрагмент. Переменные табличной строки размножаются для каждого объекта, когда в этой строке есть предусмотренный маркер ${rq}. Не дописывайте в исходной форме индексы #1 или #2: их создаёт генератор.

Порядок выбора шаблона, заявок и дополнительных значений описан в статье «Договор по шаблону». В выбранном договоре проверьте тип работ, свою организацию, подписанта заказчика, банковский счёт, даты и оплату. Наличие переменной в файле не создаёт отсутствующие исходные сведения.

Обычные поля можно размещать в основном тексте, верхнем и нижнем колонтитулах, в том числе повторять реквизиты. В этих частях также обрабатываются условные блоки и склонения. Повторяемые строки объектов оформляйте в таблице основного текста: внутри строки с ${rq} используйте только поля строки соответствующего вида договора. Общие поля вроде ${CNum}, итоговые суммы и конструкции PLURAL размещайте вне размножаемой строки. Внутри неё они не поддерживаются.

Номер и даты договора

ПеременнаяЧто подставляется
${CNum}Номер договора.
${CSign}Дата подписания договора цифрами: ДД.ММ.ГГГГ.
${CSign_txt}Та же дата словами, например «15 января 2026».
${CStart}Дата начала действия договора цифрами.
${CStart_txt}Дата начала действия словами.
${CEnd}Дата окончания действия договора цифрами.
${CEnd_txt}Дата окончания действия словами.
${basis}Текст основания полномочий представителя заказчика из договора: например, «Устава» или реквизиты доверенности.

Дополнительное соглашение

Следующие значения заполняются при формировании документа по дополнительному соглашению. Они не заменяют номер и даты исходного договора: для них продолжают действовать обозначения C....

ПеременнаяЧто подставляется
${AgNum}Номер дополнительного соглашения.
${AgSign}Дата подписания соглашения цифрами.
${AgSign_txt}Дата подписания соглашения словами.
${AgStart}Дата начала действия соглашения цифрами.
${AgStart_txt}Дата начала действия соглашения словами.
${AgInform}Информация об изменениях, сохранённая в дополнительном соглашении.

Реквизиты своей организации и заказчика

В левой колонке указана своя организация договора, в средней заказчик. Это разные стороны, даже когда их карточки находятся в одном справочнике контрагентов. Свою организацию программа берёт из договора. Её реквизиты с историей выбираются на дату подписания формируемого договора, а при подготовке соглашения на дату подписания этого соглашения. Реквизиты заказчика с историей выбираются на дату подписания исходного договора, в том числе при подготовке соглашения. Банковский счёт и представитель выбираются отдельно, по правилам ниже.

Своя организацияЗаказчикЧто подставляется
${OurFullName}${ClientFullName}Полное наименование организации.
${OurName}${ClientName}Сокращённое наименование.
${OurHerein}${ClientHerein}Форма «именуемое», «именуемый» или «именуемая», согласованная с названием.
${OurAddress}${ClientAddress}Юридический адрес из сохранённого поля адреса. Индекс и офис выводятся, если уже входят в этот текст; отдельно они не добавляются.
${OurFAddress}${ClientFAddress}Фактический адрес из реквизитов.
${OurINN}${ClientINN}ИНН.
${OurKPP}${ClientKPP}КПП.
${OurOGRN}${ClientOGRN}ОГРН.
${OurOKPO}${ClientOKPO}ОКПО.
${OurOKATO}${ClientOKATO}ОКАТО.
${OurOKTMO}${ClientOKTMO}ОКТМО.
${OurOKOGU}${ClientOKOGU}ОКОГУ.
${OurOKFS}${ClientOKFS}ОКФС.
${OurOKVED}${ClientOKVED}ОКВЭД.
${OurPhone}${ClientPhone}Телефон. Значение уже содержит подпись «Телефон:» и перевод строки, если телефон заполнен.
${OurEMail}${ClientEMail}Электронная почта. Значение уже содержит подпись «Email:» и перевод строки, если адрес заполнен.
${OurBank}${ClientBank}Название банка.
${OurBankCity}${ClientBankCity}Город банка.
${OurBankBIK}${ClientBankBIK}БИК банка.
${OurBankKS}${ClientBankKS}Корреспондентский счёт.
${OurBankRV}${ClientBankRV}Расчётный счёт с подписью «Р/с:». При казначейских реквизитах выводится блок лицевого и казначейского счетов.
${OurFunc}${ClientFunc}Должность представителя в исходной форме.
${OurFIO}${ClientFIO}Фамилия представителя и инициалы.
${OurCeoFIO}${ClientCeoFIO}Полное ФИО представителя в родительном падеже из его карточки.
${OurCeoFunc}${ClientCeoFunc}Должность представителя в родительном падеже, с начальной строчной буквой.
${OurCurrent}${ClientCurrent}Согласованное «действующего» или «действующей».

Не добавляйте к телефону, email или расчётному счёту повторную подпись, если она уже входит в значение. ${ClientBankRV} не является переменной ClientBankRC из генератора акта.

У заказчика может быть руководитель в виде управляющей организации. При отсутствии подписанта-физического лица предусмотренная ветвь выводит название управляющей организации вместо ФИО, а ${ClientCurrent} принимает значение «действующей». В этом случае проверьте всю фразу «в лице ... действующей на основании ...», а не только отдельное поле.

Почему в соглашении могут отличаться даты реквизитов сторон

Допустим, договор подписан 15 января, а дополнительное соглашение 10 сентября. В сентябрьском соглашении поля своей стороны Our... берут исторические реквизиты на 10 сентября, а поля заказчика Client... берут их на 15 января. Если после января у заказчика изменилось название или адрес, проверяйте это отдельно: дата соглашения сама по себе не переключает его реквизиты на сентябрь.

Явно выбранный в договоре банковский счёт заказчика имеет приоритет и не переключается по дате документа. Если счёт не выбран, подходящая запись банка выбирается по статусу и дате подписания формируемого документа. Для своей стороны банк также выбирается отдельно на эту дату. ФИО и должность заказчика читаются из текущей карточки выбранного в договоре представителя, без восстановления её состояния на дату договора. Если вместо физического лица используется управляющая организация, её исторические сведения выбираются на текущую дату. Эти источники сверяйте по отдельности.

Количество и склонение

ПеременнаяЧто подставляется
${quan}Количество для выбранного маршрута формирования. Если маршрут не рассчитал количество, используется значение из формы.
${quan_srt}Количество словами.
${quan_srt_rp}Количество словами в родительном падеже.
${quan_end}Окончание «а» или «ов», выбранное по количеству для предусмотренной фразы.
${quan_elevator}«лифт», «лифта» или «лифтов».
${quan_elevators}«лифта» или «лифтов» для соответствующего оборота.
${quan_spent}«отработавшего» или «отработавших».

Для собственного слова используйте ${PLURAL(лифт|лифта|лифтов)}: три формы выбираются по количеству. Конструкция ${PLURAL2(лифт|лифты)} выбирает второй вариант, когда количество больше одного; в остальных случаях первый. Вместо слова «лифт» можно подставить согласованные формы нужного слова. Проверяйте предложение целиком для 1, 2, 5 и 21 объекта.

Цена, общая сумма и НДС

ПеременнаяЧто подставляется
${price}Цена единицы цифрами, с двумя знаками после запятой. Для выбранных лабораторных объектов с разными ценами это средняя цена, рассчитанная из их цен.
${price_txt}Цена единицы прописью.
${itog}Общая стоимость цифрами, например 1 000,00.
${itog_txt}Общая стоимость прописью.
${rq-itog}Итоговая стоимость всех объектов, то же итоговое значение в предусмотренной табличной форме.
${itog12}Двенадцатикратная итоговая стоимость. Имеет смысл для подходящего месячного сценария, а не как универсальная годовая цена любого договора.
${rq-nds}Сумма НДС по рассчитанным объектам.
${rq-nds12}Двенадцатикратная сумма НДС.
${VatText}«в т.ч. НДС X%» либо «НДС не облагается».
${Vat}Ставка с процентом, например «20%», либо пустое значение без НДС.
${with_nds_txt}«с НДС X%» либо пустое значение без НДС.

Суммы зависят от режима НДС договора, ставки своей организации, выбранных объектов и цены формы. В лабораторной таблице при НДС сверх цены налог добавляется к цене строки, при включённом НДС выделяется из неё. Не рассчитывайте налог ещё раз постоянным текстом Word. Сумма пустого рамочного договора может получаться из количества и цены формы, поэтому итог без таблицы не доказывает, что конкретные объекты уже перечислены.

Условные фрагменты оплаты

Парные маркерыКогда остаётся текст между ними
${PRE_PAY_FULL} ... ${/PRE_PAY_FULL}Полная предоплата: сохранён режим полной предоплаты либо процентный аванс 100%.
${PRE_PAY} ... ${/PRE_PAY}Частичная предоплата: режим аванса, который не попал в ветвь 100%.
${POST_PAY} ... ${/POST_PAY}Постоплата.
${START_PRE_PAY} ... ${/START_PRE_PAY}Фрагмент для варианта с предоплатой, включая полную.
${START_POST_PAY} ... ${/START_POST_PAY}Фрагмент для постоплаты.

Открывающий и закрывающий маркеры ограничивают только относящийся к варианту текст. Пример: ${PRE_PAY}Заказчик перечисляет аванс ${PrePay_Proc}% в сумме ${PrePay_Sum} руб.${/PRE_PAY}. При другой схеме этот фрагмент удаляется. Не оставляйте взаимоисключающие условия ещё и постоянным текстом за пределами блоков.

ПеременнаяЧто подставляется
${PrePay_Proc}Процент частичной предоплаты.
${PrePay_Sum}Сумма частичной предоплаты цифрами.
${PrePay_Sum_txt}Сумма частичной предоплаты прописью.
${AfterPay_Proc}Процент остатка: 100 минус процент предоплаты.
${AfterPay_Sum}Остаток к оплате цифрами.
${AfterPay_Sum_txt}Остаток к оплате прописью.

Эти шесть значений заполняются в ветви PRE_PAY. Проценты выводятся числом без знака %, например 7.7, денежные суммы с двумя знаками после запятой. При фиксированном авансе сумма берётся как сумма, а процент вычисляется от итога: при стоимости 1 000 руб. и авансе 77 руб. получатся PrePay_Sum = 77,00, PrePay_Proc = 7.7 и AfterPay_Sum = 923,00. Фиксированный аванс, равный всей стоимости, всё ещё использует блок PRE_PAY; сам вычисленный процент 100 не включает PRE_PAY_FULL. Аванс и срок, изменённые в форме формирования, применяются к этому документу и не меняют условия в карточке договора.

Срок выполнения работ

ПеременнаяЧто подставляется
${WorkTime}При сроке в днях содержит число дней; при контрольной дате содержит дату в формате ГГГГ-ММ-ДД, например 2026-12-20.
${WorkTime_txt}Число рабочих или календарных дней прописью. При контрольной дате не заполняется.
${WorkTime_days}Согласованная форма «рабочий день / рабочих дня / рабочих дней» либо «календарный день / календарных дня / календарных дней». При контрольной дате не заполняется.

Пример для срока в днях: «Работы выполняются в течение ${WorkTime} ${WorkTime_days}». Для контрольной даты используйте подходящую фразу с ${WorkTime}, а не оставляйте рядом слово «дней».

Таблица объектов лабораторного договора

Эти обозначения относятся к договору на оценку лифтов. В одной повторяемой строке таблицы Word разместите ${rq} и остальные нужные поля. При выбранных заявках формируется строка на каждый включённый объект. Отбор только выполненных объектов учитывает утверждённые протоколы и исключает отозванные. Без выбранных заявок рамочный документ не получает такой список.

ПеременнаяЧто подставляется
${LabRegNum}Регистрационный номер лаборатории в реестре ФСА из лабораторных настроек.
${rq}Порядковый номер объекта в сформированной таблице; маркер повторения строки.
${rq-address}Адрес установки с подъездом, если он заполнен.
${rq-zn}Регистрационный/заводской идентификационный номер объекта.
${rq-mnt}Месяц и год планируемой оценки.
${rq-fab}Завод-изготовитель.
${rq-tp}Назначение лифта.
${rqg}Грузоподъёмность, кг.
${rqs}Скорость движения, м/с.
${rqo}Число остановок.
${rqy}Год ввода.
${rq-price}Цена работ по объекту с учётом предусмотренного режима НДС; формат с двумя знаками после запятой.

Обслуживание лифтов: строки и итоги

Следующий набор относится к договору обслуживания. Он отличается от лабораторного даже при совпадении коротких имён. Например, ${rqs} здесь обозначает остановки, а не скорость. Для обычного договора список берётся из включённых в договор лифтов; для соглашения учитываются добавления и исключения, действующие к дате соглашения.

ПеременнаяЧто подставляется
${rq}Порядковый номер и маркер повторения строки обслуживания.
${rqz}Заводской номер; при его отсутствии регистрационный номер.
${rqs}Число остановок; при пустом значении используется этажность, если она заполнена.
${rqg}Грузоподъёмность.
${rq_address_short}Короткое представление адреса.
${rq_address_full}Полное представление адреса.
${rq_front}Подъезд в формате «, п.X» либо пустое значение.
${rq_price}Цена строки из цены формы, когда она задана.
${rq_price12}Цена строки за 12 месяцев: цена формы, умноженная на 12.
${sPrice}Сумма цен строк обслуживания.
${sPrice_txt}Та же сумма прописью.
${sPrice12}Сумма двенадцатикратных цен строк.
${sPrice12_txt}Та же сумма за 12 месяцев прописью.

При наличии списка объектов нулевая цена выводится как 0,00 в полях rq_price и rq_price12, а нулевые итоги заполняются и цифрами, и прописью. Отсутствие объектов является отдельным случаем: заполнение цены не создаёт строки. Итоги sPrice... не являются синонимом общих налоговых итогов во всех типах договоров. Если шаблон обслуживает другой период, проверьте, подходит ли умножение на 12.

Капитальный ремонт: строки и стоимость

В договоре капитального ремонта таблица берётся из выбранного предложения на ремонт. Одна строка соответствует объекту с набором работ или устанавливаемых позиций.

ПеременнаяЧто подставляется
${rq}Порядковый номер и маркер повторения строки ремонта.
${rqz}Номер объекта из предложения на ремонт.
${rq_address}Адрес из предложения.
${rq_price}Сумма по позициям объекта: цена позиции, умноженная на её количество, с форматированием.
${rq_working}Перечень работ и устанавливаемых позиций, сформированный по составу предложения.
${sPrice}Сумма без НДС, рассчитанная по ремонтным позициям с учётом режима предложения. Не путать с одноимённым итогом обслуживания.

Переменные ${rq_address_short}, ${rq_address_full} и ${rq_price12} не становятся ремонтными полями только от переноса в такую форму. Для каждого маршрута используйте его таблицу.

Осмотры в обслуживании и капитальном ремонте

Парные маркерыУсловие
${hasInspection} ... ${/hasInspection}Сохраняет текст, когда в договоре включены периодические осмотры.
${noInspection} ... ${/noInspection}Сохраняет текст, когда периодические осмотры не включены.

Оба блока обрабатываются в договорах обслуживания и капитального ремонта по сохранённому признаку включения осмотров. Они не являются общими переключателями для лабораторного договора. Например, внутри первого блока разместите условие о включённых осмотрах, внутри второго согласованную формулировку об их отсутствии.

Дополнительные поля договора и соглашения

Договор / сохранённые данные договораТекущие данные соглашенияНазначение
${Dop1}${ADop1}Дополнительное поле 1.
${Dop2}${ADop2}Дополнительное поле 2.
${Dop3}${ADop3}Дополнительное поле 3.
${Dop4}${ADop4}Дополнительное поле 4.
${Dop5}${ADop5}Дополнительное поле 5.
${Dop6}${ADop6}Дополнительное поле 6.

При формировании договора ${Dop1}–${Dop6} получают значения дополнительных полей формы. При формировании соглашения эти обозначения читают сохранённые дополнительные данные исходного договора, а ${ADop1}–${ADop6} получают вводимые данные соглашения. Отдельная настройка сохранения дополнительных значений записывает их к договору либо соглашению; разовый ввод без такого сохранения не обновляет карточку автоматически.

Дополнительные переменные договора: токен Dop1, поле значения, сохранение к договору и формирование
Дополнительные переменные договора.
  1. Нажмите на обозначение ${Dop1}, чтобы скопировать его для вставки в DOCX.
  2. Введите текст в поле «Доп. переменная 1».
  3. Включите «Сохранить доп. переменные для договора», если их нужно записать к договору для следующего формирования и использования в соглашениях.
  4. Нажмите «Сформировать». Предварительно проверьте шаблон и остальные условия документа.
Дополнительные переменные соглашения: токен ADop1, поле значения, сохранение к соглашению и формирование
Дополнительные переменные соглашения.
  1. В форме соглашения копируются обозначения ${ADop1} и далее до ${ADop6}.
  2. Введите текст изменения в соответствующее дополнительное поле соглашения.
  3. Включите «Сохранить доп. переменные для соглашения», если их нужно записать к этому соглашению. Переключатель «Запомнить доп. переменные для следующих документов» сохраняет отдельный набор для последующего заполнения формы.
  4. Нажмите «Сформировать» и проверьте в результате как значения соглашения ADop..., так и сохранённые значения договора Dop....

Обозначения прежних шаблонов

Ниже перечислены поддерживаемые прежние имена. Они нужны для проверки уже имеющихся файлов. Для нового шаблона выбирайте основные имена, но не удаляйте старое поле вслепую до проверки результата.

Прежнее имяОсновное имяСодержание
${SignDateS}${CSign}Дата подписания цифрами.
${SignDateF}${CSign_txt}Дата подписания словами.
${startDate}${CStart}Дата начала цифрами.
${startDate_txt}${CStart_txt}Дата начала словами; в прежнем формате день заключён в кавычки.
${endDate}${CEnd}Дата окончания цифрами.
${endDate_txt}${CEnd_txt}Дата окончания словами; в прежнем формате день заключён в кавычки.
${DateAgreeEnd}${CEnd}Дата окончания договора. Это не отдельная дата окончания соглашения.
${ShortOurName}${OurName}Сокращённое название своей организации.
${FullOurName}${OurFullName}Полное название своей организации.
${ShortClientName}${ClientName}Сокращённое название заказчика.
${FullClientName}${ClientFullName}Полное название заказчика.
${current}${ClientCurrent}Согласованное «действующего / действующей» для заказчика.

Старые обозначения склонений со двоеточиями

В прежних DOCX можно встретить другой способ записи склонений. Ниже приведены полные примеры, чтобы вы могли найти их в своём файле и отличить от обычных переменных.

Пример старой записиДля чего её использовали
${quan:лифт:лифта:лифтов}Выбор формы слова по количеству объектов. Слова после двоеточий могли быть другими.
${WorkTime:день:дня:дней}Выбор формы слова в выражении срока. Слова после двоеточий могли быть другими.

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

Для нового текста о количестве используйте ${quan} и ${PLURAL(лифт|лифта|лифтов)}. Например: Оценка ${quan} ${PLURAL(лифт|лифта|лифтов)}. Для срока используйте ${WorkTime} и ${WorkTime_days} по разделу «Срок выполнения работ». Конструкция ${PLURAL2(лифт|лифты)} тоже поддерживается, но выбирает только один из двух вариантов по правилу, описанному в разделе «Количество и склонение».

Перед заменой старой записи сохраните исходный файл. После изменения проверьте текст целиком для одного, двух и пяти объектов, а срок отдельно для рабочих дней, календарных дней и контрольной даты.

Проверка результата на учебном договоре

  1. Создайте копию шаблона и вставьте полные обозначения из нужного раздела.
  2. Сформируйте договор на два известных объекта с проверенными ценами. Сверьте стороны, представителя, банк, даты и каждую строку.
  3. Отдельно проверьте свою схему НДС, частичную/полную предоплату либо постоплату. Убедитесь, что лишний условный текст удалён.
  4. Сформируйте соглашение и сравните C.../Ag..., Dop.../ADop....
  5. Проверьте длинное название, длинный адрес, несколько страниц и документ без необязательных сведений.
  6. Откройте итоговые Word и PDF, если используете оба формата. Проверьте таблицы, переносы, суммы цифрами и прописью.

Если в файле осталось ${имя}, проверьте точное написание и поддерживаемый тип документа. Пустое значение дополнительно требует проверки исходной карточки. Пропавшая таблица требует проверки маркера повторения и выбранных заявок. Не заменяйте автоматическое поле постоянным текстом только ради скрытия ошибки: следующий договор может относиться к другой организации.

В документе появились подчёркивания или пустое место

В конце формирования договора программа ищет оставшиеся нераспознанные обозначения и заменяет найденные записи вида ${имя} на восемь подчёркиваний: ________. Поэтому отсутствие фигурных скобок в готовом Word ещё не доказывает, что всё заполнено правильно. Поищите в документе и ${, и ________.

Такая замена выполняется в основном тексте, верхнем и нижнем колонтитулах. Проверяйте все эти части, включая повторяющиеся реквизиты и соседние поля.

Например, если в лабораторный шаблон вставить поле другого вида договора или ошибиться в регистре имени, вместо ожидаемого значения может получиться линия из подчёркиваний. Сравните исходный DOCX с этим справочником: проверьте точное имя, вид договора и место поля в таблице. Записи с пробелами или повреждёнными скобками могут остаться в другом виде, поэтому итоговый документ нужно также прочитать глазами.

Пустое место может означать, что правильная переменная получила пустое значение из карточки, либо что программа удалила условный фрагмент. Сначала проверьте источник данных и выбранные условия. Не заменяйте автоматические поля постоянным текстом только ради скрытия ошибки.

Смежные справочники: переменные актов и переменные коммерческих предложений.

Продолжение работы