Come creare un codice QR in ZPL
Scopri come generare un codice QR affidabile con Zebra Programming Language (ZPL), scegliere dimensione e correzione degli errori e testare l’etichetta prima della produzione.
Cosa contiene un QR code ZPL
Un QR code memorizza testo in una matrice bidimensionale. Su un’etichetta è spesso un URL, un identificativo prodotto o un dato di tracciamento. ZPL invia le istruzioni e la stampante crea i moduli.
Il comando ^BQ crea il simbolo QR. Definisce orientamento, modello e ingrandimento, mentre ^FD fornisce i dati. Inizia con un contenuto breve e lascia una zona bianca attorno al simbolo.
Sintassi di base di ^BQ
Nell’esempio ^FO posiziona il simbolo, ^BQN seleziona il QR, 2 sceglie il modello comune e 6 è l’ingrandimento. Il prefisso LA attiva la correzione automatica per i dati seguenti.
^FS chiude il campo e ^XZ termina il formato. Mantieni separati i comandi durante il debug per distinguere posizione e dati non validi.
^XA
^FO60,60^BQN,2,6^FDLA,https://editorzpl.com^FS
^XZScegliere dimensione, DPI e correzione
I moduli sono punti di stampa, quindi lo stesso ingrandimento produce dimensioni fisiche diverse a 203, 300 e 600 DPI. Abbina il DPI del visualizzatore a quello della stampante.
Lascia una zona bianca libera su ogni lato. Una correzione maggiore tollera danni ma rende il simbolo più denso. Aumenta la dimensione prima di ridurre la zona bianca.
Preparare i dati prima della codifica
URL, testo e identificativi funzionano bene. Usa l’indirizzo HTTPS definitivo e mantienilo breve. Per Wi-Fi, vCard o altri formati, genera il payload esatto richiesto.
Non inserire caratteri di controllo o ritorni a capo accidentali in ^FD. Prova accenti e valori lunghi con lo stesso firmware e la stessa code page della produzione.
Apri il generatore QRVisualizzare e stampare un campione
Incolla l’esempio nel visualizzatore ZPL, scegli dimensione fisica e DPI. L’anteprima controlla posizione e densità, ma non dimostra la lettura dell’inchiostro stampato.
Stampa un campione e scansiona con due dispositivi. Controlla contrasto, zona bianca, orientamento e valori brevi e lunghi. Se fallisce, aumenta l’ingrandimento e rivedi i dati.
Problemi QR comuni in ZPL
Un QR illeggibile è spesso troppo piccolo, denso, poco contrastato o tagliato dal bordo. Anche zona bianca insufficiente, rotazione errata o DPI diverso possono causare il problema.
Se la stampante rifiuta il comando, verifica il supporto a ^BQ del firmware e che il formato inizi con ^XA e finisca con ^XZ. Usa un URL breve come campione di controllo.
Domande frequenti
Quale comando ZPL crea un QR code?
Usa ^BQ. Definisce il simbolo QR e usa ^FD per i dati codificati.
Cosa significa ^BQN,2,6?
N indica orientamento normale, 2 seleziona il modello QR 2 e 6 è l’ingrandimento in punti.
Un QR può contenere un URL o testo?
Sì. Inserisci il contenuto dopo il prefisso LA in ^FD, mantienilo breve e prova il valore di produzione.
Perché il mio QR ZPL non viene letto?
Controlla dimensione, zona bianca, contrasto, DPI, rotazione e lunghezza e stampa un campione reale.
Guide correlate
Riferimenti ufficiali
Riferimenti verificati il 4 ottobre 2026. Illustrazione generata dall’IA di una stampante termica generica.
Informazioni sull'autore
Eduard Diaz
Eduard Diaz è tecnico IT (sviluppo) presso S-IE, partner ufficiale Zebra con oltre 20 anni nei servizi di identificazione ed etichettatura. Sviluppa e mantiene EditorZPL per rendere più facile il lavoro con ZPL e le stampanti di etichette Zebra.
s-ie.cat