KSeF błąd 403 – odmowa dostępu
Co musisz wiedzieć
Krajowy System e-Faktur (KSeF) jest centralnym systemem administracji skarbowej do wystawiania i otrzymywania faktur ustrukturyzowanych w formacie XML.
Na tej stronie znajdziesz uporządkowane informacje dotyczące tematu: KSeF błąd 403 – odmowa dostępu. Opis koncentruje się na aktualnych przepisach oraz komunikatach Ministerstwa Finansów.
Instrukcja krok po kroku
1. Zweryfikuj uprawnienia użytkownika
Sprawdź w Aplikacji Podatnika KSeF (ksef.podatki.gov.pl), czy Twoje konto ma nadane uprawnienia do danego podmiotu (NIP). Upewnij się, że posiadasz uprawnienie InvoiceRead lub InvoiceWrite w zależności od wykonywanej operacji.
2. Sprawdź ważność sesji autoryzacyjnej
Token JWT (accessToken) ma ograniczony czas ważności. Sprawdź pole exp w tokenie i w razie potrzeby odśwież token wywołując POST /api/v2/auth/token/refresh z użyciem refreshToken.
3. Zweryfikuj certyfikat lub token KSeF
Upewnij się, że certyfikat kwalifikowany lub certyfikat KSeF jest ważny i poprawnie powiązany z podmiotem. Sprawdź datę ważności certyfikatu oraz czy jest on zainstalowany w systemie.
4. Sprawdź kontekst operacji
Upewnij się, że wykonujesz operację w kontekście właściwego NIP. Błąd 403 może wystąpić, gdy próbujesz uzyskać dostęp do faktur podmiotu, dla którego nie masz uprawnień.
5. Skontaktuj się z administratorem uprawnień
Jeśli problem się powtarza, poproś właściciela firmy lub osobę z uprawnieniem CredentialsManage o weryfikację i ewentualne ponowne nadanie uprawnień przez Aplikację Podatnika KSeF.
Najczęstsze problemy i rozwiązania
Błąd 403 pojawia się przy próbie pobrania faktury
Sprawdź, czy posiadasz uprawnienie InvoiceRead dla danego podmiotu. Upewnij się, że próbujesz pobrać fakturę przypisaną do Twojego NIP (jako sprzedawca lub nabywca).
Mam uprawnienia, ale nadal widzę błąd 403
Sprawdź, czy sesja autoryzacyjna jest aktywna i token JWT nie wygasł. Jeśli używasz certyfikatu, upewnij się, że jest ważny i poprawnie powiązany z podmiotem.
Błąd 403 przy próbie dostępu do faktur innej firmy
Nie możesz uzyskać dostępu do faktur podmiotu, dla którego nie masz nadanych uprawnień. Poproś właściciela o nadanie Ci odpowiednich uprawnień przez Aplikację Podatnika KSeF.
Przyczyny błędu 403 w KSeF
Błąd 403 (Forbidden) oznacza, że serwer rozpoznał żądanie, ale odmówił jego wykonania z powodu braku uprawnień. W kontekście KSeF najczęstsze przyczyny to: brak uprawnienia InvoiceRead/InvoiceWrite do danego NIP, wygasły lub nieprawidłowy token JWT, nieważny certyfikat kwalifikowany lub certyfikat KSeF, próba dostępu do faktur innego podmiotu.
Różnica między błędem 401 a 403
Błąd 401 (Unauthorized) oznacza problem z uwierzytelnianiem – system nie rozpoznaje użytkownika. Błąd 403 (Forbidden) oznacza, że użytkownik jest rozpoznany, ale nie ma uprawnień do wykonania danej operacji. W przypadku 401 sprawdź proces logowania, w przypadku 403 – uprawnienia do podmiotu.
Zarządzanie uprawnieniami w KSeF
Uprawnienia w KSeF zarządzane są przez Moduł Certyfikatów i Uprawnień (MCU) lub Aplikację Podatnika KSeF. Właściciel podmiotu (Owner) lub osoba z uprawnieniem CredentialsManage może nadawać, modyfikować i odbierać uprawnienia innym użytkownikom. Uprawnienia można też nadać poprzez formularz ZAW-FA składany w urzędzie skarbowym.
FAQ
Co to jest błąd 403 w KSeF?
Błąd 403 (Forbidden) w KSeF oznacza brak uprawnień do wykonania danej operacji. Najczęściej wynika z braku odpowiednich uprawnień użytkownika, nieaktywnej sesji lub próby dostępu do danych innego podmiotu.
Jak naprawić błąd 403 w KSeF?
Sprawdź, czy posiadasz odpowiednie uprawnienia do danej operacji, czy sesja autoryzacyjna jest aktywna oraz czy token JWT jest ważny. Jeśli problem się powtarza, skontaktuj się z administratorem uprawnień w firmie.
Kto może nadać mi uprawnienia do KSeF?
Uprawnienia do KSeF może nadać właściciel firmy (osoba reprezentująca podmiot) lub osoba z uprawnieniami do zarządzania użytkownikami. Uprawnienia nadaje się przez Aplikację Podatnika KSeF lub Moduł Certyfikatów i Uprawnień.
Czy błąd 403 może oznaczać problem z certyfikatem?
Tak, błąd 403 może wynikać z niepoprawnego certyfikatu, wygasłego certyfikatu lub braku powiązania certyfikatu z danym podmiotem. Sprawdź ważność certyfikatu i jego poprawną konfigurację w systemie.