Token KSeF: jak wygenerować go i do czego służy

Aktualizacja:

Token KSeF tworzysz samodzielnie w Aplikacji Podatnika KSeF. Najpierw logujesz się do niej, np. profilem zaufanym lub certyfikatem. Przy tworzeniu wybierasz uprawnienia tokena, a system pokazuje go tylko raz, więc musisz go od razu skopiować i bezpiecznie zapisać.

Poniżej znajdziesz instrukcję krok po kroku, zasady nadawania uprawnień i sposoby przechowywania tokena, które chronią Twoje faktury.

Czym jest token KSeF

Token to ciąg znaków powiązany z konkretnymi uprawnieniami w Krajowym Systemie e-Faktur. Działa jak klucz: kto go ma, może połączyć się z KSeF w kontekście Twojej firmy, ale tylko w zakresie, który nadałeś przy tworzeniu.

To jedna z metod dostępu do systemu. Obok niej są m.in. profil zaufany i certyfikat (kwalifikowany lub certyfikat KSeF). Przegląd wszystkich sposobów wejścia do systemu znajdziesz w tekście o metodach logowania do KSeF.

Do czego służy token

Token przydaje się tam, gdzie z KSeF łączy się program, a nie człowiek siedzący przy przeglądarce. Typowe zastosowania:

  • Automatyczny odbiór faktur kosztowych. Aplikacja sama sprawdza, czy pojawiły się nowe faktury, na których Twoja firma jest nabywcą.
  • Integracje. Program do faktur, system księgowy albo własny skrypt łączy się z KSeF bez Twojego udziału przy każdym połączeniu.
  • Dostęp bez certyfikatu. Narzędzie nie musi obsługiwać podpisu elektronicznego, wystarczy mu token.

Token i certyfikat różnią się sposobem użycia i poziomem zabezpieczeń. Szczegółowe porównanie znajdziesz w artykule certyfikat KSeF czy token.

Token KSeF: jak wygenerować go krok po kroku

Opis jest ogólny, bo wygląd Aplikacji Podatnika KSeF może się zmienić, a nazwy sekcji i przycisków bywają aktualizowane. Kolejność działań pozostaje podobna.

  1. Zaloguj się do Aplikacji Podatnika KSeF. To darmowa aplikacja Ministerstwa Finansów działająca w przeglądarce. Do pierwszego wejścia użyj np. profilu zaufanego lub certyfikatu.
  2. Przejdź do sekcji dotyczącej tokenów. Zwykle znajdziesz ją w części panelu związanej z dostępem i uprawnieniami.
  3. Opisz token, jeśli panel na to pozwala. Wpisz, do czego służy, np. nazwę programu, który z niego skorzysta. Po kilku miesiącach łatwiej Ci będzie rozpoznać, który token do czego należy.
  4. Wybierz uprawnienia. Zaznacz tylko te, których narzędzie naprawdę potrzebuje. Do samego odbioru faktur wystarczy przeglądanie faktur.
  5. Ustaw okres ważności, jeśli panel o niego pyta. Najnowsze tokeny mogą mieć ograniczony czas działania, wybierany przy tworzeniu. Co się dzieje po jego upływie, opisaliśmy w tekście o ważności tokena KSeF.
  6. Wygeneruj token i od razu go skopiuj. System wyświetla go tylko raz. Po zamknięciu okna nie odczytasz go ponownie.
  7. Sprawdź, czy token wymaga zatwierdzenia. Niektóre tokeny mogą potrzebować dodatkowego zatwierdzenia, zanim zaczną działać.
  8. Wklej token do programu, który ma z niego korzystać, i sprawdź, czy połączenie działa.

Jakie uprawnienia nadać tokenowi

Zasada jest prosta: token powinien mieć minimum uprawnień potrzebnych do konkretnego zadania. Gdyby wyciekł, osoba trzecia zrobi tylko to, na co token pozwala.

Do czego potrzebujesz tokenaJakie uprawnienie wystarczy
Odbiór i podgląd faktur kosztowychPrzeglądanie faktur
Wystawianie faktur z programuWystawianie faktur
Zarządzanie dostępem innych osóbZarządzanie uprawnieniami (rzadko potrzebne narzędziom)

Jeśli aplikacja do odbioru faktur prosi o uprawnienie do wystawiania albo zarządzania uprawnieniami, zapytaj dostawcę, po co mu ono. Więcej o tym zakresie dostępu przeczytasz w tekście o uprawnieniu do przeglądania faktur.

