Come configurare la stampante termica su Windows
Ecco come installare il software QZ Tray su Windows
Ecco una guida rapida su come installare QZ Tray su Windows.
Vediamo come fare!
Prima di iniziare, controlla questi 4 step:
1. Usa Chrome come browser (QZ Tray non funziona su altri browser).
2. Imposta formato ZPL come default da Corrieri > Modifica per ogni corriere connesso.
3. Crea una spedizione manuale di test seguendo questa guida.
4. Installa ultimo aggiornamento Java da questo link: https://www.java.com/it/download/win10.jsp
Verifica che la stampante sia compatibile con il metodo di stampa ZPL, qualora non lo fosse puoi impostare i Corrieri scelti con metodo di stampa PDF.
1. Scarica QZ Tray
Da Ordini > Etichette generate, seleziona l'etichetta creata in ZPL e fai click sul primo pulsante blu Stampa etichette > Stampa su Zebra.
Nota: se il tasto Stampa su Zebra non è cliccabile significa che l'etichetta è in PDF.
Dovrai ricontrollare il formato selezionato da Corrieri > Modifica e creare una nuova etichetta.
-
Fai click su Scarica QZ Tray per avviare automaticamente il download.
Attenzione: se non visualizzi immediatamente Scarica QZ Tray o Riconnetti, attendi qualche istante affinché la connessione a QZ Tray possa caricarsi correttamente.
-
Una volta completato, fai clic sul file scaricato e avvia l'installazione.
-
Se non l'hai ancora fatto, QZ Tray ti chiederà di installare l'ultima versione di Java da questo link. In questo caso dovrai interrompere installazione e riavviarla dopo aver aggiornato Java, facendo nuovamente click sul file scaricato.
-
Una volta completato, potrai aggiornare la pagina Ordini Spediti, selezionare gli ordini e cliccare su Stampa etichette > Stampa su Zebra > Stampa.
Ricorda di impostare Automatically start cliccando con tasto destro sull'icona di QZ Tray nella barra degli strumenti, in questo modo si avvierà automaticamente ad ogni accensione del PC.
2. Come stampare più etichette in ZPL
-
Per stampare più etichette ZPL, seleziona gli ordini che desideri stampare e fai click su Stampa etichette > Stampa su Zebra.
-
Dalla finestra che compare, fai click su Stampa. Se vuoi selezionare una stampante diversa, clicca su Impostazioni e seleziona la stampante che vuoi adottare.
Ricorda che puoi ancora stampare le tue etichette ZPL in PDF selezionando gli ordini e cliccando su Stampa etichette > Stampa in PDF.
3. Come stampare le etichette ZPL singolarmente 🖨️
Per stampare le etichette ZPL singolarmente, basta fare click sull'icona sotto Documentazione:

Stai riscontrando Errore QZ TRAY INVALID SIGNATURE o EXPIRED CERTIFICATE? Non preoccuparti! Verifica qui come puoi risolverlo.
Nota: QZ Tray è un'applicazione singleton e non può supportare più istanze simultanee sulla stessa macchina perché QZ Tray utilizza una connessione websocket localhost (wss://) dal browser a una singola porta del PC. Se fosse consentita una seconda istanza di QZ Tray, il websocket riuscirebbe a collegarsi solo alla prima porta disponibile, rendendo inutile la seconda istanza.
Esistono stampanti consigliate compatibili con ShippyPro?
Al momento non ci sono stampanti che consigliamo in modo specifico, poiché la scelta è fortemente influenzata dal tipo e dalla quantità di etichette che si intende realizzare.
Tuttavia, ShippyPro supporta la stampa ZPL, quindi una stampante Zebra può essere una buona scelta.
Modelli come GK420t o GK420d sono già utilizzati da molti utenti di ShippyPro, quindi puoi provare con uno di questi.
4. Errori
❓ QZ Tray non si apre, si disconnette o non mostra stampanti?
Non riesci ad aprire QZ Tray o non vedi le stampanti in ShippyPro? Ecco i controlli da provare e i risultati da raccogliere se il problema continua.
Per l'installazione, segui le istruzioni per Windows riportate sopra oppure la guida per Mac. Per scaricare QZ Tray e stampare le etichette, consulta Come stampare le Etichette in ZPL.
Controlla Chrome e l'autorizzazione del sito
- Aggiorna Google Chrome.
- Apri ShippyPro in Chrome.
- Clicca su View site information a sinistra dell'URL.
- Se disponibile, attiva App dispositivo, chiamata App on device nell'interfaccia inglese.
- Aggiorna la pagina di ShippyPro.
- Controlla nuovamente le stampanti disponibili.
Questa autorizzazione permette a QZ Tray di comunicare con le stampanti locali. Se non la trovi, includi questo dettaglio nella segnalazione del problema.
Se QZ Tray non si avvia o la connessione continua a non funzionare
- Se QZ Tray non si apre, disinstallalo.
- Reinstalla QZ Tray seguendo la guida di configurazione indicata sopra.
- Svuota la cache di Chrome se il problema di connessione persiste.
- Prova ShippyPro in una finestra in incognito di Chrome.
Confronta il rilevamento delle stampanti nella demo di QZ Tray
- Apri https://demo.qz.io e prova il rilevamento delle stampanti.
- Verifica se le stampanti compaiono in ShippyPro.
- Annota se le stampanti compaiono in entrambi, solo nella demo o in nessuno dei due.
📌 Nota: Stampare un PDF dal browser non conferma che QZ Tray sia connesso. Se le stampanti compaiono nella demo ma non in ShippyPro, segnala questa differenza all'Assistenza.
Chiedi all'amministratore di controllare i software di sicurezza
Firewall, antivirus o altri software di sicurezza potrebbero interferire con la connessione. Chiedi al tuo amministratore IT di verificare eventuali blocchi prima di modificare le impostazioni di sicurezza. Nei casi segnalati non è stato confermato che il firewall fosse la causa.
⚠️ Importante: Non lasciare le protezioni di sicurezza disattivate. I controlli e le modifiche alla configurazione di sicurezza devono essere gestiti dal tuo amministratore.
Raccogli gli errori della Console di Chrome per l'Assistenza
- Apri ShippyPro in Chrome.
- Premi F12 per aprire gli strumenti per sviluppatori.
- Seleziona Console.
- Prova nuovamente a connettere QZ Tray.
- Acquisisci screenshot degli errori di connessione, inclusi eventuali errori WebSocket o CORS.
Se il problema continua, scrivi al nostro Team di Assistenza. Includi i controlli effettuati, i risultati del rilevamento delle stampanti nella demo e in ShippyPro, uno screenshot dell'autorizzazione di Chrome attivata se disponibile e gli screenshot della Console. Se QZ Tray non si apre, aggiungi un video che mostri cosa succede quando provi ad avviarlo.
Questi controlli aiutano a indagare il problema, ma non risolvono tutti i casi. Per altri problemi di stampa delle etichette, consulta Come risolvere i problemi relativi alla stampa delle etichette di spedizione.