Solución de problemas de impresión

Casi todos los problemas de impresión tienen una de cuatro causas: QZ Tray no está abierto, falta el certificado, el tamaño de papel no es el del rollo, o se está intentando imprimir desde una tableta. Revisa primero esos cuatro puntos en orden; si no es ninguno, busca tu caso abajo. Esta guía fue verificada con QZ Tray 2.2.6.

Cuando la tarjeta Impresora de Configuración → Punto de venta (/admin/settings/pos) no logra conectar, te dice exactamente por qué y qué hacer. El botón Copiar diagnóstico para soporte copia la información técnica para pegarla en tu mensaje a soporte.

Dice Desconectado y no imprime

Revisa que QZ Tray esté abierto en la barra de menús de Mac o en la bandeja del sistema de Windows, junto al reloj (puede estar bajo la flecha ^), y presiona Conectar. La conexión se cae cada vez que recargas la página; si ya tienes una impresora configurada, se reconecta sola. Si no hay ícono, abre QZ Tray desde el menú Inicio o desde Aplicaciones.

Sale un aviso de seguridad cada vez que imprimo

A esa computadora le falta el certificado del paso 2 de Instalar QZ Tray. Sigue imprimiendo si le das permiso, pero pregunta cada vez. Corre el Asistente de configuración en ese equipo y el aviso desaparece.

Instalé el certificado y sigue igual

QZ Tray solo lee el certificado cuando arranca. El instalador lo reinicia por ti, pero si al imprimir sigue saliendo el aviso, ciérralo desde su ícono (clic derecho › Exit en Windows, Quit en la barra de menús de Mac), ábrelo de nuevo y recarga la página de La Comanda.

Para confirmar que el certificado quedó en su lugar: clic derecho en QZ Tray › Advanced › Diagnostic › Browse App folder…. En esa carpeta debe existir el archivo override.crt. Si no está, vuelve a correr el instalador.

Con el certificado instalado, el aviso de QZ Tray dice Verified y basta con elegir Allow una vez; no vuelve a aparecer.

La lista de impresoras aparece vacía

La lista viene de tu sistema operativo, no de La Comanda. Instala el controlador de la impresora e imprime una página de prueba desde el sistema; en cuanto aparezca ahí, aparece aquí. Luego presiona el botón de actualizar la lista, junto a Impresora de recibos. Si ves No se encontraron impresoras, el sistema todavía no tiene ninguna instalada.

El ticket sale cortado o con el texto encimado

Es el tamaño de papel. 58mm son 32 caracteres por línea y 80mm son 48; si eliges el que no es, el texto se desborda o se queda corto. Cambia el Tamaño de papel en la tarjeta Impresora y vuelve a presionar Imprimir prueba.

Imprime símbolos raros o páginas en blanco

Casi siempre es una impresora que no es ESC/POS, o un controlador genérico que no le corresponde. Instala el controlador del fabricante para tu modelo exacto y repite la prueba. Qué impresoras sirven está en Impresoras compatibles.

No encuentro la opción en la tableta

La impresión térmica solo existe en computadoras, porque QZ Tray es un programa de escritorio; desde una tableta o un celular verás No hay impresora configurada. Puedes tomar pedidos desde la tableta y dejar que la computadora de la caja imprima, con la impresión automática o con Imprimir ticket en la pantalla de cocina.

El antivirus o el firewall bloquea QZ Tray

QZ Tray escucha de forma local en los puertos 8181, 8282, 8383 y 8484, y en 8182, 8283, 8384 y 8485. Autoriza la aplicación en tu antivirus o firewall: es tráfico dentro de la misma computadora y no sale de tu red.

Windows dice que el archivo no es seguro

Es el aviso normal de SmartScreen para archivos recién descargados, como setup-printer.bat. Presiona Más información y luego Ejecutar de todas formas. Después Windows pide permiso de administrador en el cuadro azul de Control de cuentas de usuario: presiona Sí para que el certificado se pueda copiar.

