Печать
Печать талонов
Талон печатается на термопринтере терминала или через удалённый print-server в локальной сети. Система сама находит принтер, подбирает формат и обходит «длинные чеки», которые даёт драйвер.
Режимы печати
Локальный принтер
Термопринтер подключён к машине терминала. Система ищет USB-принтеры
и печатает напрямую: на Linux — ESC/POS raw через lp,
на Windows — через драйвер или прямой raw-вывод.
Удалённый print-server
Принтер подключён к другой машине в сети, где запущен print-server. Система отправляет задание по HTTP, сервер сам собирает PDF и печатает. Удобно, когда терминал и принтер физически разнесены.
Настроить печать
- Откройте Печать → Настройки печати.
- Выберите режим: локальный принтер или удалённый print-server.
- Для локального режима укажите принтер по умолчанию или оставьте авто-поиск по списку предпочтительных.
- Для удалённого режима укажите адрес print-server и имя принтера на нём.
- Решите, спрашивать ли клиента о печати талона. По умолчанию талон печатается автоматически.
- Нажмите «Проверить связь» — система покажет доступные принтеры.
- Сделайте тестовую печать из редактора шаблонов или на странице настроек.
- Проверьте реальный талон на терминале после выдачи.
Параметры печати
| Параметр | По умолчанию | Смысл |
|---|---|---|
print_enabled | 1 | 1 — печатать, 0 — только формировать PDF (предпросмотр). |
print_mode | native | native — локальный USB/CUPS; remote — print-server. |
printer_name | — | Точное имя принтера в системе. |
preferred_printers | EP802, 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_ask | 0 | 1 — не печатать сразу, показать клиенту кнопку «Распечатать талон». |
Как выбирается принтер
- Принтер, переданный в задании печати.
- Принтер из настройки
printer_name. - Первый доступный из списка
preferred_printers. - Любой первый доступный принтер.
Если принтер не найден, талон не напечатается, а ошибка попадёт в лог и ответ 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; проверьте настройки принтера. |