KSeF: certyfikat a token. Czym się różnią i co wybrać

Aktualizacja:

Token i certyfikat to dwa sposoby, w jakie aplikacja lub integracja może potwierdzić w KSeF, kto się łączy. Token jest prostszy: to ciąg znaków powiązany z konkretnymi uprawnieniami. Certyfikat jest formalniejszy i częściej używają go biura rachunkowe oraz większe integracje.

Poniżej znajdziesz porównanie i wskazówki, kiedy co ma sens. Zasady dostępu do KSeF bywają zmieniane, więc przed decyzją sprawdź aktualne komunikaty Ministerstwa Finansów.

Po co w ogóle uwierzytelnienie

Każde narzędzie, które czyta lub wysyła faktury w KSeF, musi najpierw udowodnić systemowi, że ma do tego prawo. Bez tego nie pobierze żadnej faktury.

Według dokumentacji API proces zaczyna się od tzw. challenge, czyli jednorazowego wyzwania od systemu. Odpowiedź na nie może mieć jedną z dwóch form:

  • podpis XAdES złożony certyfikatem,
  • token zaszyfrowany kluczem publicznym Ministerstwa Finansów.

Na tym polega cały spór o certyfikat a token w KSeF. Obie drogi prowadzą do tego samego celu, ale różnią się wygodą, zakresem i tym, kto zwykle z nich korzysta.

Osoby logujące się ręcznie w przeglądarce mają do wyboru jeszcze inne metody, np. profil zaufany. Ich przegląd znajdziesz w tekście o metodach logowania do KSeF.

Token: klucz z przypiętymi uprawnieniami

Token to ciąg znaków tworzony w KSeF. Przy jego tworzeniu wybierasz, jakie uprawnienia ma dostać, np. tylko przeglądanie faktur. Narzędzie, które go używa, nie zrobi nic ponad ten zakres.

Kilka cech, o których warto pamiętać:

  • Token jest pokazywany tylko raz, w chwili utworzenia. Trzeba go od razu bezpiecznie zapisać lub przekazać.
  • Najnowsze tokeny mogą mieć ograniczony okres ważności wybierany przy tworzeniu i mogą wymagać zatwierdzenia.
  • Token możesz w każdej chwili unieważnić. Narzędzie traci wtedy dostęp od razu.

Po wygaśnięciu tokena logowanie kończy się błędem, a pobieranie faktur staje. Co wtedy zrobić, opisuje strona o ważności tokena KSeF. Sam proces tworzenia jest opisany osobno, w poradniku jak wygenerować token KSeF.

Certyfikat: potwierdzenie tożsamości

Certyfikat działa inaczej. Nie jest kluczem do konkretnego zakresu działań, tylko potwierdza, kim jest osoba lub podmiot, który się łączy. KSeF akceptuje certyfikat kwalifikowany albo certyfikat KSeF.

To, co można zrobić po uwierzytelnieniu certyfikatem, wynika z uprawnień nadanych w KSeF tej osobie lub firmie. Jeśli ktoś ma szerokie uprawnienia, integracja oparta na jego certyfikacie również je ma.

Przy użyciu technicznym certyfikat służy do złożenia podpisu XAdES pod odpowiedzią na challenge. To rozwiązanie bardziej formalne i zwykle wymaga więcej pracy przy wdrożeniu, za to dobrze pasuje tam, gdzie jedna tożsamość obsługuje wiele firm lub wiele procesów.

Porównanie w skrócie

Tabela pokazuje typowe różnice. Szczegóły mogą zależeć od wersji systemu i zmian w przepisach.

CechaTokenCertyfikat
Czym jestCiąg znaków utworzony w KSeFCertyfikat kwalifikowany lub certyfikat KSeF
Co potwierdzaDostęp w wybranym zakresie uprawnieńTożsamość osoby lub podmiotu
Zakres działańUstalany przy tworzeniu tokenaWynika z uprawnień nadanych tej tożsamości
Sposób użycia w APIToken zaszyfrowany kluczem publicznym MFPodpis XAdES
WdrożenieZwykle prostszeZwykle bardziej wymagające
Typowy użytkownikJDG, mikrofirma, pojedyncze narzędzieBiura rachunkowe, większe integracje
Odcięcie dostępuUnieważnienie tokenaZmiana uprawnień lub unieważnienie certyfikatu

