Jak założyć i pobrać Token KSeF

Instrukcja krok po kroku dla Aplikacji Podatnika KSeF

Czym jest Token KSeF?

Token KSeF to unikalny ciąg znaków alfanumerycznych, który umożliwia automatyczne logowanie do systemu KSeF w aplikacjach zewnętrznych (np. programach księgowych, KSeF Monitor).

Dzięki tokenowi nie musisz za każdym razem logować się przez login.gov.pl lub używać certyfikatu kwalifikowanego - wystarczy raz wygenerować token i używać go w swoich aplikacjach.

                     Dla aplikacji KSeF Monitor: Wystarczy token z
                    uprawnieniem "przeglądanie
                        faktur" - aplikacja służy tylko do przeglądania i pobierania faktur.
                

Ważne informacje o tokenach

Tokeny działają do 31 grudnia 2026 r. - po tej dacie będzie trzeba używać certyfikatów KSeF
Token wyświetla się tylko RAZ - musisz go skopiować i bezpiecznie zapisać
Token to jak hasło - nie udostępniaj go nikomu
Token jest bezterminowy - działa do momentu jego unieważnienia

Strona główna Krajowego Systemu e-Faktur

Wejdź na stronę Aplikacji Podatnika KSeF

Otwórz przeglądarkę internetową i wejdź na stronę:

Środowisko produkcyjne (prawdziwe dane):
https://ksef.mf.gov.pl/

Środowisko testowe (do prób):
https://ksef-test.mf.gov.pl/

Na stronie głównej kliknij przycisk "Uwierzytelnij się w Krajowym Systemie e-Faktur"

Ekran wyboru metody uwierzytelnienia

Wybierz sposób logowania

System wyświetli dwa sposoby logowania. Wybierz jeden z nich:

Zaloguj przez login.gov.pl (opcja 1) - zalecana dla większości użytkowników
- Profil Zaufany
- Aplikacja mObywatel
- Bankowość elektroniczna
- E-dowód
Zaloguj certyfikatem kwalifikowanym (opcja 2) - dla firm i osób z certyfikatem

Wskazówka: Jeśli masz Profil Zaufany lub aplikację mObywatel, wybierz opcję "Zaloguj przez login.gov.pl" - to najprostsza i najszybsza metoda.

Ekran wprowadzania identyfikatora podmiotu

Wprowadź identyfikator podmiotu

Po wybraniu sposobu logowania, musisz wskazać kontekst logowania - czyli w czyim imieniu będziesz działać:

Wybierz typ identyfikatora:
- NIP firmy - jeśli prowadzisz działalność gospodarczą lub reprezentujesz firmę
- Identyfikator wewnętrzny - dla oddziałów i jednostek organizacyjnych
- VAT-UE - dla podmiotów z Unii Europejskiej
Wpisz numer NIP (10 cyfr bez kresek)
Kliknij przycisk "Przejdź dalej"

Uwierzytelnij się w systemie

Jeśli wybrałeś login.gov.pl:

Zostaniesz przekierowany na stronę login.gov.pl
Zaloguj się przez Profil Zaufany, mObywatel, bank lub e-dowód
Potwierdź dostęp do danych
Zostaniesz automatycznie przekierowany z powrotem do KSeF

Jeśli wybrałeś certyfikat kwalifikowany:

Pobierz żądanie autoryzacyjne
Podpisz plik swoim certyfikatem kwalifikowanym
Wgraj podpisany plik z powrotem do systemu

Po poprawnym uwierzytelnieniu zostaniesz przekierowany do aplikacji Podatnika KSeF. Zobaczysz menu główne z różnymi opcjami.

Przejdź do generowania tokenów

Po zalogowaniu do Aplikacji Podatnika KSeF:

Znajdź w menu głównym opcję "Tokeny"
Kliknij "Generowanie tokena"

Gdzie znajdę opcję "Tokeny"?
Opcja znajduje się w menu głównym aplikacji, zazwyczaj w sekcji związanej z uwierzytelnieniem i uprawnieniami.

