Переменные DOCX-шаблона коммерческого предложения

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

Личный кабинет
12 Ноя

Переменные DOCX-шаблона коммерческого предложения

КП, переменные, DOCX, шаблон Комментарии

Word-шаблон определяет, как будет выглядеть коммерческое предложение: его текст, таблицы, реквизиты и подпись. Для каждой услуги можно загрузить свой DOCX. При получении Word или PDF программа подставляет в него данные сохранённого КП.

Ниже приведён полный список из 20 переменных этого шаблона. Условные блоки и автоматическое повторение строк с разными услугами в генераторе КП не предусмотрены.

В этой статье

Проверить первую подстановку

Начните с одной строки в копии шаблона:

КП №${NUM} от ${FD}.${FM}.${FY}

Для учебного КП с номером «УЧ-177» и датой 12.11.2026 результат будет таким:

КП №УЧ-177 от 12.11.2026

Вставляйте обозначения целиком, со знаком $ и фигурными скобками. Соблюдайте регистр: ${ToComp}, ${FMs} и ${UNITs} пишутся именно так. Знак «№», подписи полей и остальной текст оформляют в самом Word.

Скачать готовый пример

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

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

Загрузить свой шаблон в услугу

  1. Откройте справочники коммерческих предложений и выберите нужную услугу.
  2. В блоке «Word-шаблон КП» скачайте текущий файл, если хотите изменить его.
  3. Отредактируйте копию в Word: оставьте нужный постоянный текст и вставьте переменные из таблиц ниже.
  4. В услуге нажмите «Заменить» либо выберите файл, если шаблон ещё не загружен.
  5. Нажмите «Сохранить». Затем получите документ из сохранённого КП этой услуги и проверьте подстановки.
Word-шаблон в форме услуги коммерческого предложения
1. Скачать текущий шаблон. 2. Выбрать замену. 3. Сохранить услугу. Учебный пример.

Общие настройки услуг и приложений описаны в подготовке коммерческих предложений.

Номер и дата КП

ПеременнаяЧто подставляется
${NUM}Сохранённый номер КП, например УЧ-177. Знак «№» не добавляется.
${FD}День даты КП двумя цифрами: 12.
${FM}Месяц даты КП двумя цифрами: 11.
${FMs}Месяц даты КП словами: ноября.
${FY}Год даты КП четырьмя цифрами: 2026.

Для даты словами используйте ${FD} ${FMs} ${FY} года. День и месяц являются отдельными частями даты, а не полной датой каждый.

Получатель и адрес

ПеременнаяЧто подставляется
${ToComp}Название получателя, сохранённое в КП. Например, ООО «Учебный заказчик».
${INN}ИНН с готовой подписью: ИНН: 9151770001. Без ИНН значение пустое.
${AddressInf}Адрес из самого предложения, например Учебная улица, 24.

Перед ${INN} не нужно повторять «ИНН:». Если старое КП связано с контрагентом, но в нём не сохранён ИНН, программа берёт его из связанной карточки. Свободное название получателя само по себе не заполняет ИНН.

${AddressInf} не ищет юридический адрес автоматически. Если нужен адрес объекта, сначала проверьте соответствующее поле КП.

Количество, цена, НДС и оплата

ПеременнаяЧто подставляется
${QUAN}Количество единиц из КП, например 3.
${UNITs}Слово в родительном падеже: для 1 и 21 «единицы», для 2 и 5 «единиц».
${UPRICE}Сохранённая цена единицы с «руб.» и прописью. Например, 2 000,00 руб. (две тысячи рублей 00 копеек). При НДС сверху это базовая цена.
${UNIT_NDS}НДС для единицы с суммой и прописью. При начислении сверху начинается с «НДС сверху», при НДС в сумме с «в т.ч. НДС». Без НДС: «НДС не облагается».
${UPRICE_NDS}Прежнее обозначение НДС единицы. При НДС выводит тот же текст, что ${UNIT_NDS}; без НДС выводит «без НДС». Для нового шаблона используйте ${UNIT_NDS}.
${ITOG}Общий итог с «руб.» и прописью. Включает НДС, начисленный сверху, если выбран этот режим.
${ITOG_NDS}Текст НДС общего итога с суммой и прописью либо «без НДС».
${PayInfo}Описание выбранного условия оплаты из справочника, например «Аванс 50%, остаток после испытаний». Без выбранного условия значение пустое.

Для ${UNITs} подходит фраза Испытания ${QUAN} ${UNITs} оборудования. Это не универсальная подстановка для строки «1 единица».

Денежные переменные уже содержат обозначение рублей и пропись. Не дописывайте их повторно. Для количества 3 и цены 2 000 рублей результат зависит от режима:

  • Без НДС: итог 6 000 рублей.
  • НДС сверху, условная ставка 20%: базовая цена единицы 2 000 рублей, НДС единицы 400 рублей, общий итог 7 200 рублей, в том числе НДС 1 200 рублей.
  • НДС в сумме, условная ставка 20%: цена единицы 2 000 рублей уже включает НДС, общий итог 6 000 рублей, в том числе НДС 1 000 рублей.

При ставке 0% в режиме НДС переменные выводят НДС 0% и нулевую сумму налога. Это отличается от режима «Без НДС». В КП используйте согласованные для вашей операции значения.

${PayInfo} берёт текущее описание условия оплаты. Если описание изменили в справочнике, следующий документ ранее созданного КП получит новый текст.

Срок действия

ПеременнаяЧто подставляется
${ED}День окончания действия КП двумя цифрами: 01.
${EM}Месяц окончания двумя цифрами: 12.
${EMs}Месяц окончания словами: декабря.
${EY}Год окончания четырьмя цифрами: 2026.

Строка Предложение действительно до ${ED} ${EMs} ${EY} года в учебном примере станет «Предложение действительно до 01 декабря 2026 года». Дата берётся из поля «Действует до», а не из даты получения файла.

Обычный текст, пустые поля и блоки

Название услуги, реквизиты своей организации, логотип и подпись можно разместить обычным содержимым Word-шаблона. Отдельных переменных для них, контактного ФИО, комментария и дополнительных полей 1 и 2 в этом наборе нет.

Таблицы и разделы Word допустимы, но обозначения условных блоков из договоров, например ${PRE_PAY}, здесь не обрабатываются. Пустое значение ${INN} или ${PayInfo} убирает только сам маркер. Окружающая подпись, параграф и строка таблицы остаются.

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

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

  1. Сохраните КП с известными учебными значениями и нужной услугой.
  2. В карточке нажмите «Word», дождитесь файла и откройте его.
  3. Сопоставьте номер, даты, получателя, адрес, количество, цену, НДС, итог и оплату с карточкой.
  4. Найдите остатки ${, повтор «ИНН:» или «руб.», пустые подписи и лишние строки. Если маркер не заменился, сверьте имя с таблицей и заново введите его целиком в шаблоне.
  5. Получите PDF и проверьте переносы, таблицы, разрывы страниц и подпись.
Получение Word и PDF из сохранённой карточки КП
1. Получить Word для проверки подстановок. 2. Получить PDF для проверки оформления. Учебный пример: 3 единицы по 2 000 рублей, НДС сверху 20%, итог 7 200 рублей.

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

После правки шаблона сохраните услугу и сформируйте файл заново. При изменении самого КП сначала сохраните карточку. Ранее скачанные и отправленные копии не обновляются автоматически.

Несколько разных услуг

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

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