Diagnostyka agentów, drukarek i zadań
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.