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 szybko wskazuje warstwę 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 retry użyj tego samego Idempotency-Key.
Drukarki nie ma lub jest offline
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. Routing powinien używać printer_id, nie nazwy. Dla agenta offline 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 scope. 409 może oznaczać konflikt idempotencji albo nieobsługiwaną trasę, 422 — błędny payload 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 oraz opcje z capabilities drukarki. Typowe przyczyny to brak renderera 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 client secret, access tokenu ani poufnej zawartości dokumentu.
Lista kontrolna przed wdrożeniem
- Zapisuj identyfikatory zadań i przyczyny błędów na potrzeby wsparcia i monitoringu.
- Korzystaj z wychodzącego połączenia agenta; nie wystawiaj portów drukarki do internetu.
- Zapisuj stabilny identyfikator drukarki, a nie tylko jej nazwę.
- Jawnie obsługuj status końcowy, ponowienia i ochronę przed podwójnym drukiem.