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` из идентификатора отправления, типа этикетки и версии операции. Повтор запроса после тайм-аута сохраняет ключ. Осознанная вторая копия получает новый ключ, данные оператора и причину. Проверьте выключение агента, недоступный принтер, отсутствие бумаги и перезапуск станции. ## Следующие шаги