Переменные шаблона счёта на оплату

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

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

Переменные шаблона счёта на оплату

В шаблоне счёта вместо номера, реквизитов и суммы стоят специальные обозначения. Например, ${iNum} означает «подставить номер этого счёта». После формирования Word программа заменит обозначение значением сохранённого документа. Этот справочник содержит все 30 обозначений, которые обрабатывает шаблон счёта на оплату.

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

В этой статье

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

Скачать действующий шаблон и сохранить копию

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

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

Попробовать одну подстановку

Переменную вводят целиком: знак доллара, открывающая фигурная скобка, точное имя, закрывающая скобка. Например, ${iNum}. Сохраните регистр: маленькая i является частью имени. ${iNum}, ${INum} и ${ActNum} не взаимозаменяемы.

  1. В копии формы найдите место для номера счёта.
  2. Вставьте Счёт № ${iNum}.
  3. Загрузите копию в строку «Счёт».
  4. Получите Word одного учебного счёта с известным номером.
  5. Сравните номер в Word с номером в карточке счёта.
Что должно получиться

В исходном Word:

Счёт № ${iNum}
от ${iDate}

Для вымышленного счёта №УЧ-27 от 15 октября 2026 года получится:

Счёт № УЧ-27
от 15 октября 2026

Сам знак № и слово «от» остаются обычным текстом формы. В значения iNum и iDate они отдельно не добавляются.

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

Где размещать поля. Обычные текстовые поля, например ${iNum} или ${OurCName}, можно использовать и в колонтитулах. Все шесть полей повторяемой строки, ${InvoiceInfo} и три маркера изображений размещайте только в основном тексте Word. В колонтитулах они не поддерживаются, и программа попросит перенести их. ${InvoiceInfo} оставьте отдельным абзацем, без соседнего текста.

Реквизиты своей организации: 10 полей

Это исполнитель, от имени которого выставлен счёт. Программа определяет его по своей организации договора. Реквизиты берутся из связанной карточки контрагента с учётом даты счёта. Для названия, КПП, адреса и телефона выбирается редакция, действовавшая на эту дату; будущие редакции не используются. Банковские реквизиты также выбираются на дату счёта, с приоритетом основного банка. ИНН берётся из карточки контрагента. ФИО руководителя и бухгалтера определяются текущим выбором сотрудников в настройках своей организации. Перед повторной печатью старого счёта сравните результат с ранее выданным документом: исправление истории или смена подписантов может повлиять на новый файл.

ПеременнаяЧто подставляетсяЧто проверить
${OurBank}Название банка своей организации.Город банка отдельным маркером этого счёта не предусмотрен.
${OurBankBIK}БИК банка.Подпись «БИК» оформляют обычным текстом.
${OurBankKS}Корреспондентский счёт.Не перепутайте с расчётным счётом.
${OurBankRS}Расчётный счёт.В конце имени стоят латинские RS. Поля BankRC других документов сюда не переносятся.
${OurINN}ИНН своей организации.Вставляется само значение без подписи «ИНН».
${OurKPP}КПП своей организации.При отсутствии исходного значения проверьте реквизиты организации.
${OurCName}Название своей организации, сохранённое в поле наименования.Значение отдельного поля «Полное наименование» этим маркером не выбирается.
${OurCEO}Фамилия и инициалы сотрудника, выбранного генеральным директором у своей организации.Текст ФИО. Если сотрудник не выбран, поле пустое.
${OurBUH}Фамилия и инициалы сотрудника, выбранного главным бухгалтером у своей организации.Текст ФИО этого сотрудника. Если бухгалтер не выбран, поле пустое.
${OurData}Общая строка: название, ИНН, КПП, адрес и телефон своей организации.Пустые части пропускаются. Непустые соединяются запятыми; подписи «ИНН», «КПП», «тел.:» уже входят в соответствующие части.

Например, для банковской таблицы можно поставить «БИК ${OurBankBIK}» и «Счёт № ${OurBankRS}». Если выводите ${OurData}, не дописывайте перед ним заново весь набор тех же реквизитов, иначе они повторятся.

Номер, дата и заказчик: 3 поля

