Печать транспортных этикеток из вашей системы
CloudPrint печатает транспортную этикетку, которую уже сформировал перевозчик, маркетплейс или shipping-сервис. Он не покупает отправление, не выбирает тариф и не создаёт tracking number; задача CloudPrint — доставить готовый PDF или ZPL на нужный локальный принтер.
Сначала создайте отправление
Получите финальную этикетку через API перевозчика или используемую shipping-платформу. Затем передайте PDF, публичный HTTPS URL или ZPL в CloudPrint. Такое разделение не даёт спутать API перевозчика с API доставки документа к принтеру.
Выберите PDF или ZPL
PDF удобно просматривать, но очереди нужна системная печать либо renderer. ZPL эффективен для совместимой Zebra, но требует document_format=raw, document_raw_language=zpl, профиля ZPL и RAW passthrough у выбранного принтера.
Назначьте принтер каждому месту
При настройке склада сохраните printer_id для упаковочного места или процесса. Имя показывайте человеку, а маршрутизируйте по ID. Если очередь offline, остановите печать и предложите явный выбор, чтобы этикетка клиента не ушла в другой филиал.
Согласуйте носитель и штрихкод
Размер страницы должен совпадать с этикеткой; при необходимости передайте media_width_mm, media_height_mm и dpi. Откалибруйте датчик, darkness и скорость. Перед production напечатайте и отсканируйте реальные образцы: API не может исправить обрезанный или нечитаемый штрихкод.
Разделяйте retry и перепечатку
Стройте Idempotency-Key из ID отправления, типа этикетки и версии операции. Retry после timeout сохраняет ключ. Осознанная вторая копия получает новый ключ, оператора и причину. Проверьте выключение агента, offline-принтер, отсутствие бумаги и перезапуск станции.
Чек-лист перед запуском
- Проверяйте формат документа, размер страницы и ориентацию до создания задания.
- Откалибруйте размер этикетки и проверьте драйвер и очередь принтера.
- Сохраняйте стабильный идентификатор принтера, а не только отображаемое имя.
- Явно задайте обработку конечных статусов, повторов и защиту от двойной печати.