Usuario

Impresora térmica con QZ Tray (de 0 a 100)

Guía para cada PC de caja: instalar QZ Tray, colocar el certificado una sola vez y configurar la impresión automática en Smartok / Smartock.

Quién la usa: administrador o quien arma las cajas del local.
Tiempo estimado: 10–15 minutos por PC.
Resultado: al cobrar, el ticket sale solo sin el popup Allow de Windows.

El certificado de plataforma lo carga Ginkgo una vez (panel de plataforma → QZ Tray). Vos solo descargás override.crt y lo ponés en la carpeta de QZ Tray.

Índice

  1. Qué necesitás
  2. Instalar QZ Tray
  3. Descargar override.crt
  4. Copiar el certificado a Program Files
  5. Configurar impresión en Smartok
  6. Probar con una venta
  7. Problemas frecuentes

1. Qué necesitás

ÍtemDetalle
PC Windows de cajaCon impresora térmica instalada (drivers Windows)
PermisosIdealmente poder escribir en C:\Program Files\QZ Tray\ (o pedir a soporte IT)
Usuario admin en SmartokPara Configuración → Preferencias POS
Certificado de plataformaYa cargado por Ginkgo (si el botón de descarga falla, avisar a soporte)

2. Instalar QZ Tray

  1. Entrá a https://qz.io/download/ e instalá QZ Tray para Windows.
  2. Al terminar, dejá que inicie con Windows.
  3. Verificá el icono en la bandeja del sistema (abajo a la derecha). Debe estar en ejecución.

QZ Tray en la bandeja de Windows

  1. Si pedís Allow la primera vez al abrir el POS, está bien solo mientras no esté el override.crt. Después de los pasos 3–4 no debería volver.

3. Descargar override.crt

En Smartok / Smartock:

  1. Andá a Configuración → Preferencias POS → sección Impresión automática.
  2. En el bloque Certificado de confianza, pulsá Descargar override.crt.
  3. Guardá el archivo (normalmente en Descargas).

También podés descargarlo desde el panel de plataforma (QZ Tray) si tenés acceso.

Configuración: Certificado de confianza y descarga de override.crt

Es el mismo archivo para todas las PCs de caja de tu plataforma. No es la clave privada: solo el certificado público.

4. Copiar el certificado a Program Files

  1. Cerrá QZ Tray por completo: clic derecho en el icono de la bandeja → Exit / Salir. (Reload no alcanza.)

  2. Abrí el Explorador de Windows y andá a:

    C:\Program Files\QZ Tray\

    (Si lo instalaste en otra carpeta, usá esa.)

  3. Copiá el archivo descargado ahí y renombralo exactamente a:

    override.crt

    (si Windows pregunta “¿reemplazar?”, sí).

Carpeta QZ Tray con override.crt

  1. Volvé a abrir QZ Tray desde el menú Inicio.
  2. Confirmá de nuevo el icono en la bandeja.

Si Windows no te deja copiar (permisos)

  1. Copiá override.crt a una carpeta tuya, p. ej. C:\qz\override.crt.

  2. En la carpeta de datos de QZ (a veces bajo ProgramData), editá qz-tray.properties y agregá:

    authcert.override=C:/qz/override.crt

  3. Reiniciá QZ Tray (Exit + abrir).

5. Configurar impresión en Smartok

Ruta: /configuracion → Preferencias POS

  1. Activá Impresión automática.
  2. Pulsá Detectar impresoras (QZ debe estar abierto).
  3. Elegí tu impresora térmica → Agregar.
  4. En esa impresora, activá al menos Ticket de venta.
  5. Guardá los cambios de configuración.
  6. Recargá la página del POS (F5).

6. Probar con una venta

  1. Abrí caja en el POS.
  2. Agregá un producto y cobrá un ticket de prueba.
  3. El ticket debe salir solo, sin popup Allow.
  4. Opcional: en Configuración usá Imprimir prueba en la impresora guardada.

7. Problemas frecuentes

SíntomaQué revisar
Sigue saliendo AllowFalta override.crt o no se reinició QZ (Exit). El nombre debe ser exacto.
No hay botón de descargaLa plataforma aún no tiene cert+clave → avisar a Ginkgo.
“QZ Tray no responde”Abrir QZ Tray; antivirus/firewall; reiniciar PC.
No lista impresorasDrivers de la térmica instalados en Windows; Detectar de nuevo.
Imprime con el botón pero no al cobrarImpresión automática OFF, o no está tildado “Ticket de venta”.
Funciona en una PC y no en otraCada PC necesita su propia copia de override.crt + QZ reiniciado.

Resumen rápido (checklist)

  • QZ Tray instalado y en bandeja
  • Descargué override.crt desde Configuración
  • Lo copié a C:\Program Files\QZ Tray\override.crt
  • Cerré QZ con Exit y lo abrí de nuevo
  • Impresión automática ON + impresora con Ticket de venta
  • Cobré un ticket de prueba sin Allow

Ver también: Primeros pasos · Cajeros y POS