Переменные шаблона акта выполненных работ

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

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

Переменные шаблона акта выполненных работ

Переменные переносят в форму Word данные акта: номер и дату, реквизиты сторон, подписанта, состав работ и суммы. Вы определяете оформление документа, а TesLab заполняет обозначения вида ${ActNum} при формировании файла.

Ниже приведён полный перечень из 98 обозначений: 88 полей данных и 10 маркеров начала и конца лабораторных блоков. Общие поля подходят для обоих видов акта. Строки ручного акта и лабораторные блоки используют разные наборы.

В этой статье

Разобраться с полями и повторяемыми строками

Вставляйте обозначение целиком, включая ${ и }. Например, текст «Акт № ${ActNum} от ${ActDatD}» превратится в «Акт № УЧ-А-39 от 14.11.2026». Регистр имеет значение: ${actnum} не заменяет ${ActNum}.

Обычное поле заменяется одним значением. Для списка работ нужна строка таблицы Word, которая повторяется по позициям. В ручном акте её определяет ${aN}, в лабораторном акте адрес соответствующего вида работ, например ${t1address}.

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

Подготовить и загрузить шаблон

  1. Сохраните исходный DOCX отдельно и редактируйте его копию.
  2. Определите тип акта. Лабораторная форма выбирается в порядке: шаблон договора, шаблон своей организации, общий шаблон. Ручной акт использует отдельную форму.
  3. Добавьте нужные поля, не превращая их в рисунки и не размещая в текстовых полях или других непроверенных элементах Word.
  4. Сохраните файл в формате .docx. Для лабораторного акта загрузите его по инструкции по нумерации и шаблонам актов и счетов. Общая строка «Акт» не заменяет форму ручного акта.
  5. Сформируйте один акт с известными данными и проверьте результат перед массовым использованием.

Загрузка Word-шаблона меняет оформление DOCX и получаемого из него PDF. Загрузка Word-шаблона не меняет форму УПД и XML.

Настройка нумерации и Word-шаблонов актов и счетов
1. Word-шаблон лабораторного акта. 2. Скачивание действующей формы.

Подставить номер, даты и итог

Полное обозначениеЧто подставляется
${ActNum}Номер выбранного акта, например УЧ-А-39.
${ActDate}Дата акта с месяцем словами и строчными буквами, например 14 ноября 2026.
${ActDatD}Дата акта цифрами: 14.11.2026.
${ADD}День даты акта из двух цифр: 14.
${ADM}Месяц даты акта словами, например Ноября в русской форме документа. Исходный регистр сохраняется.
${ADY}Год даты акта: 2026.
${AGnum}Номер договора акта, например УЧ-Д-39.
${AGfrom}Дата подписания договора: 02.01.2026.
${ActBase}Основание акта. Для обычного договора: Договор №УЧ-Д-39 от 02.01.2026.
${Itog}Общая сумма к оплате с учётом режима НДС, с двумя знаками после запятой: 3 480,00.
${ItogProp}Та же общая сумма прописью, с первой заглавной буквой.
${infoNDS}Подпись о НДС: без налога, с одной ставкой либо общая подпись для нескольких ставок. Сумму не содержит.
${TotalNDS}Сумма НДС с двумя знаками после запятой. При ставке 0% выводится 0,00, в режиме без НДС знак -.
${mothPer}Фраза по месяцу даты акта для продолжительного договора, например в ноябре 2026. Для разового договора пусто. Начальное «в» уже входит в значение; годовое слово «года» при необходимости добавьте в шаблоне. Написание именно mothPer.

Номер и дата договора являются разными полями: ${AGnum} и ${AGfrom}. Месячная фраза ${mothPer} не описывает произвольный период работ. Самостоятельных переменных начала и окончания периода в этой форме нет.

Вывести сведения о НДС

${infoNDS} и ${TotalNDS} работают в ручном и лабораторном актах. При одной ставке подпись содержит процент, например «В том числе НДС 20%:». При нескольких ставках ручного акта процент в общей подписи не указывается. В режиме «Без НДС» выводятся «Без налога (НДС)» и -. Нулевая ставка выводится как 0% с суммой 0,00.

В ручном акте цены и суммы строк выводятся с учётом выбранного режима. В лабораторном акте цены объектов и суммы видов работ берутся из сохранённого состава: при «НДС сверху» общий ${Itog} включает добавленный налог, а суммы ${t1itog} и остальных видов показывают стоимость до его добавления. При «НДС в сумме» налог уже входит в цены, повторно прибавлять ${TotalNDS} не нужно.