Jak przechowywać token

Token jest wyświetlany tylko raz, więc zapisz go od razu, zanim zamkniesz okno. Kilka praktycznych zasad:

  • Trzymaj go w menedżerze haseł, a nie w zwykłym pliku tekstowym na pulpicie.
  • Nie wysyłaj go otwartym e-mailem ani komunikatorem. Jeśli musisz komuś przekazać token, użyj bezpiecznego kanału i usuń wiadomość po użyciu.
  • Nie wpisuj go do arkusza współdzielonego z innymi osobami.
  • Twórz osobny token dla każdego programu. Gdy zrezygnujesz z jednego narzędzia, unieważnisz tylko jego token, a reszta będzie działać dalej.
  • Zapisz obok tokena, kiedy go utworzyłeś i do czego służy.

Gdy token wyciekł lub przestał być potrzebny

Token możesz unieważnić w Aplikacji Podatnika KSeF w każdej chwili, w tej samej części panelu, w której go tworzyłeś. Po unieważnieniu żaden program nie połączy się już z jego pomocą.

Zrób to od razu, gdy:

  • podejrzewasz, że ktoś niepowołany zobaczył token,
  • rezygnujesz z programu, który z niego korzystał,
  • zmieniasz biuro rachunkowe albo dostawcę usługi.

Jeśli narzędzie nadal ma działać, wygeneruj nowy token i wklej go w ustawieniach programu.

Token w praktyce: odbiór faktur kosztowych

Faktur kosztowych w KSeF z każdym miesiącem przybywa, bo coraz więcej dostawców wystawia je w systemie. KSeF nie ma standardowego powiadomienia o nowej fakturze, dlatego wiele firm korzysta z narzędzi, które łączą się z systemem na tokenie i robią to za nich.

Tak działa ksefapp. Potrzebuje tokena wyłącznie z uprawnieniem do przeglądania faktur, przechowuje go zaszyfrowanego i niczego w KSeF nie zmienia, tylko czyta. Mniej więcej co 15 minut sprawdza nowe faktury kosztowe i wysyła Ci alert e-mailem lub na Telegramie. W wybranym dniu miesiąca wysyła księgowej paczkę z plikami PDF i XML oraz zestawieniem w CSV i XLSX. Token możesz unieważnić w KSeF w każdej chwili. Start usługi planujemy przed 1.01.2027, a cennik jest na stronie głównej.

Jeśli chcesz dostać informację o starcie, zapisz się na listę ksefapp. Pozostałe instrukcje dotyczące systemu znajdziesz w dziale Poradnik KSeF.

Najczęściej zadawane pytania

Co zrobić, jeśli nie skopiowałem tokena przy tworzeniu?

Tokena nie da się wyświetlić drugi raz. Unieważnij ten, którego nie zapisałeś, i wygeneruj nowy. Tym razem skopiuj go od razu do menedżera haseł albo do programu.

Czy token z uprawnieniem do przeglądania pozwala wystawić fakturę?

Nie, jeśli przy tworzeniu nie nadałeś mu uprawnienia do wystawiania faktur. Token działa tylko w zakresie wybranych uprawnień. Dlatego do samego odbioru faktur kosztowych wystarczy przeglądanie.

Czy mogę użyć jednego tokena w kilku programach?

Bezpieczniej jest utworzyć osobny token dla każdego narzędzia. Gdy zrezygnujesz z jednego programu, unieważnisz tylko jego token i nie odetniesz pozostałych. Łatwiej też ustalisz, który program korzysta z którego dostępu.

Jak długo token KSeF jest ważny?

Najnowsze tokeny mogą mieć ograniczony okres ważności, wybierany przy tworzeniu. Po jego upływie logowanie tokenem kończy się błędem i trzeba utworzyć nowy. Szczegóły opisaliśmy w osobnym artykule o ważności tokena.

Czy biuro rachunkowe potrzebuje mojego tokena?

Niekoniecznie. Właściciel firmy może nadać uprawnienia bezpośrednio biuru rachunkowemu, które loguje się wtedy własnymi danymi. Sposób współpracy w KSeF ustal ze swoją księgową.

Ostatnia aktualizacja: 17 listopada 2026. Tekst ma charakter informacyjny i nie jest poradą prawną ani podatkową. W wątpliwościach skonsultuj się z księgową lub sprawdź komunikaty Ministerstwa Finansów.