Печать

Шаблоны чеков

Шаблон определяет, что напечатано на талоне: название организации, номер, услуга, время, место в очереди, логотип, разделители и QR-код. Шаблон собирается мышкой в визуальном редакторе.

/admin/ticket-templates Печать → Шаблоны чеков

Открыть редактор

Перейдите в Печать → Шаблоны чеков. Редактор открывается внутри страницы и позволяет создавать, дублировать и удалять шаблоны, если у роли есть право редактирования справочника. Роль только с просмотром работает в режиме чтения.

Создать шаблон

  1. Нажмите «Новый шаблон» и задайте название.
  2. Выберите ширину макета под бумагу принтера: 220 px (58 мм), 300 px (80 мм) или A6.
  3. Добавьте элементы: текст, изображение, переменную, разделитель или отступ.
  4. Настройте шрифт, выравнивание, инверсию и размер каждого элемента.
  5. Проверьте превью — оно показывает, как талон будет выглядеть на бумаге.
  6. Сохраните и сделайте тестовую печать.
  7. Привяжите шаблон к услуге в карточке услуги или назначьте шаблон по умолчанию.

Элементы талона

ЭлементНазначениеПараметры
ТекстЗаголовок, пояснение, подпись.Содержимое, размер шрифта, жирность, выравнивание, инверсия.
ПеременнаяПодстановка данных талона и организации.Имя переменной, стиль.
ИзображениеЛоготип или картинка.Файл, ширина в пикселях макета, выравнивание.
РазделительГоризонтальная линия.Тип линии: тонкая, толстая, пунктир.
ОтступПустое место по вертикали.Высота отступа.

Переменные

Переменные подставляются в текст в формате {{имя}}. Базовые:

ПеременнаяЗначение
{{ticketNumber}}Номер талона.
{{serviceName}}Название услуги.
{{queueName}}Название очереди, в которую входит услуга.
{{queuePosition}}Порядковый номер в очереди.
{{peopleBefore}}Сколько человек ждёт перед клиентом; если никого — «никого нет».
{{waitTime}}Примерное время ожидания.
{{createdAt}}Дата и время выдачи талона.
{{date}}, {{time}}Только дата или только время выдачи.
{{orgName}}, {{orgAddress}}, {{orgPhone}}Название, адрес и телефон организации из настроек.
{{visitor}}, {{visitorDecl}}Обращение к посетителю и его склонённая форма (см. ниже).

Склонение обращения

Для форм «один / два / пять» используйте токен {{decl:один,два,пять}} — система выберет нужную форму по числу. То же можно сделать с переменной, например: {{decl:queuePosition,человек,человека,человек}}. Правила: 1 — первая форма, 2–4 — вторая, 5 и более — третья; числа 11–14 — третья форма. Форма {{visitorDecl}} подставляет уже склонённое обращение.

Как считается время ожидания на талоне

Это примерная оценка, а не прогноз по реальной статистике: число людей перед вами умножается на среднюю длительность услуги и делится на число активных рабочих мест. Настройки wait_count_scope (услуга или вся очередь) и wait_divide_workstations меняют способ расчёта; подробнее — в «Общих настройках».

Полный список, собственные константы и категории ведутся в Печать → Переменные чеков. Константы берутся из настроек системы — например, название организации достаточно изменить один раз в «Организации», и оно обновится во всех чеках.

QR-код

В шаблоне можно включить QR-код с номером талона. На нативной печати он выводится командой принтера или растровым изображением, в PDF — как изображение. Убедитесь, что принтер поддерживает выбранный способ, и проверьте читаемость с телефона.

Шаблон по умолчанию

  • При установке создаётся шаблон «Очередь» и назначается всем услугам.
  • Если у услуги шаблон не выбран, используется шаблон по умолчанию.
  • Ошибка «Для услуги не выбран шаблон чека» возможна только если в системе нет ни одного шаблона.
  • Свой шаблон удобно делать для услуг с особой информацией: запись, оплата, документы.

Тестовая печать

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

Ширина и бумага. Несоответствие ширины макета и бумаги — самая частая причина обрезанного текста. 300 px соответствует бумаге 80 мм, 220 px — 58 мм. После смены принтера проверьте шаблон заново.

Проверка

  • Название организации и логотип читаемы.
  • Номер талона крупный и не обрезан.
  • Название услуги помещается в ширину.
  • QR-код (если есть) считывается.
  • Талон печатается одной страницей без пустого низа.
  • Шаблон привязан к нужной услуге.