Qué necesitas
Antes de empezar, asegúrate de tener lo siguiente en el equipo Windows:
- Acceso de administrador al equipo.
- La impresora térmica ya instalada en Windows (visible en Dispositivos e impresoras).
- PowerShell disponible (viene incluido en Windows 10 y 11).
- Conexión a internet.
Instalar QZ Tray
Abre PowerShell como administrador y ejecuta el script de instalación que provee Recompry:
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-qz-windows.ps1Si ya descargaste el instalador .exe de QZ Tray manualmente, puedes indicarle la ruta:
PowerShell -ExecutionPolicy Bypass -File .\scripts\install-qz-windows.ps1 -InstallerPath .\qz-tray.exePara abrir PowerShell como administrador: haz clic derecho en el botón de inicio de Windows y selecciona 'Windows PowerShell (administrador)'.
Provisionar el certificado de Recompry
Si QZ Tray ya estaba instalado y solo necesitas agregar el certificado para silent print, ejecuta:
PowerShell -ExecutionPolicy Bypass -File .\scripts\qz-provision-own-root-windows.ps1 -RootCertPath .qz\root-ca.crtConectar en Recompry
- Abre QZ Tray si no está corriendo (aparecerá en la bandeja del sistema).
- Ingresa a Recompry y ve a Ajustes > Impresión.
- Selecciona la sede que vas a configurar.
- En Selección de impresora, cambia a QZ Tray.
- Haz clic en Actualizar para detectar las impresoras disponibles.
- Selecciona tu impresora térmica del listado.
- Ajusta el Ancho de papel (normalmente 80 mm).
- Define si cada plantilla debe abrir el cajón de dinero.
Probar la impresión
- En la sección Plantillas, localiza la plantilla que quieres probar (Orden, Pre-cuenta, Factura).
- Haz clic en el icono de impresora junto a cada plantilla.
- Verifica que el ticket salga correctamente.
La primera vez que imprimas, QZ Tray puede mostrar un diálogo de confianza. Acepta y marca 'Remember this decision'.
Configurar zonas de impresión
Configura zonas para enviar órdenes automáticamente a diferentes impresoras según el área (cocina, barra, caja).
- Ve a Ajustes > Impresión > Zonas de impresión.
- Haz clic en Crear zona.
- Nombra la zona (ej: Cocina, Barra).
- Asigna la impresora correspondiente.
- Guarda los cambios.
Solución de problemas
Si QZ Tray no conecta o no aparecen impresoras:
- Verifica que QZ Tray esté corriendo en la bandeja del sistema (esquina inferior derecha).
- Comprueba que el antivirus o firewall no esté bloqueando localhost:8181 o localhost:8182.
- Reinicia QZ Tray desde la bandeja.
- Vuelve a Ajustes > Impresión y haz clic en Actualizar.