Token KSeF
Token KSeF to poufny ciąg znaków wygenerowany w KSeF, którym program uwierzytelnia się w systemie w imieniu firmy, bez podpisu kwalifikowanego przy każdym połączeniu. Token ma na stałe przypisane uprawnienia wybrane przy jego tworzeniu, np. tylko przeglądanie faktur. Obecnie token nie ma terminu ważności: działa, dopóki ktoś go nie unieważni.
- Inaczej
- token autoryzacyjny KSeF, token do KSeF, token API KSeF, token uwierzytelniający
W praktyce
Token służy programom: systemom do fakturowania, księgowym, ERP i narzędziom do pobierania faktur. Zamiast logować się co chwilę podpisem kwalifikowanym czy Profilem Zaufanym, program uwierzytelnia się tokenem i działa w zakresie jego uprawnień.
Cztery zasady bezpieczeństwa:
- Minimalne uprawnienia. Token do pobierania faktur nie potrzebuje prawa do ich wystawiania. Uprawnień tokenu nie da się później zmienić, trzeba wygenerować nowy token.
- Brak daty ważności nie znaczy „na zawsze”. Dziś token działa do unieważnienia, ale zapowiadany termin ważności (od 1 do 365 dni) może to zmienić. Sprawdź, które programy korzystają z tokenów firmy.
- Token to sekret. Kto go zna, może działać w KSeF w zakresie jego uprawnień. Przechowuj go jak hasło i nie wysyłaj otwartym mailem.
- Unieważniaj nieużywane. Gdy rezygnujesz z programu albo podejrzewasz wyciek, unieważnij token.
Jak to działa
- Osoba z uprawnieniami w firmie loguje się do Aplikacji Podatnika KSeF (np. podpisem kwalifikowanym, Profilem Zaufanym albo w aplikacji mObywatel).
- Generuje token: wybiera uprawnienia, np. „przeglądanie faktur”, i dodaje opis, żeby wiedzieć, do czego służy.
- Wkleja token w ustawieniach programu. Od tej pory program sam uwierzytelnia się w API KSeF.
Przykład
Właścicielka sklepu internetowego chce, żeby faktury kosztowe same trafiały do jej arkusza. Loguje się do Aplikacji Podatnika Profilem Zaufanym, generuje token tylko z uprawnieniem do przeglądania faktur i podaje go w narzędziu do pobierania faktur. Gdy po roku zmienia narzędzie, unieważnia stary token i generuje nowy.
Zmiany w przepisach
- projekt
Ministerstwo Finansów zaproponowało na konsultacjach, żeby tokeny zostały także po 31 grudnia 2026 r., ale z terminem ważności od 1 do 365 dni i nowym uprawnieniem do automatycznego odnawiania tokenu za zgodą właściciela. Zmiana wymaga nowelizacji rozporządzenia w sprawie korzystania z KSeF, która nie jest jeszcze przyjęta, a termin wejścia w życie nie jest znany. Do tego czasu tokeny działają bezterminowo.
Powiązane pojęcia
Certyfikat KSeF
Certyfikat KSeF to certyfikat cyfrowy wydawany przez KSeF, który służy do uwierzytelniania się w systemie (typ 1) albo do oznaczania faktur wystawionych w trybie offline kodem QR potwierdzającym tożsamość wystawcy (typ 2). Jest ważny najwyżej 2 lata. W odróżnieniu od tokenu sam nie niesie żadnych uprawnień.
Uprawnienia w KSeF
Uprawnienia w KSeF określają, kto i co może robić w systemie w imieniu firmy: wystawiać faktury, przeglądać je, zarządzać uprawnieniami innych osób albo obsługiwać jednostki podrzędne. Nadaje je właściciel firmy albo osoba z uprawnieniem do zarządzania uprawnieniami, w Aplikacji Podatnika KSeF albo przez API.
Integracja z KSeF
Integracja z KSeF to połączenie programu z Krajowym Systemem e-Faktur przez publiczne API KSeF 2.0. Może to być program do fakturowania, system księgowy, ERP albo narzędzie do analizy faktur. Dzięki integracji program sam wysyła faktury do KSeF albo je z niego pobiera, bez ręcznej pracy w Aplikacji Podatnika.
Automatyczne pobieranie faktur z KSeF
Automatyczne pobieranie faktur z KSeF polega na tym, że program regularnie łączy się z KSeF przez API, wyszukuje nowe faktury firmy i zapisuje je jako pliki XML, PDF albo dane w tabeli. Nikt nie musi ręcznie logować się do Aplikacji Podatnika. Do samego pobierania wystarczy uprawnienie do przeglądania faktur.
Aplikacja Podatnika KSeF
Aplikacja Podatnika KSeF to bezpłatna aplikacja internetowa Ministerstwa Finansów do pracy w Krajowym Systemie e-Faktur. Pozwala wystawiać, odbierać i przeglądać faktury w strukturze FA(3), pobierać je jako XML albo PDF, zarządzać uprawnieniami, generować tokeny i zamawiać certyfikaty KSeF. Wersja 2.0 działa produkcyjnie od 1 lutego 2026 r.
Najczęstsze pytania
Czy tokeny KSeF przestaną działać po 2026 roku?
Według Ministerstwa Finansów nie. Pierwotnie tokeny miały być dostępne do końca 2026 r., ale MF zdecydowało, że zostaną także później. Zapowiada przy tym, że tokeny dostaną termin ważności od 1 do 365 dni z możliwością automatycznego odnowienia. Wymaga to zmiany rozporządzenia, która nie jest jeszcze przyjęta.
Jak długo ważny jest token KSeF?
Obecnie bezterminowo: KSeF nie określa czasu ważności tokenu, więc działa on, dopóki nie zostanie unieważniony. Ministerstwo Finansów zaproponowało termin ważności od 1 do 365 dni, ale na razie to projekt.
Jakie uprawnienia nadać tokenowi?
Tylko te, których program naprawdę potrzebuje. Do pobierania faktur wystarczy przeglądanie faktur. Wystawianie faktur jest potrzebne tylko programom, które wysyłają faktury do KSeF.
Czy token można unieważnić?
Tak. Token unieważnia się w Aplikacji Podatnika KSeF albo przez API. Od tej chwili program, który go używał, traci dostęp. Zmiana uprawnień tokenu też wymaga wygenerowania nowego.
Czym token różni się od certyfikatu KSeF?
Token zawiera uprawnienia zadeklarowane przy jego tworzeniu. Certyfikat KSeF tylko potwierdza tożsamość, a zakres działań wynika z uprawnień posiadacza w danym kontekście. MF podkreśla, że funkcjonalnie nie są one równoważne.
Źródła
- Certyfikaty KSeF (sekcja „Certyfikaty KSeF a tokeny”)Ministerstwo Finansów, ksef.podatki.gov.pl
- Zarządzanie tokenami KSeF (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
- Pierwsze konsultacje po częściowym wdrożeniu KSeF - podsumowanieMinisterstwo Finansów, ksef.podatki.gov.pl (11.06.2026)
- Uprawnienia i autoryzacjaMinisterstwo Finansów, ksef.podatki.gov.pl
Treść sprawdzona ze źródłami: . Przepisy o KSeF często się zmieniają, więc przed decyzją podatkową sprawdź aktualny stan w źródłach.
Widzisz błąd albo nieaktualną informację? Daj nam znać, a poprawimy.
