Печать ZPL-этикеток на принтерах Zebra
CloudPrint может передать ZPL на Zebra как RAW-данные, если найденная очередь объявила профиль ZPL и RAW passthrough. До production проверьте конкретную модель, DPI, носитель и драйвер.
Проверьте найденный принтер
В GET /api/v1/printers изучите capabilities.language_profiles, supported_dpi, носители и endpoint.raw_passthrough_available. Название Zebra само по себе не доказывает, что системная очередь принимает RAW ZPL.
Подготовьте минимальный ZPL
^XA
^PW812
^LL1218
^FO40,40^A0N,40,40^FDCloudPrint test^FS
^FO40,110^BCN,120,Y,N,N^FDORDER-18452^FS
^XZ^PW и ^LL задаются в точках — рассчитайте их для реальной этикетки и 203/300 DPI. Шрифты, кодировку, графику и штрихкоды проверяйте на физическом устройстве.
Загрузите и направьте ZPL
Укажите document_format=raw и document_raw_language=zpl, затем создайте задание для совместимого printer_id. Если отправить эти байты как PDF, забыть язык RAW или выбрать PDF-only очередь, API вернёт ошибку — автоматической конвертации нет.
Настройте устройство
Откалибруйте датчик носителя и установите ширину, darkness и скорость в принтере или драйвере. Слишком высокая darkness расширяет полосы штрихкода и ухудшает чтение. Сохраняйте утверждённый профиль носителя и DPI в настройке рабочего места.
Диагностируйте результат
При failed соберите print_job_id, X-Request-Id, причину, драйвер, тип подключения и capabilities. При сдвиге или пустой этикетке сначала локально проверьте минимальный ZPL, DPI и калибровку, затем сравните точный payload. Не пишите данные клиента и токены в лог.
Чек-лист перед запуском
- Откалибруйте размер этикетки и проверьте драйвер и очередь принтера.
- Сохраняйте стабильный идентификатор принтера, а не только отображаемое имя.
- Проверяйте формат документа, размер страницы и ориентацию до создания задания.
- Сохраняйте идентификаторы заданий и причины ошибок для поддержки и мониторинга.