Zarządzanie uprawnieniami
Moduł Uprawnienia pozwala zarządzać uprawnieniami nadanymi w KSeF (Krajowy System e-Faktur) osobom fizycznym oraz podmiotom — w ramach aktualnie wybranego kontekstu NIP.
Co możesz tutaj zrobić
- Przeglądać uprawnienia nadane w bieżącym kontekście (Twój NIP lub kontekst delegowany).
- Zobaczyć własne uprawnienia osobiste otrzymane od innych podmiotów.
- Nadawać nowe uprawnienia osobie fizycznej (PESEL lub NIP) albo podmiotowi (NIP).
- Cofać wcześniej nadane uprawnienia.
- Przełączać kontekst pomiędzy domyślnym NIP-em z certyfikatu a delegowanymi NIP-ami, do których masz dostęp.
Typy uprawnień
Dla osób fizycznych
| Uprawnienie | Opis |
|---|---|
CredentialsManage | Nadawanie i cofanie uprawnień w imieniu podmiotu |
InvoiceWrite | Wystawianie faktur w imieniu podmiotu |
InvoiceRead | Przeglądanie i pobieranie faktur |
Introspection | Wgląd do historii sesji i logów operacji |
SubunitManage | Zarządzanie jednostkami podrzędnymi |
Dla podmiotów (innych firm)
| Uprawnienie | Opis |
|---|---|
InvoiceWrite | Wystawianie faktur w imieniu Twojej firmy |
InvoiceRead | Odczyt faktur Twojej firmy |
Przełączanie kontekstu
W górnej części strony możesz przełączać się pomiędzy kontekstami (NIP-ami):
- Kontekst domyślny — Twój NIP z aktywnego certyfikatu.
- Konteksty delegowane — NIP-y podmiotów, które nadały Ci uprawnienie
CredentialsManage.
Po przełączeniu wszystkie zapytania o uprawnienia i operacje wykonywane są w wybranym kontekście.
Ważne
Każdy kontekst korzysta z osobnej sesji KSeF. Zmiana kontekstu odświeża sesję dla wybranego NIP-u. Lista uprawnień i operacji zawsze dotyczy aktywnego kontekstu.
Nadawanie nowego uprawnienia
- Kliknij Nadaj uprawnienie.
- Wybierz typ odbiorcy: Osoba (PESEL lub NIP) albo Podmiot (NIP).
- Zaznacz jedno lub więcej uprawnień.
- Zatwierdź — żądanie zostanie wysłane do KSeF jako operacja asynchroniczna.
Status każdej operacji nadania/cofnięcia widać w panelu Status operacji na górze strony.
Najczęstsze błędy
| Status | Znaczenie |
|---|---|
400 | Nieprawidłowe dane żądania (np. błędny format PESEL/NIP) |
401 | Sesja wygasła — uwierzytelnij się ponownie |
403 | Brak uprawnienia CredentialsManage w tym kontekście |
429 | Zbyt wiele żądań — odczekaj chwilę i spróbuj ponownie |
Gdy KSeF zwróci błąd, strona zastępuje UI zarządzania banerem z wyjaśnieniem.