RUS
  • RUS
  • ENG
  • TUR
  • UKR

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

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

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

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

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

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

b5b9bba4fbd398c793d4e07596b0dc6e.png
221b4052b78b4e55ba5ad102a4103541.png

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

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

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

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

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

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

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

  • гость;

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

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

063a8726836b6205a9f4ef9b519c40f8.png
65d3169611bf34f13afc2d6e8fdd10ae.png

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

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

1fae26971c79093f1505b1f676a8fd95.png

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

b677384a1b90f0fbecd6fc3abf7474ff.png

или

ccc830acde0e0b56cbf4022888595ab2.png

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

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

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

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

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

  • сложение (+);

  • вычитание (-) — короткое тире;

  • умножение (∗);

  • деление (/).

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

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

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

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

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

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

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

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

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

  • Неверный формат чисел или переменных.

  • Деление на 0.

  • Математические операции с нечисловыми переменными. Например, с переменной {RES_ACC_PRICE_IW} — она указывает стоимость проживания, но не числом, а прописью.

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

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

6bcc1dae4b26ba49df64d56fd3ba9bb1.png

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

36abde4521e41bdf3427704df5cb482b.png

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

024013f2a0ce01840efe0a5a1853b64a.png

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

8543279adb4bb24593299617242b67f7.png

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

Счет № {RES_NUMS}

от {RES_BOOK_DATE}

ФИО: {GST_LNAME} {GST_FNAME} {GST_MNAME}

Бронь: {RES_NUM}


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

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

Количество

Цена, {RES_CURR_CODE}

Сумма, {RES_CURR_CODE}

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}

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

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

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

796b6204b3767589e173072239f10750.png

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

111411529c1f525f008fe782276dceed.png

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

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

44dbe9ab89251615c46520fc5da6407d.png

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

f016c8b4107b8d03a9fd03c5d3546f24.png

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

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

e08512676f00492a20ca147a2e5f4c57.png

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

fed9abd2b334e4cd1323f64b6e2ecb67.png

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

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

6faf995d122b07c0bb73863486008114.png

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

48a6c9e7edcd5555fd55da9f1a7377ff.png

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

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

8719a122307f35a6e2a001ad4a3006fa.png
8d6cf45f9c1edb639400ba6f1b260f62.png

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

b77a9d4c37f632de53c3d792ef55c43c.png

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