ПеременнаяЧто подставляетсяФормат и источник
${iNum}Номер счёта.Сохранённый номер документа. Знак № при необходимости добавьте в обычный текст формы.
${iDate}Дата счёта с месяцем словами.Например, «15 октября 2026». Это дата самого счёта, не день его повторного скачивания.
${ClientData}Общая строка заказчика: название, ИНН, КПП, адрес и телефон.Непустые части соединяются запятыми. ИНН берётся у контрагента счёта, остальные сведения у заказчика договора; при необычной связке документов сверяйте всю строку.

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

Повторяемая строка: 6 полей

Позиция счёта является одной услугой или товаром. Чтобы для каждой позиции появилась своя строка в Word, подготовьте одну строку таблицы с маркером ${iN}. Поставьте остальные нужные маркеры этой группы в ячейки той же строки. Заголовки колонок оставьте строкой выше.

ПеременнаяЧто подставляетсяОсобенность
${iN}Порядковый номер позиции: 1, 2, 3 и далее.По этому маркеру программа находит строку для повторения.
${iTitle}Наименование позиции из сохранённого состава счёта.Исправляйте источник в счёте, если текст должен измениться во всех новых файлах.
${iCount}Количество.При пустом или нулевом значении в текущем формировании печатается дефис.
${iEd}Обозначение единицы измерения.При выбранной единице используется её национальное обозначение из справочника. Иначе выводится сохранённое текстовое обозначение, а при его отсутствии дефис.
${iPrice}Цена единицы.При пустой или нулевой цене печатается дефис. При НДС сверх суммы и положительной ставке выводится цена с налогом, с двумя знаками после запятой. В остальных случаях используется сохранённое значение цены; единое оформление разрядов для него не добавляется.
${iSumm}Стоимость позиции с двумя знаками после запятой и пробелами между разрядами.При режиме начисления НДС сверх суммы к сохранённой стоимости позиции добавляется её НДС.

В исходном шаблоне не пишите #1 или #2 после имени. Программа добавляет индексы сама, когда повторяет строку. Не ставьте iN только в заголовок таблицы: тогда повторяться может не та часть формы.

Макет одной исходной строки
№НаименованиеЕд.КоличествоЦенаСумма
${iN}${iTitle}${iEd}${iCount}${iPrice}${iSumm}

Это макет для понимания. В Word нужна настоящая таблица с одной строкой данных, а не скриншот этой таблицы.

Итоги и НДС: 6 полей

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

ПеременнаяЧто подставляетсяЧто учитывать
${TotalPrice}Сохранённая итоговая сумма счёта цифрами.Два знака после запятой, пробелы между разрядами. Подпись «руб.» в это значение не входит.
${Total}Та же сохранённая сумма, что и TotalPrice.Можно сохранить имя, уже используемое вашей формой. Это не отдельный итог до или после НДС.
${TotalString}Итоговая сумма прописью с прописной первой буквой.Сравните с TotalPrice и сохранённым итогом карточки.
${TotalCount}Количество сохранённых позиций счёта.Две строки дают 2, даже если количество единиц в каждой строке больше одного. Это не сумма значений iCount.
${infoNDS}Подпись к сумме НДС.Для режима «Без НДС»: «Без налога (НДС)». При налогообложении: «В том числе НДС:» либо подпись с общей ставкой. Ставка 0% сохраняется в подписи: «В том числе НДС 0%:».
${TotalNDS}Сумма НДС по всем позициям счёта.Два знака после запятой. При ставке 0% выводится 0,00, в режиме «Без НДС» дефис. Нулевая сумма налога и отсутствие НДС различаются.

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

Основание и дополнительный текст: 2 поля

ПеременнаяЧто подставляетсяГде разместить
${ContractInfo}Основание счёта. Для обычного счёта это строка «Договор № … от …» с номером и цифровой датой договора.В месте для основания. Не дублируйте слово «Договор», если оно уже приходит в значении.
${InvoiceInfo}Предусмотренный дополнительный информационный блок. В обычном счёте он пуст.Отдельным абзацем. Это не поле для произвольного комментария из карточки.

Места для подписи и печати: 3 поля

