Диагностика агентов, принтеров и заданий
Сначала проверьте статус задания и идентификатор запроса, затем принтер, агент и исходный документ. Такой порядок помогает быстрее найти источник ошибки и не отправить документ повторно.
Сначала соберите идентификаторы
Запишите номер заказа или документа в вашей системе, print_job_id, printer_id, последний статус, failure_reason и X-Request-Id. Не создавайте новое задание, пока не выяснили, было ли принято первое. При повторе исходного запроса используйте тот же Idempotency-Key.
Принтер отсутствует или не в сети
Убедитесь, что локальный агент работает и подключён к тому же аккаунту CloudPrint. Проверьте очередь принтера в операционной системе, затем обновите список. Маршрутизируйте по printer_id, а не по имени. Если агент не в сети, сначала восстановите его исходящий доступ к интернету.
API отклоняет задание
401 обычно означает недействительный или истёкший токен — запросите новый один раз. 403 указывает на отсутствие необходимого разрешения. 409 означает конфликт идемпотентности или неподдерживаемый маршрут. 422 говорит о неверных данных или параметрах печати, 415 — о неподдерживаемом формате.
Задание слишком долго остаётся в статусе pending
Проверьте, что назначенный агент имеет статус online, затем изучите status_evidence принтера, включая reasons и accepting_jobs. Задание не попадёт в отключённую точку или очередь, которая не принимает задания. Не создавайте новые копии автоматически.
Ошибка после передачи агенту
Сопоставьте failure_reason, формат документа и запрошенные параметры с возможностями принтера. Частые причины: отсутствует средство обработки PDF, принтер не объявил нужный язык RAW или недоступна системная печать. Для этикеток также проверьте DPI, размер носителя, драйвер, очередь и калибровку.
Обращение в поддержку
Передайте X-Request-Id, print_job_id, примерное время, аккаунт, названия агента и принтера, формат документа, параметры и видимую причину ошибки. Не отправляйте client_secret, токен доступа и конфиденциальное содержимое документа.