Zacznij od statusu zadania i identyfikatora żądania, następnie sprawdź drukarkę, agenta i dokument źródłowy. Taka kolejność ogranicza ryzyko podwójnego druku i zwykle szybko wskazuje źródło problemu.
## Najpierw zbierz identyfikatory Zapisz numer zamówienia lub dokumentu, `print_job_id`, `printer_id`, ostatni status, `failure_reason` i `X-Request-Id`. Nie twórz nowego zadania, dopóki nie ustalisz, czy pierwsze zostało przyjęte. Przy ponowieniu użyj tego samego `Idempotency-Key`. ## Drukarki nie ma lub jest niedostępna Sprawdź, czy lokalny agent działa i jest połączony z właściwym kontem. Zweryfikuj kolejkę w systemie operacyjnym i odśwież listę drukarek. Do wyboru drukarki używaj `printer_id`, nie nazwy. Jeśli agent jest niedostępny, najpierw przywróć połączenie wychodzące. ## API odrzuca zadanie `401` zwykle oznacza nieprawidłowy lub wygasły token; pobierz nowy tylko raz. `403` wskazuje brak wymaganego uprawnienia. `409` może oznaczać konflikt idempotencji albo nieobsługiwaną trasę, `422` — błędne dane lub opcje, a `415` — nieobsługiwany format. ## Zadanie długo pozostaje pending Sprawdź stan przypisanego agenta i drukarki. Praca nie dotrze do odłączonej lokalizacji. Odpytuj status w rozsądnym odstępie i pokaż operatorowi oczekiwanie; nie wysyłaj automatycznie kolejnych kopii. ## Błąd po odebraniu przez agenta Porównaj `failure_reason`, format i opcje z możliwościami drukarki. Typowe przyczyny to brak mechanizmu przetwarzania PDF, brak profilu języka RAW lub niedostępny druk systemowy. Dla etykiet sprawdź również DPI, wymiary, sterownik, kolejkę i kalibrację. ## Zgłoszenie do wsparcia Podaj `X-Request-Id`, `print_job_id`, czas, konto, nazwę agenta i drukarki, format, opcje oraz widoczny powód błędu. Nie przesyłaj sekretu klienta, tokenu dostępu ani poufnej zawartości dokumentu. ## Następne kroki