Если этикетка выходит боком, сначала уберите из цепочки приложение и драйвер: отправьте на принтер минимальный формат с рамкой, подписью «TOP» и координатами. Если он печатается правильно, механика и базовая ориентация понятны, а поворот добавляет драйвер или шаблон. Если неверно уже здесь, проверяйте формат, размеры в точках и настройки самого принтера.

Ниже команды относятся к принтерам, которые понимают ZPL. Для другой модели используйте её язык и руководство: похожая кнопка в драйвере не гарантирует одинаковой семантики. Перед тестом сохраните текущую конфигурацию и не отправляйте команды сброса — ориентацию можно проверить обычной одноразовой этикеткой.

Поворот может появиться на четырёх уровнях

СлойХарактерный признакКонтрольный тест
носитель и датчиксдвиг между этикетками, печать через зазоркалибровка и configuration label
драйвер/страницаpreview верен, физическая печать повернутаraw job в обход драйвера
формат ZPLкаждая копия повёрнута одинаковоминимальный ^XA…^XZ с ^PON
отдельное полетекст боком, рамка и штрихкод верныпроверить ^FW и orientation конкретной команды

Запишите точный физический размер, направление подачи, DPI и размер шаблона в dots. Для 203 и 300 dpi одна и та же ширина в миллиметрах превращается в разное количество точек. Ошибка здесь часто выглядит как поворот: координаты уходят за печатную область, а оператор пытается «вернуть» содержимое галочкой Landscape.

Минимальный ZPL отделяет общую ориентацию от полей

^XA
^PON
^PW800
^LL400
^LH0,0
^FO20,20^GB760,360,3^FS
^FO40,40^A0N,42,42^FDTOP / X=40 Y=40^FS
^FO40,110^GB200,100,2^FS
^XZ

`^PO` задаёт ориентацию всего формата: `N` — normal, `I` — инверсия на 180 градусов. Это не команда поворота на 90 градусов. `^FW` задаёт ориентацию полей по умолчанию, а некоторые команды штрихкодов имеют собственный параметр orientation. Поэтому не добавляйте одновременно поворот страницы в Windows, `^POI` и `^FWR`: несколько преобразований маскируют первопричину.

  • `^PW` задаёт ширину печати в точках и не должен превышать возможности принтера.
  • `^LL` задаёт длину этикетки; она сверяется с фактической подачей носителя.
  • `^LH` переносит начало координат всего формата.
  • `^FO` размещает конкретное поле относительно начала координат.
  • `^FW` меняет ориентацию полей по умолчанию, но у отдельных типов полей есть свои правила.

Raw-печать и печать через драйвер сравниваются одним файлом

Сохраните минимальный ZPL как неизменяемый тестовый артефакт и отправьте его способом, который не преобразует данные в PDF или bitmap. Затем тот же макет проведите через production-путь. Если raw-результат правильный, сравните spool format, настройки Portrait/Landscape, page size и наличие «rotate 90°» в драйвере. Если оба результата неверны одинаково, вернитесь к ZPL и конфигурации принтера.

При PDF-печати добавляется ещё один слой: размер страницы PDF, автоматический поворот и масштабирование «Fit to page». Для этикеток отключите автоориентацию и проверьте печать 100%, иначе драйвер может вписать портретную страницу в альбомный носитель. Сырой файл задания и скриншот настроек сохраняйте вместе с фотографией результата.

Смещение после поворота объясняется координатами

По документации Zebra `^POI` инвертирует координаты, поэтому после поворота на 180 градусов может понадобиться другой `^LH`, чтобы вернуть печать в физическую область. Не компенсируйте это случайными отрицательными смещениями в каждом поле. Сначала задайте правильные `^PW`, `^LL` и общий home, затем расставляйте элементы.

Протокол одной пробы:
printer=ZD421d, dpi=203
media=100x50 mm, gap, feed=short-edge
source=minimal-orientation-v1.zpl
path=raw TCP 9100
^PO=N, ^PW=800, ^LL=400, ^LH=0,0
result=TOP у передней кромки, рамка целиком
next=повторить через production driver без rotation/fit

Приёмка проводится на реальном наборе форматов

  1. Распечатать configuration label и записать модель, DPI, media type и текущий язык.
  2. Проверить минимальную рамку на рабочем рулоне после штатной калибровки.
  3. Напечатать production-шаблон напрямую и через приложение, сравнить ориентацию и обрезание.
  4. Повторить на каждом поддерживаемом размере этикетки, не переиспользуя width/length вслепую.
  5. Перезагрузить принтер и повторить одну пробу, чтобы обнаружить непреднамеренно сохранённую настройку.

Исправление завершено, когда ориентация задаётся в одном выбранном слое, рамка не обрезается, текст и штрихкод читаются, а результат воспроизводится после перезапуска. Контрольный ZPL остаётся рядом с документацией интеграции: по нему новый принтер проверяется до подключения сложного шаблона.

Проверенные источники