Formularz do wygenerowania nowego tokena

Wypełnij formularz generowania tokena

Wypełnij formularz, aby wygenerować token:

Nazwa tokena
- Wpisz opisową nazwę, np. "Token do KSeF Monitor"
- Nazwa pomoże Ci rozpoznać, gdzie używasz tego tokena
- Maksymalnie 256 znaków
Wybierz uprawnienia powiązane z tokenem
- wystawianie faktur - możliwość wystawiania e-faktur
- przeglądanie faktur - dostęp do faktur wystawionych i otrzymanych ⭐ WYMAGANE dla KSeF Monitor
- przeglądanie uprawnień - podgląd uprawnień innych osób
- zarządzanie uprawnieniami - nadawanie uprawnień innym
- zarządzanie jednostkami podrzędnymi - dla struktur organizacyjnych
- przeglądanie historii sesji - generowanie UPO

Po wypełnieniu formularza kliknij przycisk "Generuj token"

Dla aplikacji KSeF Monitor

WYSTARCZY ZAZNACZONE TYLKO:

przeglądanie faktur - to jedyne uprawnienie niezbędne do działania aplikacji KSeF Monitor

Aplikacja KSeF Monitor służy do przeglądania, wyszukiwania i pobierania faktur z systemu KSeF. Nie potrzebuje uprawnień do wystawiania faktur ani zarządzania uprawnieniami.

Dla innych zastosowań:
Możesz wybrać więcej uprawnień, jeśli planujesz używać tokena również w innych aplikacjach lub potrzebujesz dodatkowych funkcji (np. wystawianie faktur).

Poczekaj na wygenerowanie tokena

System rozpocznie proces generowania tokena:

Zobaczysz komunikat "W realizacji" z informacją:

"Twoje żądanie jest w trakcie przetwarzania. Operacja może potrwać kilka minut."

Kliknij przycisk "Odśwież", aby sprawdzić, czy token został już wygenerowany.

Token wyświetla się tylko raz - skopiuj go natychmiast!

SKOPIUJ I ZAPISZ TOKEN!

To najważniejszy krok! Po poprawnym wygenerowaniu zobaczysz ekran z tokenem.

UWAGA! Token wyświetla się tylko RAZ!

Po opuszczeniu tej strony nie będziesz miał możliwości ponownego pobrania tokena.

Jeśli go nie zapiszesz, będziesz musiał wygenerować nowy token.

Co zrobić z tokenem:

Kliknij przycisk "Kopiuj" - token zostanie skopiowany do schowka
NATYCHMIAST wklej go w bezpieczne miejsce:
- Notatnik/plik tekstowy (zapisz na swoim komputerze)
- Menedżer haseł (1Password, LastPass, Bitwarden)
- Dokument chroniony hasłem

Format tokena

Token składa się z trzech części oddzielonych znakiem | (pionowa kreska):

20251021-EC-1E23E32000-334F83FECA-3A|nip-1111111111|feb915d32084af2a34297bbbd9c7dad9d9101aba8aa4dbb964e105767e38412

[ID tokena]|[kontekst]|[klucz autoryzacyjny]

Dostępne przyciski po wygenerowaniu:

Lista tokenów - przejdź do listy wszystkich swoich tokenów
Wygeneruj kolejny token - stwórz kolejny token z innymi uprawnieniami

Użyj tokena w aplikacji KSeF Monitor

Teraz możesz użyć wygenerowanego tokena w aplikacji KSeF Monitor:

Otwórz aplikację KSeF Monitor
Przejdź do sekcji Ustawienia lub Logowanie
Znajdź pole "Token KSeF"
Wklej skopiowany token (Ctrl+V lub Cmd+V)
Kliknij "Zapisz" lub "Zaloguj"

Pamiętaj: Token musi mieć uprawnienie "przeglądanie faktur" - to jedyne uprawnienie wymagane przez aplikację KSeF Monitor.

Gotowe!

Od teraz aplikacja KSeF Monitor będzie automatycznie logować się do systemu KSeF za pomocą Twojego tokena.

