Język ZPL – kompletny poradnik dla początkujących [Komendy + Przykłady 2025]
Naucz się programować etykiety w języku ZPL! Kompletny poradnik po polsku: podstawowe komendy, kody kreskowe, czcionki, ramki i praktyczne przykłady gotowe do użycia.
Zespół Serwis Zebra
Certyfikowani technicy Zebra
![Język ZPL – kompletny poradnik dla początkujących [Komendy + Przykłady 2025]](/_next/image?url=%2Fblog%2Fjezyk-zpl-programowanie-etykiet-zebra.jpeg&w=1920&q=80&dpl=dpl_8fLuaT7pkebHuXh6MhABBAp29z3J)
# Język ZPL – kompletny poradnik programowania etykiet Zebra
📋 Chcesz programować etykiety na drukarkach Zebra? ZPL (Zebra Programming Language) pozwala tworzyć etykiety z tekstem, kodami kreskowymi i grafiką bezpośrednio z kodu. Ten poradnik nauczy Cię podstaw – od pierwszej etykiety po zaawansowane szablony.
Co znajdziesz w tym poradniku?
| Temat | Opis |
|---|---|
| Podstawy ZPL | Struktura formatu, pierwsze komendy |
| Komendy tekstowe | Czcionki, pozycjonowanie, orientacja |
| Kody kreskowe | Code 39, Code 128, QR, DataMatrix |
| Grafika | Ramki, linie, prostokąty |
| Szablony | Zapisywanie i wywoływanie formatów |
| Troubleshooting | Najczęstsze błędy i rozwiązania |
1. Czym jest język ZPL?
ZPL (Zebra Programming Language) to język programowania stworzony przez Zebra Technologies do projektowania etykiet na drukarkach termicznych.
Dlaczego warto poznać ZPL?
| Zaleta | Opis |
|---|---|
| Automatyzacja | Generuj etykiety z ERP, WMS lub własnej aplikacji |
| Precyzja | Pełna kontrola nad każdym elementem etykiety |
| Szybkość | ZPL przetwarzany bezpośrednio przez drukarkę |
| Uniwersalność | Działa na wszystkich drukarkach Zebra |
Wskazówka: ZPL działa na drukarkach ZD420, ZD620, ZT410, ZT610, GK420, GC420 i wielu innych modelach Zebra.
2. Podstawowa struktura formatu ZPL
Każda etykieta w ZPL ma prostą strukturę:
^XA ← początek formatu
... komendy ...
^XZ ← koniec formatuTwoja pierwsza etykieta
^XA
^FO50,50
^ADN,36,20
^FDHello World^FS
^XZCo oznaczają te komendy?
| Komenda | Znaczenie |
|---|---|
| ^XA | Start formatu etykiety |
| ^FO50,50 | Pozycja pola (50 punktów od lewej, 50 od góry) |
| ^ADN,36,20 | Czcionka D, normalna orientacja, wysokość 36, szerokość 20 |
| ^FDHello World^FS | Dane do wydruku + koniec pola |
| ^XZ | Koniec formatu etykiety |
WAŻNE: Każdy format MUSI zaczynać się od ^XA i kończyć ^XZ!
3. Najważniejsze komendy ZPL
Komendy strukturalne
| Komenda | Opis | Przykład |
|---|---|---|
| ^XA | Początek formatu | ^XA |
| ^XZ | Koniec formatu | ^XZ |
| ^FO | Pozycja pola (x,y) | ^FO100,200 |
| ^FD | Dane do wydruku | ^FDTekst^FS |
| ^FS | Koniec pola | ^FS |
Komendy czcionek
| Komenda | Opis | Przykład |
|---|---|---|
| ^A | Wybór czcionki | ^ADN,36,20 |
| ^A0 | Czcionka skalowalna | ^A0N,50,50 |
| ^CF | Domyślna czcionka | ^CFD,30,20 |
Dostępne czcionki: A, B, C, D, E, F, G, H, 0 (skalowalna)
Orientacje: N (0°), R (90°), I (180°), B (270°)
Komendy kodów kreskowych
| Komenda | Typ kodu | Przykład |
|---|---|---|
| ^B3 | Code 39 | ^B3N,N,100,Y,N |
| ^BC | Code 128 | ^BCN,100,Y,N,N |
| ^BQ | QR Code | ^BQN,2,5 |
| ^BX | Data Matrix | ^BXN,5,200 |
| ^BE | EAN-13 | ^BEN,100,Y,N |
| ^B8 | EAN-8 | ^B8N,100,Y,N |
Komendy graficzne
| Komenda | Opis | Przykład |
|---|---|---|
| ^GB | Prostokąt/linia | ^GB200,100,3^FS |
| ^GD | Linia ukośna | ^GD100,100,3,B^FS |
| ^GC | Okrąg | ^GC100,3^FS |
4. Praktyczne przykłady ZPL
Przykład 1: Etykieta adresowa
^XA
^FO50,50^ADN,36,20^FDJan Kowalski^FS
^FO50,100^ADN,36,20^FDul. Przykładowa 123^FS
^FO50,150^ADN,36,20^FD00-001 Warszawa^FS
^XZPrzykład 2: Etykieta z kodem kreskowym Code 39
^XA
^FO50,50^ADN,36,20^FDProdukt ABC^FS
^FO50,100^B3N,N,100,Y,N^FD123456789^FS
^XZParametry ^B3:
| Parametr | Wartość | Znaczenie |
|---|---|---|
| 1 | N | Orientacja normalna |
| 2 | N | Bez check digit |
| 3 | 100 | Wysokość kodu (punkty) |
| 4 | Y | Pokaż interpretację |
| 5 | N | Bez tekstu nad kodem |
Przykład 3: Etykieta z kodem QR
^XA
^FO50,50^ADN,36,20^FDSkanuj kod QR:^FS
^FO50,100^BQN,2,5^FDQA,https://serwis-zebry.pl^FS
^XZWskazówka: Prefix "QA," przed danymi w ^BQ oznacza tryb alfanumeryczny.
Przykład 4: Ramka wokół tekstu
^XA
^FO50,50^GB300,150,3^FS
^FO70,80^ADN,36,20^FDZAWARTOŚĆ^FS
^FO70,120^ADN,36,20^FDETYKIETY^FS
^XZParametry ^GB: szerokość, wysokość, grubość linii
Przykład 5: Etykieta magazynowa
^XA
^FO30,30^GB360,200,2^FS
^FO30,30^GB360,50,2^FS
^FO50,40^A0N,30,30^FDLOKALIZACJA:^FS
^FO200,40^A0N,30,30^FDA-15-3^FS
^FO50,100^BCN,80,Y,N,N^FD123456789012^FS
^XZ5. Komendy kontrolne
Prędkość druku
^PR4Ustawia prędkość 4 cale/sekundę (zakres: 2-12 zależnie od drukarki)
Ilość kopii
^PQ3Drukuje 3 kopie etykiety
Numeracja seryjna
^XA
^FO50,50^ADN,36,20^FDNumer:^FS
^FO150,50^ADN,36,20^SN001,1,Y^FS
^PQ5
^XZWynik: 001, 002, 003, 004, 005
Wskazówka: ^SN001,1,Y – start od 001, inkrement 1, z zerami wiodącymi (Y)
6. Zapisywanie i wywoływanie szablonów
Zapisanie szablonu
^XA
^DFR:SZABLON.ZPL^FS
^FO50,50^GB300,200,2^FS
^FO70,70^A0N,40,40^FN1^FS
^FO70,130^BCN,80,Y,N,N^FN2^FS
^XZ| Komenda | Znaczenie |
|---|---|
| ^DF | Download Format – zapisuje szablon |
| ^FN1, ^FN2 | Pola zmienne (Field Number) |
Wywołanie szablonu
^XA
^XFR:SZABLON.ZPL^FS
^FN1^FDProdukt XYZ^FS
^FN2^FD5901234123457^FS
^XZWAŻNE: Szablon wysyłasz raz, potem tylko dane – oszczędność czasu!
7. Rozdzielczość i jednostki
| Rozdzielczość | Punktów/mm | Punktów/cal |
|---|---|---|
| 200 dpi | 8 | 200 |
| 300 dpi | 12 | 300 |
| 600 dpi | 24 | 600 |
Przelicznik dla 200 dpi:
- 1 cal = 200 punktów
- 1 mm ≈ 8 punktów
- 1 cm ≈ 80 punktów
8. Częste błędy i rozwiązania
Problem: Etykieta się nie drukuje
| Sprawdź | Rozwiązanie |
|---|---|
| Brak ^XA/^XZ | Dodaj ^XA na początku i ^XZ na końcu |
| Brak ^FS | Każde pole musi kończyć się ^FS |
| Pozycja poza etykietą | Sprawdź wartości ^FO |
Problem: Tekst za mały/duży
^ADN,36,20 ← standardowy rozmiar
^ADN,72,40 ← podwójna wielkość
^ADN,18,10 ← najmniejszyProblem: Kod kreskowy się nie skanuje
| Przyczyna | Rozwiązanie |
|---|---|
| Za mała wysokość | Zwiększ do min. 100 punktów |
| Brak marginesu | Dodaj 10+ punktów odstępu |
| Złe dane | Sprawdź format dla typu kodu |
9. Narzędzia do pracy z ZPL
| Narzędzie | Opis |
|---|---|
| Zebra Setup Utilities | Wysyłanie plików ZPL na drukarkę |
| ZebraDesigner | Projektowanie etykiet z eksportem do ZPL |
| Labelary.com | Podgląd etykiet ZPL online (bez drukarki!) |
| VS Code / Notatnik | Edycja kodu ZPL |
Wskazówka: Na labelary.com/viewer.html możesz testować kod ZPL bez drukarki!
10. Podsumowanie – ściągawka ZPL
| Kategoria | Komendy |
|---|---|
| Struktura | ^XA, ^XZ, ^FO, ^FD, ^FS |
| Czcionki | ^A, ^A0, ^CF |
| Kody kreskowe | ^B3, ^BC, ^BQ, ^BX, ^BE |
| Grafika | ^GB, ^GD, ^GC |
| Kontrola | ^PQ, ^PR, ^SN |
| Szablony | ^DF, ^XF, ^FN |
Potrzebujesz pomocy z ZPL?
Masz problem z zaprogramowaniem etykiety? Kod nie działa jak powinien?
📞 Zadzwoń: +48 601 619 898
✉️ Napisz: Formularz kontaktowy
Jako autoryzowany serwis Zebra pomożemy Ci:
- Zaprojektować szablon etykiety w ZPL
- Zdiagnozować problemy z drukiem
- Zintegrować drukarkę z systemem ERP/WMS
- Przeszkolić zespół z obsługi ZPL
![Jak zaktualizować firmware drukarki Zebra? Instrukcja krok po kroku [2026]](/_next/image?url=%2Fblog%2Fjak-zaktualizowac-firmware-drukarki-zebra.jpeg&w=1920&q=70&dpl=dpl_8fLuaT7pkebHuXh6MhABBAp29z3J)
![Zebra Setup Utilities – jak skonfigurować drukarkę? Kompletny poradnik [2026]](/_next/image?url=%2Fblog%2Fzebra-setup-utilities-jak-skonfigurowac-drukarke.jpeg&w=1920&q=70&dpl=dpl_8fLuaT7pkebHuXh6MhABBAp29z3J)
![Jak skonfigurować drukarkę Zebra przez Ethernet? Kompletny przewodnik sieciowy [2026]](/_next/image?url=%2Fblog%2Fjak-skonfigurowac-drukarke-zebra-przez-ethernet.jpeg&w=1920&q=70&dpl=dpl_8fLuaT7pkebHuXh6MhABBAp29z3J)
