Token KSeF 2.0: jak go wygenerować i jakie uprawnienia nadać
Do czego służy token KSeF
Do KSeF można się uwierzytelnić na kilka sposobów: kwalifikowanym podpisem albo pieczęcią elektroniczną, certyfikatem KSeF albo tokenem. Token jest najprostszy dla programów i narzędzi: nie wymaga podpisywania każdego logowania, a jego uprawnienia ustalasz z góry. Z tokena korzystają zwykle:
- programy finansowo-księgowe i systemy sprzedaży, które wysyłają faktury do KSeF albo je pobierają,
- biura rachunkowe pobierające faktury kosztowe klientów,
- narzędzia online, np. nasz generator identyfikatorów zbiorczych.
Token działa w kontekście firmy, czyli dla konkretnego NIP (albo identyfikatora wewnętrznego), w którym go wygenerowano. Tokenem jednej spółki nie zalogujesz się w imieniu innej.
Czy tokeny zostaną po 2026 roku
Tak. Według pierwotnych założeń tokeny miały być metodą uwierzytelnienia tylko do końca 2026 r., a potem miały je zastąpić certyfikaty KSeF. Ministerstwo Finansów zmieniło to: tokeny zostaną utrzymane bezterminowo, a rozporządzenie w sprawie korzystania z KSeF ma zostać znowelizowane. Tokeny i certyfikaty KSeF działają równolegle.
Jak wygenerować token w Aplikacji Podatnika KSeF
- Zaloguj się do Aplikacji Podatnika KSeF 2.0 podpisem zaufanym, kwalifikowanym podpisem elektronicznym albo kwalifikowaną pieczęcią elektroniczną. Certyfikatem KSeF do aplikacji się nie zalogujesz.
- Wskaż kontekst, czyli firmę (NIP), dla której ma działać token.
- Przejdź do zarządzania tokenami i wygeneruj nowy token.
- Wpisz opis (od 5 do 256 znaków). Opis pomoże później odróżnić tokeny, np. „Program FK – pobieranie faktur” albo „Generator identyfikatorów – Anna Nowak”.
- Zaznacz uprawnienia tokena. Wybierz tylko te, których naprawdę potrzebuje program albo osoba (tabela niżej).
- Skopiuj token od razu i zapisz go w bezpiecznym miejscu, np. w menedżerze haseł. KSeF zwraca token tylko raz. Gdy go zgubisz, nie odczytasz go ponownie, tylko wygenerujesz nowy.
Token nie działa od razu po wygenerowaniu. Najpierw ma status Pending (aktywacja i nadawanie uprawnień), a logować się nim można dopiero, gdy status zmieni się na Active.
Firmy z własną integracją mogą generować tokeny także przez API KSeF 2.0. To ta sama operacja: opis, lista uprawnień i token zwracany jednorazowo.
Uprawnienia tokena
Przy generowaniu tokena wybierasz jedno lub kilka uprawnień z listy. Nazwy i opisy pochodzą z dokumentacji API KSeF 2.0:
| Uprawnienie | Co daje | Kiedy nadać |
|---|---|---|
InvoiceRead | przeglądanie faktur | pobieranie faktur kosztowych i sprzedażowych, generowanie identyfikatorów zbiorczych |
InvoiceWrite | wystawianie faktur | program, który wysyła faktury do KSeF |
CollectiveIdentifierManage | zarządzanie identyfikatorami zbiorczymi | osoba lub system, który tylko tworzy identyfikatory do przelewów |
CredentialsRead | przeglądanie uprawnień | kontrola, kto ma dostęp do KSeF firmy |
CredentialsManage | zarządzanie uprawnieniami | administrator KSeF w firmie; nadawaj ostrożnie |
Introspection | przeglądanie historii sesji i generowanie UPO | program, który pobiera UPO i sprawdza sesje wysyłki |
SubunitManage | zarządzanie jednostkami podrzędnymi | podmioty, które mają jednostki podrzędne |
EnforcementOperations | wykonywanie operacji egzekucyjnych | wyłącznie organy egzekucyjne |
Zasada jest prosta: im mniej uprawnień, tym bezpieczniej. Token do pobierania faktur nie potrzebuje prawa do ich wystawiania, a token do narzędzia, które tworzy identyfikatory zbiorcze, nie potrzebuje zarządzania uprawnieniami. Jeśli z tokenów korzysta kilka osób lub programów, każdy niech ma własny token. Wtedy unieważnienie jednego nie zatrzyma pozostałych.
Statusy tokena
| Status | Co oznacza |
|---|---|
| Pending | token utworzony, trwa aktywacja i nadawanie uprawnień; nie da się nim jeszcze zalogować |
| Active | token działa i można go używać do logowania |
| Revoking | trwa unieważnianie; token już nie działa |
| Revoked | token unieważniony na stałe |
| Failed | aktywacja się nie udała; trzeba wygenerować nowy token |
Lista tokenów i unieważnianie
W KSeF widać listę tokenów z opisem, autorem, uprawnieniami, datą utworzenia i datą ostatniego użycia. Kto ma
uprawnienie do przeglądania lub zarządzania uprawnieniami (CredentialsRead,
CredentialsManage), widzi wszystkie tokeny wygenerowane w kontekście firmy. Pozostali widzą tylko
tokeny, których są autorami.
Token unieważnij, gdy:
- pracownik, który go używał, odchodzi albo zmienia zakres obowiązków,
- kończysz współpracę z dostawcą programu lub biurem rachunkowym,
- token mógł wyciec, np. trafił do maila albo do wspólnego dokumentu.
Unieważniony token przestaje działać od razu. Nie zmienia to niczego, co zostało w KSeF zrobione wcześniej:
faktury i identyfikatory zbiorcze utworzone tym tokenem zostają. Kto ma CredentialsManage, może
unieważnić każdy aktywny token w kontekście firmy.
Token a certyfikat KSeF
Certyfikat KSeF to druga metoda logowania programów do KSeF 2.0. Wniosek o certyfikat i jego pobranie są dostępne w Aplikacji Podatnika KSeF 2.0 i przez API.
| Token KSeF | Certyfikat KSeF | |
|---|---|---|
| Uprawnienia | ma własne, wybrane przy generowaniu | tylko uwierzytelnia; uprawnienia wynikają z tych nadanych w KSeF |
| Ważność | do unieważnienia; tokeny zostają bezterminowo | najwyżej 2 lata od wytworzenia lub od wskazanej daty początkowej |
| Rodzaje | jeden | do uwierzytelniania oraz osobny do trybu offline (kod na fakturze potwierdzający tożsamość wystawcy) |
Dla prostych zastosowań, np. pobierania faktur albo tworzenia identyfikatorów zbiorczych, token zwykle wystarczy. Certyfikat offline jest potrzebny firmom, które wystawiają faktury w trybie offline.
Gdy logowanie tokenem nie działa
| Przyczyna | Co zrobić |
|---|---|
| Token z innego środowiska | Środowiska produkcyjne, przedprodukcyjne (demo) i testowe mają osobne tokeny. Wybierz w programie to samo środowisko, w którym wygenerowano token. |
| Token z KSeF 1.0 | Nie działa w KSeF 2.0. Wygeneruj nowy w Aplikacji Podatnika KSeF 2.0. |
| Status Pending albo Failed | Przy Pending poczekaj na zmianę statusu na Active. Przy Failed wygeneruj nowy token. |
| Inny NIP niż kontekst tokena | Token działa tylko dla firmy, w której go wygenerowano. Sprawdź NIP wpisany w programie. |
| Brak uprawnienia | Logowanie się udaje, ale operacja zwraca odmowę. Wygeneruj token z potrzebnym uprawnieniem; uprawnień istniejącego tokena się nie dopisuje. |
| Token unieważniony | Sprawdź listę tokenów w KSeF. Unieważnionego tokena nie da się przywrócić. |
FAQ
Gdzie wygenerować token KSeF 2.0?
W Aplikacji Podatnika KSeF 2.0, po zalogowaniu podpisem zaufanym, kwalifikowanym podpisem elektronicznym albo kwalifikowaną pieczęcią elektroniczną. Programy z integracją mogą też wygenerować token przez API KSeF. Moduł Certyfikatów i Uprawnień z KSeF 1.0 działał tylko do końca stycznia 2026 r.
Czy tokeny KSeF będą działać po 2026 roku?
Tak. Pierwotnie tokeny miały być dostępne do końca 2026 r., ale Ministerstwo Finansów zdecydowało, że zostaną utrzymane bezterminowo, a rozporządzenie w sprawie korzystania z KSeF zostanie znowelizowane.
Czy token z KSeF 1.0 działa w KSeF 2.0?
Nie. Tokeny wygenerowane w KSeF 1.0 nie są zgodne z KSeF 2.0. Trzeba wygenerować nowy token w Aplikacji Podatnika KSeF 2.0.
Jakie uprawnienie nadać tokenowi do pobierania faktur?
Do przeglądania i pobierania faktur wystarczy InvoiceRead (przeglądanie faktur). Do wystawiania faktur potrzebne jest InvoiceWrite. Tokenowi warto nadać tylko te uprawnienia, których wymaga program lub narzędzie.
Czym token różni się od certyfikatu KSeF?
Token ma przypisane uprawnienia wskazane przy jego generowaniu. Certyfikat KSeF służy tylko do uwierzytelnienia, a uprawnienia wynikają z tych nadanych w systemie. Certyfikat jest ważny najwyżej 2 lata. Obie metody działają równolegle.
- Źródła:
- „Certyfikaty KSeF”, Ministerstwo Finansów – ksef.podatki.gov.pl.
- „Pytania i odpowiedzi KSeF 2.0”, Ministerstwo Finansów – ksef.podatki.gov.pl.
- „Etapy wdrożenia KSeF”, Ministerstwo Finansów – ksef.podatki.gov.pl.
- Dokumentacja API KSeF 2.0 (wersja 2.9.0), sekcje „Tokeny KSeF” i „Uwierzytelnianie” – api.ksef.mf.gov.pl.


