Apariencia
Impresión Térmica (QZ Tray)
Permiso:
settings.viewpara configurar · cualquier usuario para imprimir
→ Módulos y permisos
¿Qué es?
Sonata imprime tickets en impresoras térmicas de 80 mm (las típicas impresoras de punto de venta) usando QZ Tray, una aplicación gratuita que se instala en la computadora del cajero y actúa como puente entre el navegador web y la impresora local.
¿Por qué QZ Tray?
Los navegadores web no pueden acceder directamente a impresoras locales. QZ Tray resuelve esto: escucha peticiones de Sonata y las envía a la impresora configurada.
Formatos soportados:
- 58, 72 y 80 mm (ticket de caja) — para impresoras térmicas POS; el contenido se adapta al ancho (32/42/48 columnas).
- A4 / Carta (PDF) — se imprime directamente desde el navegador, sin QZ Tray.
Paso 1 — Instalar QZ Tray
Windows
- Descarga el instalador desde qz.io/download.
- Ejecuta el instalador (
QZ-Tray-x.x.x.exe) y sigue el asistente. - Al terminar, QZ Tray se inicia automáticamente y aparece como ícono en la bandeja del sistema (esquina inferior derecha, junto al reloj): 🖨️.
- Configura que inicie con Windows:
- Clic derecho sobre el ícono → Auto-start → activa la opción.
macOS
- Descarga el instalador
.dmgdesde qz.io/download. - Abre el
.dmgy arrastra QZ Tray a la carpeta Aplicaciones. - Ábrelo desde Aplicaciones. El ícono de impresora aparece en la barra de menú.
- En las preferencias del sistema, agrega QZ Tray a los elementos de inicio de sesión.
macOS — permisos de seguridad
La primera vez que abras QZ Tray en macOS puede aparecer el aviso "App no identificada". Ve a Preferencias del sistema → Seguridad y privacidad → Abrir de todas formas.
Paso 2 — Configurar la impresora en QZ Tray
- Asegúrate de que la impresora térmica esté:
- Conectada al ordenador (USB o red local).
- Instalada con su driver en Windows/macOS (aparece en el panel de impresoras del sistema).
- QZ Tray detecta automáticamente todas las impresoras instaladas.
- Verifica haciendo clic derecho en el ícono de QZ Tray → Diagnostics → Print test page.
Paso 3 — Configurar en Sonata
Esto se configura en la caja, que es la impresora que manda cuando hay un turno abierto (ver Qué impresora se usa más abajo).
- Ve a Configuración → Cajas registradoras y edita la caja.
- Sección Impresora térmica (80 mm):
| Campo | Descripción |
|---|---|
| Impresora | Selecciona la impresora de la lista (las detecta QZ Tray). Si no aparece, verifica que QZ Tray esté activo. |
| Ancho del papel | 80 mm (estándar), 72 mm o 58 mm según tu rollo. La vista previa muestra el ticket con el ancho real. |
| Caracteres por línea | Se ajusta automáticamente al ancho del papel (48/42/32). |
- Sección Contenido del ticket — personaliza qué aparece en el ticket:
| Opción | Descripción |
|---|---|
| Logo | Sí / No. Usa el logo B/N para tickets si está configurado (mejor resultado en térmicas); si no, el logo general. |
| Dirección de la empresa | Mostrar/ocultar. |
| Teléfono y correo | Mostrar/ocultar. |
| Número de caja | Mostrar/ocultar (ej. "Caja 1"). |
| Cajero | Mostrar/ocultar el nombre del usuario que emitió el ticket. |
| Fuente compacta | Reduce el tamaño de letra para tickets más cortos. |
| Mensaje de pie | Texto libre al final del ticket (ej. "¡Gracias por su compra!"). |
| Código QR | En facturas electrónicas, el ticket incluye el QR que enlaza a la consulta pública del documento en la DGI, más el CUFE y la leyenda del PAC. |
- Haz clic en Imprimir prueba para verificar el resultado.
- Guarda la configuración.
Mensaje de pie
Aprovecha el pie del ticket para incluir tu dirección web, redes sociales, tu política de devoluciones o un mensaje de agradecimiento. Máx. 3 líneas.
Paso 4 — Quitar el aviso "Untrusted website"
La primera vez que Sonata manda a imprimir, QZ Tray muestra un aviso de "Untrusted website" y hay que aprobarlo a mano en cada impresión. Se quita una sola vez por computadora instalando el certificado de confianza:
- Ve a Configuración → Impresión → Impresión térmica (QZ Tray).
- En la sección Certificado de confianza QZ Tray, pulsa Descargar digital-certificate.txt.
- Copia el archivo descargado a la carpeta de QZ Tray:
- Windows:
C:\Program Files\QZ Tray\demo\ssl\ - macOS:
/Applications/QZ Tray.app/Contents/Resources/demo/ssl/
- Windows:
- Reinicia QZ Tray.
Es por computadora, no por usuario
El certificado se instala en la máquina. Si el cajero cambia de computadora, hay que repetir el paso allá. Y si reinstalas QZ Tray, el archivo se pierde.
¿Y si no lo instalo?
Todo funciona igual, pero cada impresión pide confirmación en una ventana de QZ Tray. En un mostrador con cola, eso es un clic de más por cada ticket.
Qué impresora se usa (y en qué orden)
Sonata elige la impresora en este orden, y se queda con la primera que encuentre:
- La de la caja, si tienes un turno abierto y esa caja tiene impresora configurada. Se define en Configuración → Cajas registradoras y la configura un administrador, no el cajero.
- La tuya de respaldo, en Configuración → Impresión. Es por usuario y por empresa: la que se usa cuando trabajas sin caja abierta —al reimprimir un ticket, por ejemplo— o cuando la caja no tiene ninguna configurada.
- Si no hay ninguna de las dos, la impresión térmica queda deshabilitada.
El logo va aparte
El logo del ticket sale de tu configuración aunque mande la impresora de la caja, salvo que la caja tenga un logo propio definido.
Imprimir un ticket
Con QZ Tray activo y la impresora configurada:
- Abre cualquier factura desde Ventas → Facturas.
- Haz clic en Imprimir ticket.
- Sonata envía el trabajo a QZ Tray → QZ Tray lo manda a la impresora.
- El ticket sale sin diálogos de impresión (directo).
Impresión silenciosa
A diferencia de los PDFs (que abren un diálogo del navegador), los tickets térmicos se imprimen silenciosamente sin confirmación. Útil para flujo de caja rápido.
Múltiples computadoras / cajas
Si tienes varias computadoras (una por caja):
- Instala QZ Tray en cada computadora por separado.
- Configura la impresora de cada caja en esa computadora.
- En Sonata, la selección de impresora se guarda por navegador/máquina, no en la configuración global del servidor.
Solución de problemas
| Síntoma | Causa probable | Solución |
|---|---|---|
| Botón "Imprimir ticket" deshabilitado | QZ Tray no está activo | Abre QZ Tray desde el menú de aplicaciones |
| "No se pudo conectar a QZ Tray" | QZ Tray no arrancó o se cerró | Reinicia QZ Tray; verifica que inicie automáticamente |
| La lista de impresoras aparece vacía | Impresora no instalada o QZ Tray sin permisos | Verifica que la impresora aparezca en el panel de impresoras del OS |
| El ticket sale en blanco | Driver incorrecto o modo de impresión | Reinstala el driver de la impresora; prueba con el modo RAW |
| El texto sale cortado a la derecha | Ancho configurado incorrecto | Cambia el ancho en Configuración → Impresión (80 mm o 58 mm) |
| Caracteres con símbolos raros (ñ, á, é) | Codificación incorrecta | Selecciona Codificación UTF-8 en la configuración de QZ Tray |
| QZ Tray se cierra solo en macOS | Falta de permisos de accesibilidad | Ve a Preferencias → Seguridad → Accesibilidad y agrega QZ Tray |
Preguntas frecuentes
¿QZ Tray es gratuito?
Sí, la versión básica es completamente gratuita y cubre todos los casos de uso de Sonata.
¿Necesito instalar QZ Tray en el servidor de Sonata?
No. QZ Tray se instala solo en las computadoras que van a imprimir (los puestos de caja).
¿Funciona con cualquier impresora térmica?
Funciona con la mayoría de impresoras térmicas ESC/POS de 80 mm (Epson, BIXOLON, Star Micronics, Citizen, etc.). Marcas genéricas compatibles con ESC/POS también funcionan.
¿Puedo imprimir más de una copia del ticket?
Sí. En la configuración de QZ Tray puedes definir el número de copias predeterminado.
¿QZ Tray necesita internet?
No. Funciona en la red local. Sonata envía el trabajo de impresión a través del navegador hacia QZ Tray localmente.