Powrót do pomocy
Najczęstsze błędy tokenu KSeF w KSeF Radar i jak je naprawić
Mapa najczęstszych błędów (401, 403, 429 i błędy połączenia) z gotowymi krokami naprawy dla użytkownika KSeF Radar.
Najczęstsze błędy tokenu KSeF w KSeF Radar i jak je naprawić
W KSeF Radar najważniejsze informacje o połączeniu znajdziesz na ekranie KSeF -> Połącz lub zaktualizuj token: status, ostatnia synchronizacja i ostatni błąd.
Szybka mapa błędów i napraw
| Komunikat / kod | Najczęstsza przyczyna | Pierwszy krok naprawy |
|---|---|---|
| "Token is required." | Puste pole tokenu | Wklej pełny token i zapisz |
| "Cannot queue sync: KSeF is not connected for this organization." | Brak aktywnego tokenu dla bieżącej organizacji | Podmień token dla właściwej organizacji |
| HTTP 401 | Token błędny, wygasły lub unieważniony | Wygeneruj nowy token i zapisz w KSeF Radar |
| HTTP 403 | Brak uprawnień (np. brak dostępu do faktur) | Nadaj uprawnienia i wygeneruj nowy token |
| HTTP 429 | Limit żądań po stronie KSeF | Odczekaj i ponów synchronizację |
1) "Token is required."
- Objaw: błąd podczas zapisu formularza tokenu.
- Przyczyna: pole tokenu jest puste.
- Naprawa (KSeF Radar + AP KSeF): wklej pełny token (bez dodatkowych spacji), zapisz i uruchom synchronizację.
2) "Cannot queue sync: KSeF is not connected for this organization."
- Objaw: nie można uruchomić synchronizacji.
- Przyczyna: brak aktywnego tokenu dla bieżącej organizacji lub połączenie jest rozłączone.
- Naprawa (KSeF Radar + AP KSeF): przełącz na właściwą organizację, zapisz token na ekranie KSeF i ponów Synchronizuj teraz.
3) "Token KSeF jest nieprawidłowy lub wygasł..." (typowo HTTP 401)
- Objaw: autoryzacja KSeF nie przechodzi.
- Przyczyna: błędny, wygasły albo unieważniony token.
- Naprawa (KSeF Radar + AP KSeF): wygeneruj nowy token w Aplikacji Podatnika KSeF, zapisz go w KSeF Radar i ponów synchronizację.
4) "KSeF zwrócił HTTP 403..." (brak uprawnień)
- Objaw: połączenie jest, ale pobieranie faktur nie działa.
- Przyczyna: token nie ma wymaganych uprawnień (najczęściej brak dostępu do faktur) lub działa w złym kontekście NIP.
- Naprawa (KSeF Radar + AP KSeF): w Aplikacji Podatnika nadaj poprawne uprawnienia, wygeneruj nowy token w kontekście właściwego NIP i podmień token w KSeF Radar.
5) "KSeF chwilowo ograniczył liczbę żądań (limit API)" (HTTP 429)
- Objaw: błąd limitu podczas synchronizacji.
- Przyczyna: chwilowe limity po stronie KSeF.
- Naprawa (KSeF Radar + AP KSeF): odczekaj wskazany czas (jeśli podany) i uruchom synchronizację ponownie.
6) "Nie udało się uwierzytelnić w KSeF..." / timeout autoryzacji
- Objaw: błąd autoryzacji mimo zapisanego tokenu.
- Przyczyna: problem sesji KSeF, nieaktualny token lub chwilowa niedostępność API.
- Naprawa (KSeF Radar + AP KSeF): spróbuj ponownie po chwili; jeśli błąd wraca, wygeneruj nowy token i zapisz go ponownie w KSeF Radar.
7) Status ERROR po częściowo udanej synchronizacji
- Objaw: część faktur została pobrana, ale status połączenia jest ERROR.
- Przyczyna: synchronizacja mogła zatrzymać się na limicie KSeF lub błędzie po stronie API.
- Naprawa (KSeF Radar + AP KSeF): użyj przycisku Synchronizuj teraz. W razie potrzeby użyj opcji historii (30/60/90 dni) na ekranie KSeF.
Kiedy zgłosić sprawę do wsparcia KSeF Radar?
Jeśli po wykonaniu powyższych kroków problem wraca, prześlij do wsparcia: NIP organizacji, dokładny komunikat z pola Ostatni błąd, datę i godzinę próby oraz informację, czy token był właśnie wymieniany.