El navegador bloqueó el acceso a QZ Tray

Chrome y Edge piden permiso para que una página hable con aplicaciones de la misma computadora. Si la tarjeta muestra El navegador bloqueó el acceso a QZ Tray, ese permiso quedó negado para La Comanda:

• Si instalaste La Comanda como app, abre ⋯ › Información de la aplicación › Configuración de la aplicación.
• En una pestaña de Chrome o Edge, abre los controles del sitio junto a la barra de direcciones.

Permite Acceso a la red local o Aplicaciones y servicios en este dispositivo, recarga La Comanda y vuelve a intentar. Si el navegador te muestra ese aviso al presionar Conectar, acéptalo.

QZ Tray no responde

Si la tarjeta dice QZ Tray no responde, ningún puerto local contestó. Confirma que QZ Tray esté abierto (su ícono aparece en la bandeja del sistema o en la barra de menús) y que el antivirus o firewall no lo bloquee. Prueba también en https://demo.qz.io en esa misma computadora: si ahí tampoco conecta, el problema está en QZ Tray o en esa computadora, no en La Comanda.

No se pudo firmar la solicitud para QZ Tray

Cada impresión y cada lectura de la lista de impresoras se firma primero en el servidor de La Comanda. Si la tarjeta dice No se pudo firmar la solicitud para QZ Tray, no se envió nada a QZ Tray y no se imprimió nada. El propio aviso dice la causa:

• Tu sesión expiró: vuelve a iniciar sesión e intenta de nuevo.
• Tu cuenta no tiene un restaurante activo: vuelve a iniciar sesión e intenta de nuevo.
• El servicio de firmas no respondió desde esta dirección: puede estar caído o esa dirección no está autorizada para firmar. Copia el diagnóstico y envíalo a soporte.
• El servicio de firmas falló en el servidor o respondió algo inesperado: intenta de nuevo en un momento; si persiste, copia el diagnóstico y envíalo a soporte.

QZ Tray está abierto pero La Comanda no conecta, ni después de reinstalarlo

Es el caso que ningún ajuste del navegador arregla, y la tarjeta lo anuncia como QZ Tray tiene bloqueada a La Comanda. Síntoma: QZ Tray abierto, sin conexión, aunque ya reinstalaste QZ Tray y reiniciaste el equipo. Causa: un Block guardado en QZ Tray. Se arregla frente a esa computadora en unos cinco minutos.

Qué pasó

Cada vez que una página quiere imprimir, QZ Tray muestra un aviso de seguridad. Si en ese aviso se eligió Block con Remember this decision marcado, QZ Tray guardó la decisión en la carpeta del usuario, y desde entonces responde "Connection blocked by client" a cada intento. Reinstalar QZ Tray o reiniciar la computadora no la borra: el desinstalador limpia la carpeta del programa, no la del usuario. Se quita desde el propio QZ Tray, en menos de un minuto.

QZ Tray guarda esas decisiones por usuario:

• Windows: %APPDATA%\qz\blocked.dat y allowed.dat.
• macOS: ~/Library/Application Support/qz/.
• Linux: ~/.qz/.

Clic derecho en QZ Tray › Advanced › Diagnostic › Browse User folder… abre esa carpeta.

Pasos, en orden

