RUS
  • RUS
  • ENG
  • THA
  • VIE
  • IND
  • MSA
  • HIN
  • TUR

Как создать шаблон документа в TL: WebPMS

Последние изменения: 16.06.2026

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



Как создать шаблон документа

1. Создайте шаблон в формате .docx на своем компьютере, например, в редакторе Microsoft Word. Для загрузки готового шаблона с переменными, максимальный размер файла не должен превышать 3МБ.

2. Перейдите в раздел «Управление отелем» → «Настройки» → «Шаблоны документов». Кликните на пункт «Таблица переменных» → откроется список переменных для шаблона.

c606160507d1557720b163edc703eaba.png


8f9c9777da11496f3c83961d120423d5.png


Переменные разделены на несколько категорий:

  • общие параметры;

  • параметры бронирования;

  • параметры номера;

  • покупатель/организатор всего бронирования;

  • компания-заказчик;

  • компания-агент;

  • гость;

  • дополнительные услуги.


3. В вашем шаблоне установите переменные: имя гостя, дата, сумма бронирования и т. д. Например, переменная {DATE_CURR} выгрузит в шаблон текущую дату, а  {RES_NUM} — номер бронирования. Для того, чтобы переменная корректно отображалась при печати документа, скопируйте переменную из таблицы и вставьте в шаблон, выбирая параметр вставки — «Сохранить только текст».

6b32b383a0d076ea5e95961228207e67.png


00979186455ca7367fb94ad6ea7587c9.png


Дополнительные услуги

Для категории «Дополнительные услуги» обязательно использование переменных {EXTR:START} и {EXTR:END}, в начале и конце списка, чтобы переменные этой категории работали. Например: {EXTR:START}{EXTR_NAME}  {EXTR_PRICE} {EXTR:END}  

080c9a8deed593affae5f41b506c25fe.png


Если переменные находятся внутри таблицы, то  {EXTR:START} и {EXTR:END} необходимо поместить внутрь таблицы до и после всех элементов. Пример:

e1d93204fad1a6c07e7202c3d6fa94bc.png


или

50a0f707bde6380abed7039b93883d7e.png


Примечание. Если нумерация в документе проставляется автоматически из настроек редактора, переменная {EXTR:START} находится следом за цифрой. Если нумерация проставляется вручную, переменная должна стоять перед цифрой. Также можно использовать комбинацию {EXTR:START}{ROWINDEX} для автоматической нумерации в столбце — например, в акте или счете. Примеры приведены в главе «Пример шаблона».


В готовом документе они автоматически заменяются на полный перечень услуг из бронирования. Пример использования:

  • в текстовой строке: 
068ac4ef361682d521c222333cf8ac47.png


12c7071b9982fa831296e5010755bf69.png


  • в таблице:
6c6e744bf36e011159eae6c4762d043e.png


5d62e46a2c06439a4b10103b5fbd8bcc.png


Математические операции

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

Допустимы простые математические операции:

  • сложение (+);
  • вычитание (-) — короткое тире;
  • умножение (∗);
  • деление (/).

Кроме переменных, в выражениях можно применять числа. Дробная часть числа указывается через запятую — например, 1,18.

Синтаксис формулы: она начинается со знака равенства (=) и заключается в фигурные скобки { }.


Примеры формул

  • {= STAY_ADR_WITHOUT_VAT * STAY_STAY_DAYS} — вычисляет общую стоимость проживания без НДС: умножает среднюю стоимость проживания в номере в сутки без НДС на количество суток.
  • {= RES_GRAND_TOTAL - RES_PAID} — определяет остаток к оплате (или переплату): вычитает из полной стоимости бронирования уже внесенную сумму.

Если произошла ошибка вычисления формулы:

  • При предварительном просмотре шаблона документа переменная окрасится красным и не заменится на число.
  • При скачивании шаблона документа в бронировании формула не заменится на число.

Ошибка может происходить по следующим причинам:

  • Неверный формат чисел или переменных. Например, если указано значение 0.5 — это некорректно, так как в России дробные числа указываются с запятой: 0,5.
  • Деление на 0.
  • Математические операции с нечисловыми переменными. Например, с переменной {RES_ACC_PRICE_IW} — она указывает стоимость проживания, но не числом, а прописью.  


Пример шаблона

Ниже приведены шаблоны с переменными, на примере которых вы можете создать свой шаблон. 

1. Регистрационная карта гостя.

38ce11d1f5eb2b74d2a8c42d418bf8ca.png


Как выглядит шаблон с переменными:

8f3dc2e24a0a99b76017468a9f719572.png


Переменные из примера выше — вы можете скопировать их и использовать в своем шаблоне:

Hotel Astoria


Регистрационная карта


Фамилия:

{GST_LNAME} 

Имя:

{GST_FNAME}

Отчество:

{GST_MNAME}

Дата рождения:

{GST_BDATE}

Гражданство:

{GST_CITIZENSHIP}

Адрес:

{GST_RES_CITY}, {GST_RES_STREET}, {GST_RES_BUILDING} {GST_RES_APARTMT}

Прибытие:

{RES_ARR_DATE}

Выезд:

{RES_DEP_DATE}

Электронная почта:

{GST_EMAIL1}

Телефон:

{GST_PHONE1}


2. Счет на оплату. 

a37cad27cad1de17253b973c8a8663e4.png


Как выглядит шаблон с переменными:

ec9eb1ef6c0e76cfe8c895ca8531a917.png


Примечание. Если вы используете нумерованный список в режиме автоподстановки, переменная {EXTR:START} должна находиться после цифры — это относится к документам, где количество пунктов неограниченно. 

