Podczas otwierania sesji interaktywnej w KSeF przez endpoint sessions/online może pojawić się błąd 403. Najczęściej występuje on przy pierwszej autoryzacji lub krótko po nadaniu uprawnień i potrafi zaskoczyć, bo wszystko wygląda na skonfigurowane poprawnie. Warto wiedzieć, że w większości przypadków nie jest to ani błąd programu do fakturowania, ani nieprawidłowa autoryzacja.
Najczęstsza przyczyna – opóźnienie po stronie KSeF
Najczęstszym powodem błędu 403 jest to, że system KSeF nie zdążył jeszcze przetworzyć nowo nadanych uprawnień. Uprawnienia w KSeF są zapisywane i aktywowane asynchronicznie. Oznacza to, że mimo poprawnego ich nadania oraz poprawnie wykonanej autoryzacji w Fakturowo.pl, przez pewien czas dostęp do endpointu sessions/online może być zablokowany.
W takiej sytuacji kod 403 oznacza brak dostępu technicznego w danym momencie, a nie faktyczny brak uprawnień. Uprawnienia już istnieją, ale nie są jeszcze widoczne dla API KSeF. Zwykle wystarczy odczekać kilka lub kilkanaście minut i ponowić próbę otwarcia sesji interaktywnej.
Inne możliwe powody błędu 403
Jeżeli błąd pojawia się również po dłuższym czasie, warto sprawdzić kilka dodatkowych rzeczy.
W momencie otwierania sesji interaktywnej Fakturowo.pl jedynie przekazuje do KSeF dane wynikające z wykonanej autoryzacji. Odpowiedź 403 pochodzi bezpośrednio z serwerów Ministerstwa Finansów.
Nasz system nie modyfikuje żądań, nie zmienia tokenów i nie ma technicznej możliwości wpływania na decyzję KSeF o przyznaniu lub odmowie dostępu.
Co zrobić krok po kroku
Jeżeli błąd 403 pojawił się tuż po pierwszej autoryzacji, najlepiej po prostu odczekać chwilę i spróbować ponownie otworzyć nową sesję - zrzut ekranu poniżej.
Nie ma potrzeby ponownego nadawania uprawnień ani usuwania autoryzacji, jeśli zostały one wykonane poprawnie.
Podsumowanie
Błąd 403 przy endpointu sessions/online w zdecydowanej większości przypadków wynika z opóźnienia w przetwarzaniu uprawnień po stronie KSeF. Uprawnienia są nadane poprawnie, ale system Ministerstwa Finansów potrzebuje czasu, aby udostępnić je do użycia przez API.
Jeżeli błąd pojawia się krótko po autoryzacji, najlepszym rozwiązaniem jest po prostu chwilę poczekać. Dopiero długotrwały problem wymaga dalszej weryfikacji ustawień w samym KSeF.
Najczęstsza przyczyna – opóźnienie po stronie KSeF
Najczęstszym powodem błędu 403 jest to, że system KSeF nie zdążył jeszcze przetworzyć nowo nadanych uprawnień. Uprawnienia w KSeF są zapisywane i aktywowane asynchronicznie. Oznacza to, że mimo poprawnego ich nadania oraz poprawnie wykonanej autoryzacji w Fakturowo.pl, przez pewien czas dostęp do endpointu sessions/online może być zablokowany.
W takiej sytuacji kod 403 oznacza brak dostępu technicznego w danym momencie, a nie faktyczny brak uprawnień. Uprawnienia już istnieją, ale nie są jeszcze widoczne dla API KSeF. Zwykle wystarczy odczekać kilka lub kilkanaście minut i ponowić próbę otwarcia sesji interaktywnej.
Inne możliwe powody błędu 403
Jeżeli błąd pojawia się również po dłuższym czasie, warto sprawdzić kilka dodatkowych rzeczy.
- Autoryzacja została wykonana profilem zaufanym lub podpisem, który nie ma prawa działania dla danego NIP-u w KSeF.
- Uprawnienia zostały nadane dla innego podmiotu niż ten, dla którego otwierana jest sesja.
- Zakres uprawnień nie obejmuje wysyłania faktur lub pracy w trybie interaktywnym.
- Próba otwarcia sesji dotyczy innego środowiska (demo lub produkcja) niż to, dla którego nadano uprawnienia.
W momencie otwierania sesji interaktywnej Fakturowo.pl jedynie przekazuje do KSeF dane wynikające z wykonanej autoryzacji. Odpowiedź 403 pochodzi bezpośrednio z serwerów Ministerstwa Finansów.
Nasz system nie modyfikuje żądań, nie zmienia tokenów i nie ma technicznej możliwości wpływania na decyzję KSeF o przyznaniu lub odmowie dostępu.
Co zrobić krok po kroku
Jeżeli błąd 403 pojawił się tuż po pierwszej autoryzacji, najlepiej po prostu odczekać chwilę i spróbować ponownie otworzyć nową sesję - zrzut ekranu poniżej.
Nie ma potrzeby ponownego nadawania uprawnień ani usuwania autoryzacji, jeśli zostały one wykonane poprawnie.
Podsumowanie
Błąd 403 przy endpointu sessions/online w zdecydowanej większości przypadków wynika z opóźnienia w przetwarzaniu uprawnień po stronie KSeF. Uprawnienia są nadane poprawnie, ale system Ministerstwa Finansów potrzebuje czasu, aby udostępnić je do użycia przez API.
Jeżeli błąd pojawia się krótko po autoryzacji, najlepszym rozwiązaniem jest po prostu chwilę poczekać. Dopiero długotrwały problem wymaga dalszej weryfikacji ustawień w samym KSeF.