Здесь важно отличать ФИО от картинки подписи. ${OurCEO} и ${OurBUH} печатают текст. Следующие три маркера обозначают места для изображений в предусмотренном варианте формирования с подписями. Они не создают сертификат и не подписывают документ криптографически.

ПеременнаяНазначениеБез варианта с изображениями
${CEO}Место изображения подписи руководителя, выбранного у своей организации.Заменяется пробелом.
${BUH}Место изображения подписи бухгалтера, выбранного у своей организации.Очищается.
${cStamp}Место оттиска своей организации.Заменяется пробелом. Маленькая c в начале имени обязательна.

Разместите эти три маркера в основном тексте Word. Если в форме есть CEO или BUH и вы выбираете вариант с изображениями, соответствующий сотрудник должен быть выбран у своей организации. Ненужный маркер удалите из формы. Обычный Word можно получить и без выбранного подписанта: текст его ФИО будет пустым.

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

Пример с двумя услугами

Используйте вымышленные учебные данные: первая услуга стоит 2 000 рублей за одну единицу, вторая 3 000 рублей за одну единицу, обе без НДС. Сохранённый итог счёта составляет 5 000 рублей. Цель проверки состоит в том, чтобы две разные позиции создали две строки, а общий итог появился один раз.

Ожидаемая таблица после подстановки
№НаименованиеЕд.КоличествоЦенаСумма
1Учебная услуга Ашт120002 000,00
2Учебная услуга Бшт130003 000,00

Оформление цены и обозначения единицы зависит от сохранённых данных; в этом примере показан смысл заполнения.

Всего к оплате: 5 000,00 руб.
Без налога (НДС) -

Фраза Всего наименований: ${TotalCount} даст «Всего наименований: 2». Если в первой строке указать количество 3, позиций всё равно останется две.

Учебный счёт УЧ-27: две позиции, итог 5 000 рублей, без НДС
Проверяйте данные перед формированием файла: 1. Общий итог. 2. Режим НДС. 3. Состав счёта. В примере две позиции, поэтому TotalCount равен 2.

Загрузить и проверить готовый документ

  1. Сохраните DOCX и закройте редактирование файла.
  2. В общих настройках выберите «Загрузить шаблон Word» в строке «Счёт».
  3. Дождитесь результата загрузки.
  4. Сформируйте Word учебного счёта на две разные позиции.
  5. Сравните номер, дату, заказчика и свою организацию с карточками.
  6. Проверьте, что строка повторилась два раза, а шапка и общие итоги по одному.
  7. Сравните суммы по строкам, общий итог, пропись и НДС.
  8. В Word выполните поиск по ${, чтобы найти оставшиеся обозначения.
  9. Получите используемый в работе PDF, включая вариант с изображениями, и откройте его.
  10. Проверьте длинное название, несколько страниц, места подписей и читаемость банковских реквизитов.

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

Разобрать ошибку в результате

Что видноЧто проверить
Вместо номера остался ${iNum}.Точное имя, формат DOCX и загрузку именно в строку «Счёт». Убедитесь, что редактируете действующую копию.
Две услуги, но только одна строка.Наличие iN в строке данных Word и сохранённый состав счёта. Картинка таблицы не размножается.
Количество позиций не совпадает с ожидаемым.Используйте TotalCount вне повторяемой строки. Он считает позиции, а не единицы товаров или услуг. Сверьте сохранённый состав счёта.
ФИО бухгалтера пустое или указано другое лицо.Выбор главного бухгалтера у своей организации и данные этого сотрудника. Для ФИО нужен OurBUH, для изображения подписи BUH.
Сумма строки изменилась после включения НДС.Режим налога, сохранённые значения позиции и соответствие суммы карточке. Не прибавляйте налог повторно в Word.
Программа просит перенести поля из колонтитула.Уберите из колонтитула поля строки, InvoiceInfo, CEO, BUH и cStamp. Строка данных должна находиться в таблице основного текста.
Счёт не содержит позиций.Откройте счёт, проверьте и сохраните его состав. Пустая таблица не является готовым счётом для формирования.
Часть реквизитов пустая.Связь счёта с договором, свою организацию, банк и данные заказчика. Переименование переменной не создаёт отсутствующие реквизиты.