{
"title": "Forbidden",
"status": 403,
"detail": "Brak wymaganych uprawnień do wykonania operacji w bieżącym kontekście.",
"reasonCode": "missing-permissions",
"security": {
"requiredAnyOfPermissions": ["InvoiceWrite", "PefInvoiceWrite", "EnforcementOperations"],
"presentPermissions": ["InvoiceRead"]
}
}Środowisko testowe MF, 11.10.2026. Numery referencyjne skróciliśmy, reszta bez zmian. Wygenerowaliśmy token z samym uprawnieniem do przeglądania faktur i spróbowaliśmy otworzyć sesję wysyłki.
Odpowiedź od razu mówi, czego brakuje: requiredAnyOfPermissions to uprawnienia, z których wystarczy jedno, a presentPermissions — te, które token ma.
Uprawnienia tokena KSeF
| Uprawnienie w API | Do czego |
|---|---|
| InvoiceRead | przeglądanie faktur: pobieranie faktur, list sprzedaży i zakupów |
| InvoiceWrite | wystawianie faktur: wysyłka faktur do KSeF |
| CredentialsRead | odczyt nadanych uprawnień |
| CredentialsManage | zarządzanie uprawnieniami |
| SubunitManage | zarządzanie jednostkami podrzędnymi |
| EnforcementOperations | operacje egzekucyjne (organy egzekucyjne, komornicy) |
Według dokumentacji MF uprawnień istniejącego tokena nie da się zmienić — trzeba wygenerować nowy token z właściwym zestawem i podmienić go w programie.
403 a 401
| 401 Unauthorized | 403 Forbidden | |
|---|---|---|
| Co KSeF mówi | „Wymagane jest uwierzytelnienie.” | „Brak wymaganych uprawnień…” |
| Co to znaczy | Nie wiem, kim jesteś — brak lub wygasłe logowanie. | Wiem, kim jesteś, ale tego Ci nie wolno. |
| Naprawa | Zaloguj się ponownie / nowy token. | Token lub konto z innym uprawnieniem. |
Pełny opis 401: błąd 401 w KSeF.
Jak naprawić
- W Aplikacji Podatnika (ap.ksef.mf.gov.pl) wygeneruj nowy token z uprawnieniem wystawianie faktur (do wysyłki) i/lub przeglądanie faktur (do pobierania).
- Wklej nowy token w programie. Stary możesz unieważnić.
- Jeśli generowanie tokena z danym uprawnieniem jest niemożliwe (błąd 26001), sam go nie masz — poproś właściciela firmy o nadanie.