Например, при стоимости лабораторных работ 12 500,00 и ставке 20% в режиме «НДС сверху» общий итог составит 15 000,00, сумма НДС 2 500,00. Это пример расчёта: применимый режим и ставку задавайте по данным своей операции.

Переменные ${NDS}, ${t1nds}, ${t2nds}, ${t3nds}, ${t4nds} и ${t5nds} в этой форме не заполняются. Не переносите их из старых шаблонов вместо ${TotalNDS}.

Заполнить строки ручного акта

Создайте одну строку таблицы Word. В одной её ячейке разместите ${aN}, в остальных ячейках нужные поля позиции. Программа повторит всю строку по составу ручного акта.

Полное обозначениеЧто подставляется
${aN}Порядковый номер выведенной позиции, начиная с 1. Одновременно служит маркером повторения строки Word.
${aItem}Наименование товара или услуги из позиции акта.
${aCount}Количество в позиции, в том числе дробное.
${aQ}Краткое обозначение единицы измерения, например шт. или ч.
${aPrice}Цена единицы для печатной строки. При «НДС сверху» содержит добавленный налог, при «НДС в сумме» сохраняет цену с налогом.
${aSum}Сумма печатной строки с учётом режима НДС. При «НДС сверху» включает добавленный налог.
${TotalCount}Количество выведенных позиций, а не сумма их количеств и не стоимость. Размещайте вне повторяемой строки.

Полный пример строки: ${aN} | ${aItem} | ${aQ} | ${aCount} | ${aPrice} | ${aSum}. Под таблицей: «Всего позиций: ${TotalCount}. Итого: ${Itog}».

Не добавляйте к именам #1 и #2. Такие окончания программа создаёт сама при повторении строки. Для двух услуг с количествами 2 и 1 поле ${TotalCount} покажет 2.

Две учебные позиции ручного акта, режим НДС и общий итог
1. Общий итог акта. 2. Режим и ставка НДС. 3. Позиции, из которых заполняется повторяемая строка Word.

Вывести реквизиты исполнителя

Исполнитель определяется своей организацией договора. Название и адрес берутся из связанной карточки контрагента в редакции на дату акта. Банковские сведения выбираются на ту же дату. Для ФИО и должности используется директор из настройки своей организации; если он не выбран, руководитель связанного контрагента.

Полное обозначениеЧто подставляется
${MyComp}Сокращённое название исполнителя из карточки контрагента.
${MyCompFull}Полное название исполнителя из той же редакции реквизитов.
${MyCompINN}ИНН исполнителя.
${MyFunct}Должность руководителя исполнителя с первой строчной буквой. Автоматического склонения нет.
${MyFunctU}Та же должность с сохранением исходного регистра.
${MyFio}Фамилия руководителя исполнителя с инициалами, например Учебный П. С..
${MyNameF}Фамилия руководителя исполнителя полностью.
${MyNameI}Имя руководителя исполнителя полностью.
${MyNameO}Отчество руководителя исполнителя полностью. При отсутствии пусто.
${MyAddress}Адрес исполнителя. Почтовый индекс уже добавляется в начало, если он указан.
${MyPost}Почтовый индекс исполнителя отдельно. Не дублируйте его перед ${MyAddress}.
${MyBank}Банковские реквизиты общим текстом: счета, название банка, БИК и корреспондентский счёт, если они заполнены.
${MyBankRC}Расчётный счёт исполнителя.
${MyBankName}Название банка исполнителя.
${MyBankCity}Город банка исполнителя.
${MyBankBIK}БИК банка исполнителя.
${MyBankKS}Корреспондентский счёт банка исполнителя.

Вывести заказчика и подписанта

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

Полное обозначениеЧто подставляется
${ClientComp}Название заказчика.
${ClientINN}ИНН заказчика.
${ClientAddress}Адрес заказчика с почтовым индексом, если он указан.
${ClientFunct}Должность подписанта заказчика с первой строчной буквой, без автоматического склонения.
${ClientFunctU}Должность подписанта с исходным регистром. Заглавная буква принудительно не добавляется.
${ClientUserF}Фамилия подписанта заказчика полностью.
${ClientUserI}Имя подписанта заказчика полностью.
${ClientUserO}Отчество подписанта заказчика полностью. При отсутствии пусто.
${ClientUser}Фамилия подписанта с инициалами.
${ClientBank}Банковские реквизиты заказчика общим текстом, если они заполнены.
${ClientBankRC}Расчётный счёт заказчика.
${ClientBankName}Название банка заказчика.
${ClientBankCity}Город банка заказчика.
${ClientBankBIK}БИК банка заказчика.
${ClientBankKS}Корреспондентский счёт банка заказчика.

