Structure d'une étiquette ZPL
Une étiquette ZPL est du texte. Elle commence par ^XA et se termine par ^XZ. Entre les deux, chaque champ
est positionné avec ^FO (origine du champ), décrit par une commande de mise en forme (police, code-barres…), rempli avec ^FD
(données du champ) et fermé par ^FS (séparateur de champ).
^XA
^FO50,50^A0N,40,40^FDBonjour^FS
^XZ
Les commandes qui commencent par un accent circonflexe ^ sont des commandes de format ; celles qui commencent par un tilde ~
sont des commandes de contrôle exécutées immédiatement (par exemple ~JC pour calibrer le support). Les données des champs sont imprimées telles
qu'envoyées.
Unités : des points, pas des millimètres
Positions et tailles s'expriment en points : les mêmes coordonnées donnent des tailles physiques différentes selon la résolution de l'imprimante.
| Résolution | Points par mm | 10 mm = |
|---|---|---|
| 203 dpi | 8 | 80 points |
| 300 dpi | 11,8 | 118 points |
| 600 dpi | 23,6 | 236 points |
Définissez la largeur imprimable avec ^PW et la longueur de l'étiquette avec ^LL, en points. Pour une étiquette de
100 × 60 mm à 203 dpi : ^PW800 et ^LL480.
Texte : ^A, ^CF et ^FB
^A0N,h,wchoisit la police vectorielle 0 en orientation normale (N), de hauteurhet largeurwen points. Autres orientations :R(90°),I(180°),B(270°).^CF0,30définit une police par défaut pour les champs suivants.^FBlargeur,lignes,interligne,alignementcrée un bloc de texte avec retour à la ligne :^FB600,3,0,Lsur 3 lignes au maximum dans 600 points, aligné à gauche (Ccentré,Rà droite,Jjustifié).
^XA
^CI28
^FO40,40^A0N,36,36^FDCrème brûlée — lot A12^FS
^FO40,100^A0N,24,24^FB700,3,0,L^FDUne longue description qui revient automatiquement à la ligne dans un bloc de 700 points.^FS
^XZ
Accents et caractères non latins : ^CI28 déclare les données en UTF-8. Sans cette commande, des
caractères comme é, ü ou ç peuvent s'imprimer de façon incorrecte.
Codes-barres : Code 128, QR et DataMatrix
^BY fixe la largeur du module (la barre la plus fine, en points) et la hauteur par défaut. La commande de code-barres décrit ensuite la symbologie :
- Code 128 :
^BCN,h,Y,N,N— orientation, hauteur, texte lisible dessous (Y), texte dessus (N), clé de contrôle (N). - QR Code :
^BQN,2,m— modèle 2, grossissementm. Les données commencent par un niveau de correction et un mode de saisie, par exemple^FDQA,https://exemple.fr^FS(Q = correction « quartile », A = saisie automatique). - DataMatrix :
^BXN,h,200— taille du modulehen points, qualité 200 (ECC 200).
^XA
^BY3,3,100
^FO40,40^BCN,100,Y,N,N^FD4005-88120^FS
^FO40,200^BQN,2,6^FDQA,https://labelcross.com^FS
^FO400,200^BXN,8,200^FDLOT-2611^FS
^XZ
Pour le GS1-128 (étiquettes d'expédition et SSCC), le code-barres doit commencer par le caractère FNC1. Avec ^BC,
>; sélectionne le jeu C et >8 insère le FNC1 : voir notre guide de l'étiquette SSCC.
Traits et cadres : ^GB
^GBl,h,e trace un cadre de largeur l, hauteur h et épaisseur de trait e. Un cadre dont la hauteur
égale l'épaisseur est un trait horizontal ; dont la largeur égale l'épaisseur, un trait vertical. ^FR placé avant un champ l'imprime en
inversé (blanc sur noir) sur un cadre plein.
^XA
^FO20,20^GB760,440,3^FS
^FO20,120^GB760,3,3^FS
^FO20,20^GB760,100,100^FS
^FO40,45^A0N,50,50^FR^FDEXPÉDITION^FS
^XZ
Quantité, contraste et vitesse
^PQ10imprime 10 exemplaires de l'étiquette.~SD20règle le contraste (0 à 30) ;^PR4règle la vitesse d'impression (en pouces par seconde, dans les limites de l'imprimante).^MNYsélectionne la détection d'espace entre étiquettes,^MNMla marque noire,^MNNle support continu.~JClance un calibrage du support.
Selon la configuration de l'imprimante, les réglages envoyés avec une étiquette restent actifs jusqu'à modification ou redémarrage. Une bonne pratique consiste à garder les réglages de support et de contraste dans la configuration de l'imprimante et à n'envoyer que le contenu de l'étiquette.
Envoyer du ZPL à une imprimante
- TCP brut, port 9100 : la plupart des imprimantes d'étiquettes réseau acceptent des données brutes sur le port 9100. Tout programme
qui ouvre une connexion vers
ip-imprimante:9100et y écrit le ZPL imprime l'étiquette. - File d'impression : une file Windows avec le pilote « Générique / Texte seul », ou une file CUPS en mode brut, transmet le ZPL sans le modifier.
- Copie de fichier : certaines installations copient un fichier
.zplvers une imprimante partagée.
Pour tester une imprimante depuis macOS ou Linux : nc 192.168.1.50 9100 < etiquette.zpl.
Du ZPL à l'impression automatique
Écrire du ZPL à la main est idéal pour apprendre et déboguer, mais en production l'étiquette change à chaque commande, lot ou colis. Un serveur d'impression comme LabelCross Print permet de concevoir l'étiquette visuellement, associe les données de votre ERP ou WMS à ses variables et génère le ZPL de chaque enregistrement — sur les imprimantes Zebra et celles qui émulent le ZPL. Le même modèle s'imprime aussi sur les imprimantes Honeywell en DPL ou Fingerprint : voir ZPL, DPL ou Fingerprint.
Référence : Zebra, ZPL II Programming Guide. Les options des commandes varient légèrement selon les versions de micrologiciel ; consultez le guide de votre modèle.
Questions fréquentes
Que signifie ZPL ?
ZPL signifie Zebra Programming Language. ZPL II est la version actuelle, utilisée par les imprimantes Zebra industrielles et de bureau et émulée par des imprimantes d'autres marques.
Quelle unité le ZPL utilise-t-il pour les positions ?
Le point (dot). Pour convertir des millimètres, divisez la résolution par 25,4 : environ 8 points par mm à 203 dpi, environ 12 à 300 dpi et environ 24 à 600 dpi.
Comment imprimer des caractères accentués en ZPL ?
Ajoutez ^CI28 au début de l'étiquette pour indiquer que les données sont encodées en UTF-8, et envoyez le fichier en UTF-8.
Comment envoyer un fichier ZPL à une imprimante ?
Ouvrez une connexion TCP brute vers l'adresse IP de l'imprimante sur le port 9100 et envoyez le texte ZPL, ou copiez-le vers une file d'impression configurée en mode brut / texte générique. Un serveur d'impression comme LabelCross Print le fait pour vous.
Faut-il écrire le ZPL à la main ?
Non. Un logiciel d'étiquettes génère le ZPL à partir d'un modèle visuel. Écrire du ZPL à la main sert à comprendre, déboguer ou tester une imprimante.