Impresión automática de comandas (QZ Tray)

¿Para qué sirve esto?

Normalmente, para imprimir algo desde el navegador tendrías que darle click a “Imprimir” y elegir la impresora cada vez. Con QZ Tray ya no — FactuSmart manda la comanda directo a la impresora de cocina o de caja, sin ventanas, sin clicks, sin que nadie tenga que hacer nada. Se instala una sola vez por PC y queda funcionando para siempre.

¿Quién puede hacer esto?

No necesitas saber de sistemas. Son puros clicks siguiendo esta guía, de principio a fin. Tómate unos 10-15 minutos.

Antes de empezar

• La impresora debe estar ya instalada en Windows en la PC donde vas a usarla. Revisa: Configuración de Windows → Impresoras y escáneres. Si ahí no aparece, primero instala la impresora normal (con su cable USB o red) — QZ Tray no puede detectar una impresora que Windows mismo no reconoce.
• Ten claro en qué PC estás: ¿es la de caja, la de cocina, o vas a repetir esto en varias?

---

Paso 1 — Instalar QZ Tray

1. Descarga QZ Tray desde qz.io/download en la PC donde está conectada la impresora.
2. Instálalo como cualquier programa (Siguiente → Siguiente → Instalar).
3. Verás un ícono nuevo en la bandeja del sistema (abajo a la derecha, junto al reloj de Windows). Ese ícono es QZ Tray corriendo en segundo plano.

---

Paso 2 — Autorizar QZ Tray para siempre (evita el aviso molesto)

Sin este paso, cada cierto tiempo va a aparecer un aviso tipo “Untrusted website” pidiendo que aceptes manualmente — y si nadie lo acepta a tiempo, la impresión se queda esperando sin imprimir nada. Esto lo arreglas una sola vez, para siempre:

1. Click derecho en el ícono de QZ Tray (bandeja del sistema) → Advanced → Site Manager.
2. Click en el botón “+”.
3. Te va a preguntar “Create a new demo keypair for QZ Tray?” → responde Sí.
4. Te va a preguntar “Automatically install?” → responde Sí.
5. Te va a preguntar si quieres copiar el certificado a override.crt → responde Sí.

Con esto se crea automáticamente una carpeta llamada “QZ Tray Demo Cert” en el Escritorio, con 2 archivos adentro:

• digital-certificate
• private-key.pem

Esos 2 archivos son la “llave” que autoriza a este sistema a imprimir desde esta PC. Los vas a necesitar en el siguiente paso.

---

Paso 3 — Subir la llave a FactuSmart

1. Entra a FactuSmart → ícono de engranaje (⚙) → Configuraciones → pestaña Empresa.
2. Busca la tarjeta “Certificado Qz Tray”.
3. Sube el archivo digital-certificate en la casilla “Digital Certificate”.
4. Sube el archivo private-key.pem en la casilla “Private Key”.
5. Guarda.

---

Paso 4 — Probar que funcione

1. Reinicia QZ Tray (click derecho en su ícono → Exit, y vuelve a abrirlo).
2. Recarga la pantalla de Restaurante → Configuración en FactuSmart.
3. El listado desplegable de impresoras debería llenarse solo, sin pedir ningún permiso.

¿Cómo sé si QZ Tray está conectado?

Mira el ícono de QZ Tray en la bandeja del sistema: verde significa conectado y listo. Blanco o gris significa que no está corriendo — ábrelo de nuevo desde el menú de Windows.

---

¿Tienes más de una PC? (por ejemplo, caja y cocina separadas)

Si el mismo restaurante va a imprimir desde dos o más PCs (una en caja, otra en cocina), no repitas el Paso 2 generando una llave nueva en cada una — usa la misma llave ya creada:

1. En la PC donde ya hiciste el Paso 2, busca el archivo override.crt en C:\Program Files\QZ Tray\override.crt.
2. Copia ese mismo archivo a la misma ruta (C:\Program Files\QZ Tray\override.crt) en cada PC adicional.
3. Reinicia QZ Tray en esa PC.

Importante

No generes una llave nueva por cada PC — si lo haces, esa PC no va a reconocer el certificado que ya subiste a FactuSmart y va a volver a pedir autorización. Siempre copia el mismo override.crt a las PCs adicionales.

---

Algo no funciona — revisa esto

