Configurer une imprimante d'étiquettes Zebra sur un Mac (ZD421 et similaires)

Vous pouvez imprimer les étiquettes d'expédition QrX sur une imprimante d'étiquettes Zebra, comme la Zebra ZD421, depuis un Mac, y compris les Mac avec puce Apple (M1, M2, M3, M4 et plus récents). Zebra ne propose pas de pilote Mac séparé et vous n'avez pas besoin d'un pilote payant d'un tiers : macOS inclut déjà le pilote Zebra ZPL Label Printer. Vous ajoutez d'abord l'imprimante sur le Mac, puis vous la connectez à QrX via PrintNode.

Étape 1 : ajouter l'imprimante sur votre Mac

Branchez l'imprimante Zebra avec un câble USB, ou connectez-la au même réseau que votre Mac, puis allumez-la.
Ouvrez Réglages Système > Imprimantes et scanners et cliquez sur Ajouter une imprimante, un scanner ou un fax.
USB : sélectionnez l'imprimante Zebra dans la liste (une ZD421 apparaît par exemple comme ZTC ZD421-203dpi ZPL).
Réseau : ouvrez l'onglet IP, saisissez l'adresse IP de l'imprimante et choisissez le protocole HP Jetdirect - Socket.
Dans Utiliser, choisissez Sélectionner le logiciel, recherchez Zebra et choisissez Zebra ZPL Label Printer. N'utilisez pas AirPrint, Generic PostScript ou Generic PCL : les étiquettes sortiraient vides ou illisibles.
Cliquez sur Ajouter.

Étape 2 : régler la taille d'étiquette sur 4 x 6

Le pilote Zebra pour macOS démarre avec un format d'étiquette de 4 x 5 pouces. Les étiquettes d'expédition font 4 x 6 pouces : modifiez donc le format par défaut une fois dans l'app Terminal.

Ouvrez Terminal et exécutez lpstat -p. Notez le nom de votre imprimante Zebra, par exemple Zebra_ZD421.
Exécutez sudo lpadmin -p Zebra_ZD421 -o PageSize-default=w288h432 avec le nom de votre imprimante. Saisissez le mot de passe de votre Mac si demandé (rien ne s'affiche pendant la saisie). w288h432 est le nom du format 4 x 6 pouces dans le pilote.
Uniquement pour le modèle 300 dpi, exécutez aussi sudo lpadmin -p Zebra_ZD421 -o Resolution-default=300dpi. Une ZD421 standard imprime en 203dpi, déjà la valeur par défaut.
Après l'étape 3, imprimez une étiquette depuis QrX pour vérifier que l'étiquette 4 x 6 complète s'imprime.

Étape 3 : connecter l'imprimante à QrX avec PrintNode

Installez le client PrintNode pour Mac et connectez-vous avec votre compte PrintNode. Sur un Mac avec puce Apple, macOS peut demander d'installer Rosetta la première fois ; acceptez.
Vérifiez que l'imprimante Zebra apparaît dans le client PrintNode.
Dans PortalX, allez dans Settings > Preferences > Printing et cliquez sur Load Printers (charger les imprimantes).
Choisissez la Zebra comme Default Label Printer (imprimante d'étiquettes par défaut) et réglez le Default Label Paper Format (format de papier d'étiquette par défaut) sur PDF 4x6.
Imprimez une étiquette depuis la liste Transactions pour vérifier.

Utilisez PDF 4x6 sur un Mac. Le pilote Zebra convertit le PDF pour l'imprimante. Le format ZPL 4x6 (Zebra) envoie du code imprimante brut et ne fonctionne qu'avec une file d'impression raw. Pour en créer une, exécutez lpstat -v dans Terminal pour voir l'adresse de votre imprimante, puis lpadmin -p Zebra_Raw -E -v "<adresse de l'imprimante>" -m raw, et choisissez Zebra_Raw dans PortalX. Gardez la file normale pour tout le reste.

Problèmes courants

Les étiquettes sont coupées, ou une étiquette vierge sort après chaque étiquette : la taille d'étiquette n'est pas 4 x 6. Refaites l'étape 2. Si l'imprimante saute encore des étiquettes, calibrez-la : sur une ZD421, maintenez Pause et Cancel enfoncés ensemble pendant deux secondes.
L'imprimante imprime des lignes de code au lieu d'une étiquette : le format de papier est ZPL 4x6 sur une file normale. Passez à PDF 4x6, ou utilisez une file raw comme décrit ci-dessus.
L'imprimante n'apparaît pas dans PortalX : vérifiez que le client PrintNode est lancé et affiche l'imprimante, puis cliquez à nouveau sur Load Printers.
L'impression est trop claire : augmentez la densité quelques crans à la fois, par exemple sudo lpadmin -p Zebra_ZD421 -o Darkness-default=20 (valeurs de 1 à 30).
Le format d'étiquette n'a pas changé : vérifiez le nom de l'imprimante avec lpstat -p et relancez la commande de l'étape 2 avec exactement ce nom.

Quand contacter notre équipe support

Contactez QrX lorsque l'imprimante imprime une page de test correcte depuis le Mac et apparaît en ligne dans PrintNode, mais que les tâches envoyées par QrX échouent toujours dans la Print Queue, ou lorsqu'une étiquette de transporteur s'imprime au mauvais format alors que la taille d'étiquette est réglée sur 4 x 6.