Справочник команд ZPL — шпаргалка для принтеров Zebra
Обновлено 11 июня 2026 г.
Это рабочий справочник по командам ZPL II, охватывающим подавляющее большинство реальных этикеток: структура формата, текст, шрифты, штрихкоды, графика и управление принтером. Все позиции и размеры указаны в точках принтера (203 dpi = 8 точек/мм — см. Что такое ZPL? для основ). Параметры в столбце синтаксиса: x,y = позиция от верхнего левого угла, h,w = высота и ширина, o = ориентация (N — нормальная, R — 90°, I — 180°, B — 270°).
Формат этикетки
| Команда | Синтаксис | Что делает |
|---|---|---|
^XA | ^XA | Начало формата этикетки. Каждая этикетка начинается с этой команды. |
^XZ | ^XZ | Конец формата этикетки. Принтер рендерит и печатает этикетку при получении этой команды. |
^FX | ^FXcomment | Комментарий — игнорируется принтером. Завершайте его ^FS, как любое поле. |
^PW | ^PWwidth | Ширина печати в точках. Установите значение, равное ширине вашей этикетки, чтобы поля не обрезались. |
^LL | ^LLlength | Длина этикетки в точках. Необходима главным образом для непрерывных носителей (без зазора). |
^LH | ^LHx,y | Начало координат этикетки — смещает начало для всех последующих позиций ^FO. |
^PQ | ^PQqty | Количество копий — сколько копий данной этикетки напечатать. |
^PR | ^PRspeed | Скорость печати в дюймах в секунду. Меньшая скорость часто даёт более тёмный и чёткий отпечаток. |
^MD | ^MDdarkness | Настройка темноты носителя, от -30 до 30. Увеличьте, если печать слабая. |
Поля и текст
| Команда | Синтаксис | Что делает |
|---|---|---|
^FO | ^FOx,y | Начало поля — позиционирует следующее поле в точке x,y от начала координат этикетки. |
^FD | ^FDdata | Данные поля — содержимое (текст или данные штрихкода) текущего поля. |
^FS | ^FS | Разделитель поля — закрывает текущее поле. Обязателен после каждого поля. |
^FB | ^FBwidth,lines,space,align | Блок поля — переносит текст ^FD в блок: максимальная ширина, максимальное число строк, межстрочный интервал, выравнивание (L/C/R/J). |
^FR | ^FR | Инверсия поля — печатает поле белым по чёрному там, где оно перекрывает чёрную область. |
^FH | ^FH | Шестнадцатеричное поле — разрешает _xx-эскейпы в ^FD, например _C3_A9 для é. |
^CI | ^CIencoding | Кодировка символов; ^CI28 выбирает UTF-8 и рекомендуется для любого не-ASCII текста. |
Шрифты
| Команда | Синтаксис | Что делает |
|---|---|---|
^A | ^Afo,h,w | Шрифт для следующего поля: буква шрифта f (0–9, A–Z), ориентация, высота и ширина в точках. ^A0N,40,40 — масштабируемый шрифт по умолчанию высотой 40 точек. |
^CF | ^CFf,h,w | Изменяет шрифт по умолчанию для всех последующих полей, у которых не задан собственный ^A. |
^A@ | ^A@o,h,w,name | Использует файл шрифта, сохранённый на принтере (например, загруженный TrueType). |
Шрифт 0 — масштабируемый векторный шрифт и стандартный выбор; шрифты A–H — растровые шрифты фиксированного размера, корректно выглядящие только при нативных размерах или их целых кратных.
Штрихкоды
| Команда | Синтаксис | Что делает |
|---|---|---|
^BY | ^BYw,r,h | Параметры штрихкода по умолчанию: ширина модуля (узкой полосы) в точках, соотношение широкой полосы к узкой, высота по умолчанию. Задаётся перед командой штрихкода. |
^BC | ^BCo,h,f,g,e,m | Code 128 — основной одномерный штрихкод для доставки и логистики. f=Y печатает строку для считывания человеком, g=Y печатает её над кодом. |
^B3 | ^B3o,e,h,f,g | Code 39 — устаревшая одномерная символика, по-прежнему требуемая некоторыми промышленными и оборонными спецификациями. |
^BE | ^BEo,h,f,g | Розничный штрихкод EAN-13 (для UPC-A используйте ^BU). |
^BQ | ^BQa,model,mag,ec | QR-код. Увеличение 1–10 задаёт размер модуля; ec задаёт коррекцию ошибок (H/Q/M/L). Перед данными укажите режим кодирования, например ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — компактный двумерный код, широко используемый на этикетках электроники и в здравоохранении. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — стековый двумерный код, применяемый в удостоверениях личности и некоторых логистических документах. |
Для сканируемого штрихкода соблюдайте три условия: ширина модуля (^BY первый параметр) не менее 2–3 точек при 203 dpi, тихая зона ~10 ширин модуля пустого пространства с каждой стороны, и достаточная высота (одномерный штрихкод высотой менее ~50 точек сложно считать ручными сканерами).
Графика
| Команда | Синтаксис | Что делает |
|---|---|---|
^GB | ^GBw,h,t,c,r | Прямоугольник: ширина, высота, толщина рамки, цвет (B/W), скругление углов 0–8. Тонкий ^GB используется для рисования линий. |
^GC | ^GCd,t,c | Окружность с диаметром d и толщиной рамки t. |
^GD | ^GDw,h,t,c,o | Диагональная линия внутри прямоугольника w×h; o задаёт направление (L или R). |
^GF | ^GFa,b,c,d,data | Графическое поле — встраивает растровое изображение (например, логотип) непосредственно в этикетку в виде шестнадцатеричных или двоичных данных. |
~DG | ~DGd:name,t,w,data | Загрузка графики — сохраняет изображение в памяти принтера; затем можно разместить его с помощью ^XG. |
^XG | ^XGd:name,mx,my | Вставка сохранённой графики в текущей позиции поля с масштабированием по x/y. |
Управление принтером и статус
| Команда | Синтаксис | Что делает |
|---|---|---|
~HS | ~HS | Статус хоста — принтер отвечает информацией о наличии бумаги, паузе, буфере и одометре. |
~HI | ~HI | Идентификация хоста — модель, версия прошивки, DPI и память. |
^MM | ^MMmode | Режим печати: T — отрыв, P — отклейка, R — перемотка, C — резак. |
^MN | ^MNtype | Отслеживание носителя: Y — обнаружение зазора/перфорации, M — чёрная метка, N — непрерывный. |
~JC | ~JC | Запуск калибровки носителя (принтер протягивает несколько этикеток для обнаружения зазора). |
~JA | ~JA | Отмена всех форматов этикеток в буфере принтера. |
^JUS | ^JUS | Сохранение текущих настроек во флэш-памяти для сохранения после выключения питания. |
Всё вместе
Типичная транспортная этикетка 4×6 с использованием большинства приведённых выше групп:
^XA
^PW812
^CI28
^CF0,32
^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS
^FO40,230^GB732,3,3^FS
^FO40,260^FDOrder #A-10592 / 3 of 4^FS
^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZРучное редактирование координат в точках быстро надоедает — каждая правка компоновки означает изменение чисел и повторную печать. Если вы предпочитаете перетаскивать поля на нужное место и позволить ZPL генерироваться самому, редактор ZPLCraft ниже компилирует визуальный холст именно в такой чистый ZPL и может печатать из браузера через USB.
Для исчерпывающего описания каждого параметра за пределами этой шпаргалки авторитетный источник — официальное Руководство по программированию ZPL II компании Zebra, доступное бесплатно на сайте поддержки Zebra.