1. Abre el menú de QZ Tray. Busca el ícono de QZ Tray en la bandeja del sistema, junto al reloj. Si no lo ves, haz clic en la flecha ^. Haz clic derecho sobre el ícono. Si no hay ícono, abre QZ Tray desde el menú Inicio y vuelve a buscarlo.
2. Entra a Site Manager. En el menú, entra a Advanced y luego a Site Manager…
3. Quita el bloqueo. Cambia a la pestaña Blocked. Verás la lista Sites permanently blocked from access con la entrada La Comanda (La Comanda POS). Selecciónala y presiona el botón −, o la tecla Supr. Cierra la ventana. Si la pestaña está vacía, revisa que Advanced › Block anonymous requests esté desmarcado.
4. Instala el certificado de La Comanda. En La Comanda entra a Configuración › Punto de venta › Impresora y abre el Asistente de configuración. Descarga el instalador, setup-printer.bat, y ábrelo con doble clic. En el aviso de SmartScreen presiona Más información y Ejecutar de todas formas; en el cuadro azul de Control de cuentas, Sí. Termina cuando veas "Printer setup complete". Si QZ Tray vuelve a preguntar al imprimir, ciérralo desde su ícono (clic derecho › Exit) y ábrelo de nuevo: solo lee el certificado cuando arranca.
5. Confirma que el certificado quedó en su lugar. Clic derecho en QZ Tray › Advanced › Diagnostic › Browse App folder… En esa carpeta debe aparecer el archivo override.crt.
6. Vuelve a abrir La Comanda. Cierra La Comanda por completo, ya sea la app instalada o la pestaña del navegador, y ábrela de nuevo. En Impresora presiona Conectar. Si Chrome pregunta por "Aplicaciones y servicios en este dispositivo", permítelo.
7. Si QZ Tray pregunta, elige Allow. Con el certificado instalado el aviso dice "Verified" y ya no vuelve a aparecer.
8. Imprime la prueba. Selecciona tu impresora en la lista y presiona Imprimir prueba. Sale el ticket de prueba y el estado dice Conectado.

La misma guía, con un dibujo de la ventana Site Manager, está en la página pública /impresoras/desbloqueo-qz-tray, pensada para abrirse desde un celular frente a la computadora.

Lo que no ayuda

• Borrar la carpeta completa %APPDATA%\qz. No hace falta: solo quita la entrada de la pestaña Blocked.
• Reinstalar QZ Tray otra vez. El bloqueo vive en la carpeta del usuario y sobrevive a la reinstalación.

Si Site Manager no se puede abrir

Solo en ese caso, edita el archivo a mano: cierra QZ Tray por completo (ícono › Exit), haz una copia de respaldo de %APPDATA%\qz\blocked.dat, borra únicamente la línea cuya segunda columna dice La Comanda POS, y vuelve a abrir QZ Tray. Para deshacerlo, restaura la copia.

Qué significa cada aviso de la tarjeta Impresora

Si sigue sin conectar, mándanos esto

Antes de cambiar nada más, reúne esto desde la computadora afectada y escríbenos siguiendo Contactar a soporte:

1. La versión de QZ Tray: clic derecho en el ícono › About…
2. Qué navegador usas y si abres La Comanda como app instalada o en una pestaña.
3. Una captura del aviso que muestra La Comanda al presionar Conectar.
4. El texto del botón Copiar diagnóstico para soporte, que aparece debajo del aviso en Impresora.
5. Capturas de las pestañas Allowed y Blocked de Site Manager, y si Advanced › Block anonymous requests está marcado.
6. Si https://demo.qz.io logra conectar en esa misma computadora. Usa el certificado de QZ, así que conecta aunque solo La Comanda esté bloqueada.
7. Si puedes, el registro de QZ Tray alrededor de un intento de Conectar: clic derecho › Advanced › Diagnostic › View logs (live feed)… o Zip logs (to Desktop). Las líneas que importan son "Connection blocked by client", "Denied La Comanda POS to", "Bad signature on request", "Certificate is expired" y "Server started on port(s)". Con el certificado bien instalado aparecen "Successfully chained certificate: CN=La Comanda POS" y "Adding La Comanda (La Comanda POS) to allowed list".

El diagnóstico que copia el botón incluye la dirección de la página, si La Comanda corre como app o en el navegador, el estado de los permisos del navegador, la versión de la librería de QZ Tray, el último error y el estado de la firma. No contiene contraseñas, claves ni datos de tus ventas.