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