Antes de empezar
La instalación se hace en cada computador que vaya a imprimir, una sola vez. Necesita cuatro cosas:
- El computador de la caja, con Windows o macOS.
- La impresora ya instalada y funcionando en ese equipo. Si todavía no imprime una página de prueba desde el sistema operativo, resuelva eso primero.
- Permisos para instalar programas, es decir, el usuario administrador del equipo.
- Un usuario del sistema con acceso a Configuración avanzada, para activar la opción.
Cómo funciona
QZ Tray es un programa pequeño que queda corriendo en el computador de la caja. El sistema le entrega el tiquete y él lo manda a la impresora. Por eso debe estar abierto siempre que se facture.
1. Instale QZ Tray en el computador de la caja
Descárguelo del sitio oficial: https://qz.io/download
Windows
- Descargue el instalador
.exey ábralo. - Pulse Siguiente hasta terminar. No hace falta cambiar ninguna opción.
- Al finalizar aparece el icono junto al reloj, abajo a la derecha. Si no lo ve, pulse la flecha de mostrar iconos ocultos.
- Si Windows muestra un aviso del cortafuegos, elija Permitir acceso.
macOS
- Descargue el archivo
.pkgy ábralo. - Siga el asistente hasta el final.
- Si macOS bloquea la instalación, vaya a Ajustes del sistema → Privacidad y seguridad y pulse Abrir de todos modos.
- Al terminar aparece el icono en la barra superior, junto al reloj.
Déjelo iniciando con el equipo
Si QZ Tray está cerrado, el tiquete no se imprime solo. Reinicie el computador una vez y confirme que el icono vuelve a aparecer por sí mismo.
2. Genere los certificados de QZ Tray
Los certificados son los que evitan que QZ Tray pida permiso en cada venta. Los genera el propio programa, en el mismo computador donde lo acaba de instalar, y en el paso siguiente se suben al sistema.
-
Abra el Site Manager. Junto al reloj, en los iconos ocultos, haga clic
derecho sobre el icono de QZ Tray y entre a
Advanced → Site Manager…
El menú del icono, junto al reloj: Advanced → Site Manager… -
Cree el certificado. En la ventana Site Manager, pulse el
botón + de la parte inferior izquierda y elija
Create New…
El botón + abre este menú; la opción es Create New… -
Acepte los permisos. Windows pedirá permisos de administrador para
guardar el certificado en la carpeta del programa. Pulse Continuar; si
elige Omitir o Cancelar, el certificado no queda instalado.
Este aviso es normal: pulse Continuar. - Ubique los archivos. Al terminar se abre sola la carpeta con los dos archivos generados. Tenga esa ruta a la mano: son los que va a subir al sistema.
Cuide la clave
La clave privada es sensible. No la envíe por correo ni por WhatsApp: quien la tenga puede firmar trabajos de impresión en nombre de su sistema.
3. Active la impresión en el sistema
Entre con un usuario administrador y vaya a:
Configuración y más → Configuración avanzada → Impresión
En esa pestaña hay un interruptor. Déjelo en Si
Debajo del interruptor están los dos campos donde van los archivos del paso anterior:
uno en Digital Certificate y el otro en Private Key.
4. Decida cómo quiere que salga
En la misma pantalla, pestaña Ventas, está la opción Impresión directa del PDF:
| Opción | Qué pasa al cerrar la venta | Cuándo conviene |
|---|---|---|
| Sí | El tiquete sale solo por la impresora, sin tocar nada. | Caja rápida, restaurante, tienda con mucho flujo. |
| No | El tiquete queda en pantalla y el cajero pulsa Imprimir cuando lo necesita. | Cuando no siempre se entrega tiquete impreso y se quiere ahorrar papel. |
Esta misma opción gobierna la impresión del módulo de restaurante.
5. Deje lista la impresora
QZ Tray envía el tiquete a la impresora predeterminada del computador. No se elige desde el sistema, así que hay que dejarla bien configurada en el equipo:
- Windows: Configuración → Bluetooth y dispositivos → Impresoras y escáneres → abra su impresora → Establecer como predeterminada. Desactive además Permitir que Windows administre mi impresora predeterminada, o Windows la cambiará por su cuenta.
- macOS: Ajustes del sistema → Impresoras y escáneres → elija la impresora en Impresora por omisión.
- Tamaño del papel: en las propiedades de la impresora, deje el tamaño real del rollo, por ejemplo 80 mm o 58 mm. Si queda en Carta, el tiquete sale cortado o diminuto.
6. Haga una venta de prueba
- Abra el POS y registre una venta de valor bajo.
- La primera vez, QZ Tray muestra una ventana pidiendo permiso para que el sistema use la impresora. Marque Remember this decision (recordar esta decisión) y pulse Allow (permitir).
- El tiquete debe salir por la impresora, y en pantalla aparece el mensaje “Documento enviado a la impresora”.
Si no marca la casilla
El permiso se pedirá en cada venta. Si ya le pasó, ciérrelo y vuelva a abrirlo, o cargue los certificados como se explica en el paso 2.
Si algo falla
Aparece “No hay conexión con QZ”
QZ Tray no está abierto en ese computador. Búsquelo en el menú de inicio y ábralo: el icono debe quedar junto al reloj. Si ya estaba abierto, ciérrelo por completo (clic derecho en el icono → salir), vuelva a abrirlo y recargue la página del sistema.
La ventana de permiso aparece en cada venta
No se marcó Remember this decision la primera vez. Cierre QZ Tray, ábralo de nuevo, haga una venta y marque la casilla antes de pulsar Allow. La solución definitiva es cargar los certificados.
El tiquete sale por otra impresora
Se está usando la impresora predeterminada del computador. Cámbiela como se explica en el paso 4 y, en Windows, desactive Permitir que Windows administre mi impresora predeterminada.
Cierro la venta y no imprime ni avisa
Revise en este orden: que el interruptor de Configuración avanzada → Impresión esté en Si; que Impresión directa del PDF esté en Sí —si está en No, el tiquete espera a que pulse Imprimir, y es el comportamiento correcto de esa opción—; y recargue la página del POS después de cambiar cualquiera de las dos.
El tiquete sale cortado o muy pequeño
Es el tamaño de papel del controlador de la impresora, no del sistema. Entre a las propiedades de la impresora en el computador, deje el tamaño real del rollo e imprima una página de prueba desde ahí antes de volver al POS.
Aparece “An active connection with QZ already exists”
Es un aviso, no un error: la página ya estaba conectada a QZ Tray y la impresión funciona igual. Si le molesta, recargue la página del sistema.
Lista de verificación
Marque cada punto a medida que lo confirme.