Síntoma	Qué revisar
El listado de impresoras sale vacío	¿QZ Tray está abierto (ícono verde) en esta PC? ¿La impresora está instalada en Windows en esta PC específica?
El listado sigue vacío aunque QZ Tray esté verde (conectado)	Es el permiso “Red local” de Chrome bloqueado — ver la sección de abajo
Sigue apareciendo el aviso “Untrusted website”	Repite el Paso 2 completo — probablemente no se guardó el override.crt correctamente
Funciona en la PC de caja pero no en la de cocina	Copia el override.crt de la PC de caja a la de cocina (ver sección de arriba)
No detecta una impresora térmica/matricial vieja	Ver la sección opcional al final de la guía (instalar Liberica JDK 32-bit)
Instalé el Java de la sección opcional y las comandas salen borrosas	Desinstala ese Java aparte y reinicia QZ Tray — compite con el Java que QZ Tray ya trae integrado
Sale “falta asignar una impresora” al querer imprimir una comanda	Ver la sección de abajo sobre Áreas de preparación

“Falta asignar una impresora” al imprimir una comanda

Esto pasa cuando tienes activado el toggle “Imprimir comandas por grupo” (en Restaurante → Configuración → Configuración adicional) pero alguna de tus Áreas de preparación (Cocina, Bar, Parrilla, etc.) no tiene una impresora asignada todavía.

Con ese toggle activado, cada plato imprime en la impresora de su propia área — no en una sola impresora general. Si dejas un área sin impresora asignada, todo lo que se pida de esa área va a fallar al imprimir, aunque el resto del restaurante funcione bien.

Cómo arreglarlo:

1. Ve a Restaurante → Configuración → Áreas de preparación.
2. Cualquier área marcada en rojo con la etiqueta “Sin asignar” necesita que le elijas una impresora real del dropdown.
3. Guarda con “Actualizar”.

¿No sabes cuántas áreas necesitas?

Si tu restaurante imprime todo en una sola impresora sin importar qué se pidió, probablemente no necesitas activar “Imprimir comandas por grupo” — déjalo en “No” y usa solo la “Impresora por defecto” de la pestaña Configuración adicional.

El listado de impresoras sigue vacío aunque QZ Tray esté conectado (ícono verde)

Chrome tiene un permiso llamado “Red local” que controla si una página web puede hablar con programas que corren en tu propia PC — y ahí es exactamente donde vive QZ Tray. Si ese permiso está bloqueado, FactuSmart nunca va a poder “ver” las impresoras aunque QZ Tray esté prendido y la impresora funcione perfecto para todo lo demás. Esto no tiene nada que ver con si la impresora es por cable USB o por red — el bloqueo pasa antes, en la conexión entre el navegador y QZ Tray.

Cómo arreglarlo:

1. En la pantalla de Restaurante → Configuración de FactuSmart, haz click en el ícono que está justo a la izquierda de la dirección web (un candado 🔒 o un ícono de ajustes, según la versión de Chrome).
2. Entra a “Permisos del sitio”.
3. Busca la opción “Red local” y cámbiala a “Permitir”.
4. Recarga la página (F5).

El listado de impresoras debería llenarse de inmediato. Este permiso es por navegador y por PC — si el mismo restaurante imprime desde varias computadoras, hay que repetir este paso en cada una la primera vez.

---

¿Tu impresora es antigua y sigue sin aparecer? (opcional, último recurso)

Léelo antes de hacer esto

QZ Tray ya trae su propio Java integrado — no necesita ninguno más. Instalar un Java aparte (Liberica JDK) puede ayudar a detectar una impresora térmica o matricial muy antigua, pero en un caso real terminó dañando algo peor: las comandas empezaron a salir como puras líneas borrosas e ilegibles en vez de texto, porque los dos Java (el de QZ Tray y el instalado aparte) competían entre sí. La solución en ese caso fue desinstalar el Java aparte.

Haz esto solo si de verdad no te queda otra opción, y si después de instalarlo las comandas salen borrosas, desinstala este Java y reinicia QZ Tray — eso soluciona el problema.

Solo si tu impresora es una térmica o matricial de varios años (de las que normalmente vienen con un driver “de 32 bits”) y el listado de impresoras en FactuSmart sigue vacío después de todos los pasos anteriores:

1. Entra a bell-sw.com/pages/downloads
2. Busca la sección Windows y descarga el paquete:
   • Versión: Java 21 o superior
   • Arquitectura: x86 (32-bit)
   • Paquete: “Full JDK”
3. Instala el archivo .msi descargado (Siguiente → Siguiente → Instalar).
4. Reinicia QZ Tray (click derecho en su ícono → Exit, y ábrelo de nuevo desde el menú de Windows).