• Imprimir un ticket de factura
• Imprimir tickets con QZ Tray

Guía rápida: QZ Tray para imprimir tickets

Guía sencilla para instalar y usar QZ Tray con FacturaScripts y tu impresora térmica USB.

1) Instalar QZ Tray

1. Descarga: ve a https://qz.io/download/.

2. Instala: abre el archivo y sigue el asistente (Windows .exe, macOS .pkg, Linux instalador).

3. Abre QZ Tray: verás en la bandeja de programas abiertos QZ Tray.

   

4. Inicio automático: clic derecho en el icono → marca “Automatically Start”.

✅ Solo tienes que hacerlo una vez. ❗ Es aconsejable seguír la instalación en la página de QZ Tray.

2) Conectar y configurar la impresora

1. Abrir configuración

   Dentro del panel de QZ Tray, pulsar “Configurar impresora”.

   

2. Conexión (normalmente automática) QZ Tray intenta conectarse solo si ya tiene permiso.

   • Si aparece una ventana pidiendo permiso, pulsa “Allow” y marca “Remember this decision”.

3. Escanear dispositivos Pulsa “Escanear dispositivos USB”.

4. Elegir impresora Normalmente tu impresora aparecerá reconocida en la lista (si ha sido testeada por el equipo de Facturascripts).

   1. Pulsa “Seleccionar”, esto aplicará automáticamente los parámetros en la configuración manual y estará lista para usarse.

   

5. Si no aparece reconocida Rellena los campos inferiores (Vendor ID, Product ID y la interfaz y el endpoint si hace falta) y asegúrate de que sean correctos y correspondan a tu impresora.

   Para usuarios avanzados: puedes hacer una pruebas y depurar en https://demo.qz.io/.

   

6. Probar impresión Elige el ancho de papel (habitual: 80 mm o 58 mm) y pulsa “Imprimir ticket de prueba”.

   • En el ticket de prueba verás una “regla” con indicaciones.

   • Si la regla no mide el ancho real del papel (queda corta o hace un salto de línea), el tamaño elegido es incorrecto. Cambia el ancho y repite la prueba.

   Ejemplo:
   ❌ Demasiado estrecho
   (queda espacio a la derecha)
   |-----------XX---|
   
   ❌ Demasiado ancho
   (se parte en dos líneas)
   |------------------------------------
   -------XX---|
   
   ✅ Correcto
   (toca ambos bordes en una sola línea)
   |------------------------------XX---|

   ✅ Si imprime correctamente, la configuración queda guardada en tu navegador.

3) Imprimir un ticket

1. En el panel de impresión pulsa en el botón de QZ Tray

   

2. Elije la impresora (se usará su configuración)

   

3. (Opcional) Elige el formato de ticket.

4. Pulsa “Imprimir Ticket”.

Solución rápida de problemas

• No conecta

  • Asegúrate de que QZ Tray está abierto (en la bandeja de aplicaciones abiertas).
  • Recarga la página de FacturaScripts.

• En localhost pide permiso constantemente

  • Si trabajas en localhost, el navegador puede solicitar permiso en cada intento de impresión porque no usa certificado SSL.

• No detecta la impresora

  • Enciéndela y revisa el cable/puerto USB.
  • Vuelve a “Escanear dispositivos USB”.

• Imprime mal o con símbolos raros

  • Revisa el ancho de papel (80 mm / 58 mm) y verifica la regla del ticket de prueba.
  • Si configuraste manualmente, comprueba los campos inferiores o prueba en demo.qz.io.