Заполнить лабораторный акт

Каждому виду работ соответствует свой блок: t1 для периодического освидетельствования, t2 для частичного, t3 для полного, t4 для обследования и t5 для сертификации. Если вид отсутствует в акте, весь фрагмент между его маркерами удаляется.

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

Разместить строки и итоги лабораторного акта

  1. Перед заголовком вида поставьте открывающий маркер, например ${t1}, в отдельном абзаце.
  2. Создайте одну строку Word с ${t1address}. В той же строке разместите номер объекта и цену. По адресу программа повторяет всю строку.
  3. За пределами повторяемой строки разместите количество, список номеров и сумму вида работ.
  4. После таблицы и итогов поставьте ${/t1} в отдельном абзаце. Весь фрагмент, включая маркеры, должен находиться в основном тексте документа.

Цена ${t1price} вне повторяемой строки показывает последнюю обработанную цену этого вида. Она не является средней ценой или суммой группы. Для суммы используйте ${t1itog}. Это правило относится ко всем пяти видам.

У двух объектов цены 1 000,00 и 1 500,00. В повторяемых строках появятся обе цены, ${t1count} покажет 2, а ${t1itog} покажет 2 500,00. Номера ${t1regn} и ${t1regn-r} могут различаться: первый берётся из протокола с резервным значением заявки, второй строго из заявки.

Периодическое техническое освидетельствование

Полное обозначениеЧто подставляется
${t1}Начало фрагмента этого вида. Отдельный абзац перед его заголовком и таблицей.
${/t1}Конец фрагмента этого вида. Отдельный абзац после таблицы, итогов и относящегося к виду текста.
${t1address}Адрес объекта: индивидуальный адрес, если он задан, иначе адрес установки. Маркер повторения строки Word; остальные поля объекта разместите в той же строке.
${t1regn}Идентификационный номер объекта из протокола; при отсутствии значения используется номер из заявки. Поле повторяемой строки.
${t1regn-r}Идентификационный номер объекта строго из строки заявки. Поле повторяемой строки.
${t1price}Цена объекта из сохранённого состава акта. В повторяемой строке у каждого объекта своя цена. Вне строки выводится последняя обработанная цена вида.
${t1regList}Список идентификационных номеров объектов из заявки с переводом строки между номерами. Размещайте вне повторяемой строки, в отдельном абзаце.
${t1count}Количество включённых объектов этого вида. Размещайте вне повторяемой строки.
${t1itog}Сумма цен включённых объектов этого вида из сохранённого состава. Размещайте вне повторяемой строки. При НДС сверху сумма не включает добавляемый налог.

Частичное техническое освидетельствование

Полное обозначениеЧто подставляется
${t2}Начало фрагмента этого вида. Отдельный абзац перед его заголовком и таблицей.
${/t2}Конец фрагмента этого вида. Отдельный абзац после таблицы, итогов и относящегося к виду текста.
${t2address}Адрес объекта: индивидуальный адрес, если он задан, иначе адрес установки. Маркер повторения строки Word; остальные поля объекта разместите в той же строке.
${t2regn}Идентификационный номер объекта из протокола; при отсутствии значения используется номер из заявки. Поле повторяемой строки.
${t2regn-r}Идентификационный номер объекта строго из строки заявки. Поле повторяемой строки.
${t2price}Цена объекта из сохранённого состава акта. В повторяемой строке у каждого объекта своя цена. Вне строки выводится последняя обработанная цена вида.
${t2regList}Список идентификационных номеров объектов из заявки с переводом строки между номерами. Размещайте вне повторяемой строки, в отдельном абзаце.
${t2count}Количество включённых объектов этого вида. Размещайте вне повторяемой строки.
${t2itog}Сумма цен включённых объектов этого вида из сохранённого состава. Размещайте вне повторяемой строки. При НДС сверху сумма не включает добавляемый налог.

Полное техническое освидетельствование