Kiedy token, a kiedy certyfikat

Mała firma i jedno narzędzie

Jeśli prowadzisz JDG lub mikrofirmę i chcesz podłączyć narzędzie, które ma tylko odbierać faktury kosztowe, token zwykle wystarcza. Nadajesz mu wyłącznie uprawnienie do przeglądania faktur i wiesz dokładnie, na co pozwala.

Gdy przestaniesz korzystać z narzędzia, unieważniasz token. Nie musisz zmieniać niczego w swoim sposobie logowania ani w uprawnieniach innych osób.

Biuro rachunkowe i większe integracje

Biuro obsługujące wielu klientów często pracuje w oparciu o certyfikat i uprawnienia, które klienci nadali biuru. Jedna tożsamość, wiele firm. To wygodne przy dużej skali, ale wymaga porządku w tym, kto ma jakie uprawnienia u którego klienta.

Jakie uprawnienia nadać biuru, żeby mogło pracować, a nie miało dostępu do wszystkiego, opisuje tekst o uprawnieniach dla biura rachunkowego. Wybór metody warto omówić z samym biurem, bo zależy od jego programów i sposobu pracy.

Zasada najmniejszych uprawnień

Niezależnie od metody, daj narzędziu tylko to, czego potrzebuje. Do samego odbioru faktur wystarczy przeglądanie. Wystawianie faktur czy zarządzanie uprawnieniami to zupełnie inny poziom dostępu.

Praktyczne nawyki:

  1. Do każdego zewnętrznego narzędzia twórz osobny token, z możliwie wąskim zakresem uprawnień.
  2. Zapisuj, któremu narzędziu dałeś który dostęp i do kiedy jest ważny.
  3. Gdy rezygnujesz z usługi albo zmieniasz biuro, od razu odbieraj dostęp.
  4. Okresowo przeglądaj nadane uprawnienia w Aplikacji Podatnika KSeF. Wygląd panelu może się zmieniać, więc szukaj sekcji dotyczącej tokenów i uprawnień.

Jak to działa w ksefapp

ksefapp korzysta z tokena z jednym uprawnieniem: przeglądanie faktur. Na tej podstawie co ok. 15 minut sprawdza KSeF, wysyła alert o nowej fakturze kosztowej na e-mail lub Telegram i w wybranym dniu miesiąca przesyła księgowej paczkę z plikami PDF i XML oraz zestawieniem CSV i XLSX.

ksefapp nie wystawia faktur i niczego nie zmienia w KSeF, tylko czyta. Token jest przechowywany w postaci zaszyfrowanej, a Ty możesz go w każdej chwili unieważnić w KSeF.

Aplikacja startuje przed 1.01.2027, a cennik znajdziesz na stronie głównej. Jeśli chcesz dostać informację o starcie, zapisz się na listę ksefapp. Więcej tematów związanych z dostępem i odbiorem faktur znajdziesz w Poradniku KSeF.

Najczęściej zadawane pytania

Czy do odbioru faktur kosztowych wystarczy token?

W typowej sytuacji tak. Do pobierania faktur, na których Twoja firma jest nabywcą, wystarczy uprawnienie do przeglądania faktur, a token może mieć dokładnie taki zakres. Wystawianie faktur wymaga innych uprawnień.

Czy certyfikat jest bezpieczniejszy od tokena?

To zależy od sposobu użycia, a nie od samej metody. Token z wąskim zakresem uprawnień ogranicza ryzyko do tego, na co pozwala. Certyfikat daje dostęp zgodny z uprawnieniami danej tożsamości, które mogą być szerokie.

Co się dzieje, gdy token przestanie działać?

Jeśli token wygaśnie lub zostanie unieważniony, logowanie nim kończy się błędem i narzędzie przestaje pobierać faktury. Trzeba utworzyć nowy token i przekazać go narzędziu. Do tego czasu faktury nadal trafiają do KSeF, tylko nikt ich automatycznie nie odbiera.

Czy biuro rachunkowe musi używać certyfikatu?

Nie ma jednej reguły dla wszystkich biur. Wybór zależy od programów, z których biuro korzysta, i od tego, jak organizuje pracę z klientami. Zasady dostępu mogą się zmieniać, więc warto śledzić komunikaty Ministerstwa Finansów.

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.