Strona główna › Poradnik › Token KSeF
Poradnik · KSeF

Token KSeF 2.0: jak go wygenerować i jakie uprawnienia nadać

Zespół PewnyJPK.pl·Ostatnia aktualizacja: 17 listopada 2026
Token KSeF to ciąg znaków, którym program, integracja albo narzędzie loguje się do KSeF w imieniu firmy. W KSeF 2.0 generujesz go w Aplikacji Podatnika KSeF i od razu wybierasz jego uprawnienia, np. tylko przeglądanie faktur. Token wyświetla się raz, więc skopiuj go od razu. Tokeny z KSeF 1.0 nie działają w KSeF 2.0, a Ministerstwo Finansów zdecydowało, że tokeny zostaną w systemie bezterminowo, a nie tylko do końca 2026 r.

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:

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.

Tokeny z KSeF 1.0 nie działają Tokeny wygenerowane w KSeF 1.0 nie są zgodne z KSeF 2.0. Jeśli program nadal ma zapisany stary token, logowanie się nie powiedzie i trzeba wygenerować nowy. Nie szukaj też tokenów w Module Certyfikatów i Uprawnień (MCU): działał tylko do końca stycznia 2026 r. i został wyłączony razem z KSeF 1.0.

Jak wygenerować token w Aplikacji Podatnika KSeF

  1. 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.
  2. Wskaż kontekst, czyli firmę (NIP), dla której ma działać token.
  3. Przejdź do zarządzania tokenami i wygeneruj nowy token.
  4. 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”.
  5. Zaznacz uprawnienia tokena. Wybierz tylko te, których naprawdę potrzebuje program albo osoba (tabela niżej).
  6. 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:

UprawnienieCo dajeKiedy nadać
InvoiceReadprzeglądanie fakturpobieranie faktur kosztowych i sprzedażowych, generowanie identyfikatorów zbiorczych
InvoiceWritewystawianie fakturprogram, który wysyła faktury do KSeF
CollectiveIdentifierManagezarządzanie identyfikatorami zbiorczymiosoba lub system, który tylko tworzy identyfikatory do przelewów
CredentialsReadprzeglądanie uprawnieńkontrola, kto ma dostęp do KSeF firmy
CredentialsManagezarządzanie uprawnieniamiadministrator KSeF w firmie; nadawaj ostrożnie
Introspectionprzeglądanie historii sesji i generowanie UPOprogram, który pobiera UPO i sprawdza sesje wysyłki
SubunitManagezarządzanie jednostkami podrzędnymipodmioty, które mają jednostki podrzędne
EnforcementOperationswykonywanie operacji egzekucyjnychwyłą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

StatusCo oznacza
Pendingtoken utworzony, trwa aktywacja i nadawanie uprawnień; nie da się nim jeszcze zalogować
Activetoken działa i można go używać do logowania
Revokingtrwa unieważnianie; token już nie działa
Revokedtoken unieważniony na stałe
Failedaktywacja 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:

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 KSeFCertyfikat KSeF
Uprawnieniama własne, wybrane przy generowaniutylko uwierzytelnia; uprawnienia wynikają z tych nadanych w KSeF
Ważnośćdo unieważnienia; tokeny zostają bezterminowonajwyżej 2 lata od wytworzenia lub od wskazanej daty początkowej
Rodzajejedendo 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

PrzyczynaCo 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.0Nie działa w KSeF 2.0. Wygeneruj nowy w Aplikacji Podatnika KSeF 2.0.
Status Pending albo FailedPrzy Pending poczekaj na zmianę statusu na Active. Przy Failed wygeneruj nowy token.
Inny NIP niż kontekst tokenaToken działa tylko dla firmy, w której go wygenerowano. Sprawdź NIP wpisany w programie.
Brak uprawnieniaLogowanie się udaje, ale operacja zwraca odmowę. Wygeneruj token z potrzebnym uprawnieniem; uprawnień istniejącego tokena się nie dopisuje.
Token unieważnionySprawdź 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.

Bezpłatny PDF + newsletter

Lista kontrolna JPK_KR_PD na e-mail

20 punktów, których nie sprawdzi bramka MF, z objaśnieniami i kalendarzem sezonu 2027. Wyślemy ją po potwierdzeniu zapisu, a potem nowe artykuły poradnika i zmiany w JPK_KR_PD. Wypiszesz się jednym kliknięciem z każdej wiadomości.

Zanim wyjdziesz

Zabierz bezpłatny PDF: lista kontrolna JPK_KR_PD

Bezpłatnie
  • 20 punktów, których nie sprawdzi bramka MF
  • Objaśnienia, wskazówki i typowe błędy z praktyki
  • Kalendarz sezonu 2027 – od pliku próbnego do 31 lipca

Podaj e-mail – PDF wyślemy od razu po potwierdzeniu zapisu, a potem nowe artykuły poradnika. Wypiszesz się jednym kliknięciem.