Nie musisz już za każdym razem logować się przez login.gov.pl!

Z tokenem możesz:

Przeglądać wszystkie faktury wystawione i otrzymane
Wyszukiwać faktury według różnych kryteriów
Pobierać faktury w formacie XML i PDF
Eksportować dane faktur

Zasady bezpieczeństwa tokenów

NIE udostępniaj tokena nikomu - to jak hasło do Twojego konta
NIE wysyłaj tokena emailem ani przez komunikatory
NIE publikuj tokena w internecie, na forach, w kodzie źródłowym
Przechowuj token bezpiecznie - w menedżerze haseł lub chronionym pliku
Unieważnij stary token, jeśli podejrzewasz wyciek
Generuj osobne tokeny dla różnych aplikacji

Zarządzanie tokenami

Lista tokenów - aby zobaczyć wszystkie swoje tokeny:

Zaloguj się do Aplikacji Podatnika KSeF
Przejdź do Tokeny → Lista tokenów
Zobaczysz listę wszystkich wygenerowanych tokenów z informacjami:
- Nazwa tokena
- Twórca tokena
- Data aktywacji
- Data ostatniego użycia

Unieważnienie tokena - jeśli token wyciekł lub go już nie używasz:

Wejdź na listę tokenów
Zaznacz token, który chcesz unieważnić (checkbox)
Kliknij przycisk "Unieważnij"
Potwierdź akcję

Wskazówka: Możesz mieć wiele tokenów jednocześnie! Warto utworzyć osobne tokeny dla różnych aplikacji - dzięki temu łatwiej zarządzać dostępem i bezpieczeństwem.

Najczęściej zadawane pytania (FAQ)

Q: Jak długo token jest ważny?

A: Token jest bezterminowy - działa do momentu jego ręcznego unieważnienia. Pamiętaj jednak, że możliwość używania tokenów wygasa 31 grudnia 2026 r.

Q: Co zrobić jeśli zapomniałem skopiować token?

A: Niestety token wyświetla się tylko raz. Musisz wygenerować nowy token. Stary token (którego nie skopiowałeś) nadal istnieje, ale nie możesz go odczytać - możesz go tylko unieważnić na liście tokenów.

Q: Czy mogę mieć więcej niż jeden token?

A: Tak! Możesz wygenerować dowolną liczbę tokenów. To świetna praktyka - utwórz osobne tokeny dla różnych aplikacji.

Q: Jakie uprawnienia są potrzebne dla aplikacji KSeF Monitor?

A: Aplikacja KSeF Monitor wymaga TYLKO uprawnienia "przeglądanie faktur". To wystarczy do:

Przeglądania faktur wystawionych i otrzymanych
Wyszukiwania faktur
Pobierania faktur (XML i PDF)
Eksportowania danych

Nie potrzebujesz uprawnień do wystawiania faktur ani zarządzania uprawnieniami.

Q: Co się stanie, gdy zmienią się moje uprawnienia?

A: Token automatycznie odzwierciedli zmiany w uprawnieniach. Jeśli uprawnienia zostaną odebrane, token przestanie działać. Jeśli zostaną dodane nowe uprawnienia, nie będą one automatycznie dodane do tokena - musisz wygenerować nowy token.

Q: Czy token działa w Aplikacji Podatnika KSeF?

A: NIE - token służy tylko do uwierzytelnienia w aplikacjach zewnętrznych (komercyjnych) przez API. W Aplikacji Podatnika KSeF musisz logować się przez login.gov.pl lub certyfikat.

Q: Co zrobić, jeśli token przestał działać?

A: Sprawdź czy:

Token nie został unieważniony (sprawdź na liście tokenów)
Nie utraciłeś uprawnień przypisanych do tokena
Kopiujesz cały token (wszystkie 3 części z symbolami |)

Jeśli wszystko jest OK, a token nie działa - wygeneruj nowy.

Źródło dokumentacji: Aplikacja Podatnika KSeF 2.0 - Podręcznik użytkownika (wersja 01.04.2026)