43cf6aec0fa00b4239cfa3f19ca0e66a.png


Если нумерация проставляется вручную, переменная должна стоять перед цифрой.

7c4a79d2555edc1c72e1409e4e020928.png


Переменные из примера выше — вы можете скопировать их и использовать в своем шаблоне:


Счет
№ {RES_NUMS}

от {RES_BOOK_DATE}


ФИО:

{GST_LNAME} {GST_FNAME} {GST_MNAME}

Бронь: {RES_NUM}


Наименование товара (работы, услуги)

Единица измерения

Количество

Цена, RUB

Сумма, RUB

1.

Проживание с {RES_ARR_DATE} по {RES_DEP_DATE} {STAY_ROOM_NAME}. Гость {GST_LNAME} {GST_FNAME} {GST_MNAME}, общее количество гостей — {RES_GUEST_CNT}

сут.

{STAY_STAY_DAYS}

{RES_ADR}

{RES_ACC_PRICE}

2. {EXTR:START}

{EXTR_NAME}

шт.

{EXTR_CNT}

{EXTR_PRICE}

{EXTR_COST}{EXTR:END}


Итого:

{RES_TOTAL_PRICE}

Стоимость:

{RES_TOTAL_PRICE}

Оплачено:

{RES_PAID}

Итого к оплате:

{RES_TOTAL_PRICE}



Итого к оплате {RES_TOBE_CHARGED_IW}: без НДС



3. Акт. 

551bf82f961be3187e0ccd854976cdcd.png


Как выглядит шаблон с переменными:

cbed426de975ecf3b73d71799f71010e.png


Примечание. Здесь использована комбинация переменных {EXTR:START}{ROWINDEX}, которая проставляет нумерацию в столбце. Эти переменные можно использовать в акте или счете (из примера 2). 

640ba7d146112100538eaf2b44c68c44.png


Переменные из примера выше — вы можете скопировать их и использовать в своем шаблоне:

Акт{RES_NUM} от {DATE_CURR_IW}


Исполнитель: Глава ООО «Астория» Иванов Иван Иванович


ИНН: 780719711111, КПП: 111111111, юр. адрес: 198111, г. Санкт-Петербург, ул. Иванова, д. 31, корп. 3, кв. 1


Заказчик: {CST_LNAME} {CST_FNAME} {CST_MNAME}

{RES_NUM}


Наименование товара (работы, услуги)

Единица измерения

Количество

Цена, RUB

Сумма, RUB

Проживание с {STAY_ARR_DATE} по {STAY_DEP_DATE}

{STAY_ROOM_NAME}

Гость: {GST_LNAME} {GST_FNAME} {GST_MNAME}

сут.

{STAY_STAY_DAYS}

{STAY_ADR}

{STAY_ACC_PRICE}

{EXTR:START}{ROWINDEX}

{EXTR_NAME}

шт.

{EXTR_CNT}

{EXTR_PRICE}

{EXTR_COST}{EXTR:END}

Итого:

Оплачено:

{STAY_TOTAL_PRICE}

{STAY_PAID}



Всего оказано услуг на сумму: {STAY_GRAND_TOTAL_IW}


Вышеуказанные услуги выполнены полностью и в срок. Заказчик претензий по объему, качеству и срокам оказания услуг не имеет.


Исполнитель ___________________________ Заказчик ___________________________


Как загрузить шаблон документа

1. Вернитесь в раздел «Управление отелем» → «Настройки» → «Шаблоны документов».

2. Нажмите «Добавить новый шаблон».

aacb2b4481c7341482d7bcf1ed75154e.png


3. Укажите название шаблона — вы увидите его в карте бронирования. 

838795b5664c13e286e0dadf059a2882.png


4. Выберите категории номеров, для которых будут доступны документы на основе шаблона.

5. В пункте «Правило формирования документа» укажите, как должен формироваться документ — на каждый номер в брони или на каждого гостя в номере. 

321571c3e40a157f5c9860e90199887d.png


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

722f5094733d05bc34841e49aa650c15.png


7. Нажмите «Сохранить» в верхнем углу страницы.

8. После загрузки шаблона нажмите «Скачать для проверки». 

42d63172c4a678bd4a8862d9b06fbe4e.png


Переменные в шаблоне будут заменены тестовыми данными для проверки и выделены желтым цветом. Если в названии переменной допущена ошибка, переменная выделится красным цветом.

8068d5950b4716752d5585e19a458b08.png


Как деактивировать или удалить шаблон

Если необходимо убрать неактуальный шаблон, но вы не хотите удалять его окончательно, деактивируйте в шаблон с помощью переключателя в пункте «Статус» — шаблон не будет отображаться в карте бронирования. 

60762b132f83e2eea1a64d4520b601eb.png


Для удаления шаблона перейдите к общему списку шаблонов → нажмите кнопку «Действие» → «Удалить».

56ab35b8d1657387bd769291fe60e713.png


Как посмотреть и скачать шаблон документа в бронировании

После загрузки шаблона, он появится в карте бронирования в виде документа. 

Посмотреть и скачать документ можно в окне быстрого просмотра бронирования:

3c6c0e0ff3c81941a08c1ce7c9f79004.png


9893e10f6ca3fdd0d41f53978a6d1e47.png


Или в карте бронирования на вкладке «Документы». 

712f8ac0e33c6ec4011204628ef11e30.png


Полезные ссылки

Видеинструкция: создание шаблонов документов в TL: WebPMS

Помогла ли вам статья?