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.
- 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.
- Przejdź do sekcji dotyczącej tokenów. Zwykle znajdziesz ją w części panelu związanej z dostępem i uprawnieniami.
- 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.
- Wybierz uprawnienia. Zaznacz tylko te, których narzędzie naprawdę potrzebuje. Do samego odbioru faktur wystarczy przeglądanie faktur.
- 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.
- Wygeneruj token i od razu go skopiuj. System wyświetla go tylko raz. Po zamknięciu okna nie odczytasz go ponownie.
- Sprawdź, czy token wymaga zatwierdzenia. Niektóre tokeny mogą potrzebować dodatkowego zatwierdzenia, zanim zaczną działać.
- 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 tokena | Jakie uprawnienie wystarczy |
|---|---|
| Odbiór i podgląd faktur kosztowych | Przeglądanie faktur |
| Wystawianie faktur z programu | Wystawianie faktur |
| Zarządzanie dostępem innych osób | Zarzą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.