Полное обозначениеЧто подставляется
${t3}Начало фрагмента этого вида. Отдельный абзац перед его заголовком и таблицей.
${/t3}Конец фрагмента этого вида. Отдельный абзац после таблицы, итогов и относящегося к виду текста.
${t3address}Адрес объекта: индивидуальный адрес, если он задан, иначе адрес установки. Маркер повторения строки Word; остальные поля объекта разместите в той же строке.
${t3regn}Идентификационный номер объекта из протокола; при отсутствии значения используется номер из заявки. Поле повторяемой строки.
${t3regn-r}Идентификационный номер объекта строго из строки заявки. Поле повторяемой строки.
${t3price}Цена объекта из сохранённого состава акта. В повторяемой строке у каждого объекта своя цена. Вне строки выводится последняя обработанная цена вида.
${t3regList}Список идентификационных номеров объектов из заявки с переводом строки между номерами. Размещайте вне повторяемой строки, в отдельном абзаце.
${t3count}Количество включённых объектов этого вида. Размещайте вне повторяемой строки.
${t3itog}Сумма цен включённых объектов этого вида из сохранённого состава. Размещайте вне повторяемой строки. При НДС сверху сумма не включает добавляемый налог.

Обследование

Полное обозначениеЧто подставляется
${t4}Начало фрагмента этого вида. Отдельный абзац перед его заголовком и таблицей.
${/t4}Конец фрагмента этого вида. Отдельный абзац после таблицы, итогов и относящегося к виду текста.
${t4address}Адрес объекта: индивидуальный адрес, если он задан, иначе адрес установки. Маркер повторения строки Word; остальные поля объекта разместите в той же строке.
${t4regn}Идентификационный номер объекта из протокола; при отсутствии значения используется номер из заявки. Поле повторяемой строки.
${t4regn-r}Идентификационный номер объекта строго из строки заявки. Поле повторяемой строки.
${t4price}Цена объекта из сохранённого состава акта. В повторяемой строке у каждого объекта своя цена. Вне строки выводится последняя обработанная цена вида.
${t4regList}Список идентификационных номеров объектов из заявки с переводом строки между номерами. Размещайте вне повторяемой строки, в отдельном абзаце.
${t4count}Количество включённых объектов этого вида. Размещайте вне повторяемой строки.
${t4itog}Сумма цен включённых объектов этого вида из сохранённого состава. Размещайте вне повторяемой строки. При НДС сверху сумма не включает добавляемый налог.

Сертификация

Полное обозначениеЧто подставляется
${t5}Начало фрагмента этого вида. Отдельный абзац перед его заголовком и таблицей.
${/t5}Конец фрагмента этого вида. Отдельный абзац после таблицы, итогов и относящегося к виду текста.
${t5address}Адрес объекта: индивидуальный адрес, если он задан, иначе адрес установки. Маркер повторения строки Word; остальные поля объекта разместите в той же строке.
${t5regn}Идентификационный номер объекта из протокола; при отсутствии значения используется номер из заявки. Поле повторяемой строки.
${t5regn-r}Идентификационный номер объекта строго из строки заявки. Поле повторяемой строки.
${t5price}Цена объекта из сохранённого состава акта. В повторяемой строке у каждого объекта своя цена. Вне строки выводится последняя обработанная цена вида.
${t5regList}Список идентификационных номеров объектов из заявки с переводом строки между номерами. Размещайте вне повторяемой строки, в отдельном абзаце.
${t5count}Количество включённых объектов этого вида. Размещайте вне повторяемой строки.
${t5itog}Сумма цен включённых объектов этого вида из сохранённого состава. Размещайте вне повторяемой строки. При НДС сверху сумма не включает добавляемый налог.

Проверить готовый документ

  1. Для ручного акта возьмите две разные услуги, проверьте обе строки, количества, цены, суммы и ${TotalCount}.
  2. Для лабораторного акта проверьте каждый используемый вид работ, в том числе сертификацию. Сравните адреса, номера из заявки и протокола, количество и сумму каждого вида.
  3. Сверьте название исполнителя, ИНН, банковские реквизиты и подписантов. Проверьте номер и дату акта, номер и дату договора.
  4. Сопоставьте общий итог и НДС с режимом акта. При НДС сверху учитывайте, что лабораторные суммы видов показаны до добавления налога.
  5. Откройте готовый DOCX. В нём не должно остаться обозначений ${...}. Затем сформируйте PDF и проверьте переносы таблиц, итог и подписи.

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

Продолжить работу