Label Printing API для доставки и склада
CloudPrint печатает этикетку, которую уже сформировал маркетплейс, перевозчик или сервис доставки. Он не оформляет отправление, не рассчитывает стоимость доставки и не создаёт номер отслеживания; задача CloudPrint — доставить готовый PDF или совместимые RAW-команды на нужный локальный принтер.
Сначала создайте отправление
Получите готовую этикетку через API перевозчика или платформы доставки. Затем передайте её как PDF, публичный HTTPS-адрес либо RAW-команды ZPL, TSPL или CPCL. Перевозчик отвечает за отправление и этикетку, а CloudPrint — за её печать.
Выберите PDF или RAW-язык этикетки
PDF удобно просматривать, но очереди нужна системная печать либо средство обработки PDF. Для RAW укажите document_format=raw и точный document_raw_language: zpl, tspl или cpcl. Выбранный принтер должен объявлять этот язык и поддержку сквозной RAW-печати.
Назначьте принтер каждому упаковочному месту
При настройке склада сохраните printer_id для каждого упаковочного места или процесса. Показывайте сотруднику название принтера, но направляйте задания по идентификатору. Если очередь недоступна, остановите печать и предложите выбрать другой принтер явно, чтобы этикетка не ушла в другой филиал.
Согласуйте носитель и штрихкод
Размер страницы должен совпадать с этикеткой; при необходимости передайте media_width_mm, media_height_mm и dpi. Откалибруйте датчик, плотность и скорость печати. Перед запуском напечатайте и отсканируйте реальные образцы: API не может исправить обрезанный или нечитаемый штрихкод.
Вызывайте API только с сервера
Получите принтер упаковочного места, загрузите PDF или RAW-документ, создайте задание и отслеживайте статус. Используйте POST /api/v1/documents и POST /api/v1/print-jobs либо подходящий shortcut для URL/Base64. Не помещайте OAuth-секрет в браузер склада.
Разделяйте повтор запроса и перепечатку
Стройте Idempotency-Key из идентификатора отправления, типа этикетки и версии операции. Повтор запроса после тайм-аута сохраняет ключ. Осознанная вторая копия получает новый ключ, данные оператора и причину. Проверьте выключение агента, недоступный принтер, отсутствие бумаги и перезапуск станции.