Печать

Печать талонов

Талон печатается на термопринтере терминала или через удалённый print-server в локальной сети. Система сама находит принтер, подбирает формат и обходит «длинные чеки», которые даёт драйвер.

/admin/settings/printing Печать → Настройки печати

Режимы печати

Локальный принтер

Термопринтер подключён к машине терминала. Система ищет USB-принтеры и печатает напрямую: на Linux — ESC/POS raw через lp, на Windows — через драйвер или прямой raw-вывод.

Удалённый print-server

Принтер подключён к другой машине в сети, где запущен print-server. Система отправляет задание по HTTP, сервер сам собирает PDF и печатает. Удобно, когда терминал и принтер физически разнесены.

Настроить печать

  1. Откройте Печать → Настройки печати.
  2. Выберите режим: локальный принтер или удалённый print-server.
  3. Для локального режима укажите принтер по умолчанию или оставьте авто-поиск по списку предпочтительных.
  4. Для удалённого режима укажите адрес print-server и имя принтера на нём.
  5. Решите, спрашивать ли клиента о печати талона. По умолчанию талон печатается автоматически.
  6. Нажмите «Проверить связь» — система покажет доступные принтеры.
  7. Сделайте тестовую печать из редактора шаблонов или на странице настроек.
  8. Проверьте реальный талон на терминале после выдачи.

Параметры печати

ПараметрПо умолчаниюСмысл
print_enabled11 — печатать, 0 — только формировать PDF (предпросмотр).
print_modenativenative — локальный USB/CUPS; remote — print-server.
printer_name—Точное имя принтера в системе.
preferred_printersEP802, CUSTOM VKP80 II, ms-80, VKP80Список для авто-поиска, если имя не задано.
print_media—Точное имя размера страницы драйвера (для PDF-fallback).
print_server_url—Адрес удалённого print-server, например http://192.168.0.50:3001.
print_server_printer—Имя принтера на удалённом сервере; пусто — авто-выбор.
ticket_print_ask01 — не печатать сразу, показать клиенту кнопку «Распечатать талон».

Как выбирается принтер

  1. Принтер, переданный в задании печати.
  2. Принтер из настройки printer_name.
  3. Первый доступный из списка preferred_printers.
  4. Любой первый доступный принтер.

Если принтер не найден, талон не напечатается, а ошибка попадёт в лог и ответ API.

Автоматическая печать и вопрос клиенту

  • Авто-печать — после выдачи талона сервер сразу печатает его по шаблону услуги.
  • Вопрос клиенту — при ticket_print_ask=1 в окне с номером появляется кнопка «Распечатать талон»; окно закрывается через 30 секунд.
  • Печать по кнопке доступна только для свежего талона (5 минут) и в зоне терминала.
  • Сотрудник может напечатать талон повторно из карточки текущего клиента.

PDF и ESC/POS

На Linux основной путь — ESC/POS raw: команды формируются напрямую и отправляются в обход фильтров CUPS. Это даёт точную высоту чека 5–7 см. Если raw-печать недоступна, используется PDF с автоподбором высоты.

  • Высота страницы подгоняется под содержимое — ровно одна страница без пустот.
  • Ширина макета в пикселях пересчитывается в пункты PDF: 300 px ≈ 225 pt (80 мм).
  • Линии, изображения и QR-код печатаются нативно.
  • Для raw-печати очередь CUPS должна быть настроена как raw.

Проверка и диагностика

СимптомЧто проверить
Талон не печатаетсяПринтер включён и виден системе; режим печати верный; тестовая печать проходит.
Длинный чек с пустым низомДрайвер ставит большой размер страницы. Включите raw-режим или настройте print_media.
Печатается не тот принтерУкажите точное имя в printer_name; проверьте список предпочтительных.
Нет связи с print-serverАдрес и порт, доступность по сети, запущен ли сервер; кнопка «Проверить связь».
Текст обрезан по краямШирина шаблона не соответствует бумаге; измените ширину макета в редакторе.
Русский текст не печатаетсяДля ESC/POS используется кодовая страница CP866; проверьте настройки принтера.
Печать выполняется асинхронно: выдача талона не ждёт принтера. Если печать не удалась, клиент всё равно получает номер на экране, а сотрудник может напечатать талон повторно.