Czym się różni token od certyfikatu w KSeF i co wybrać?
Każda firma podłączona do KSeF musi podjąć jedną konkretną decyzję techniczną, zanim zacznie automatycznie wystawiać i pobierać faktury przez API: jak ma się uwierzytelniać w systemie? Przez lata jedyną opcją był token. Od 1 lutego 2026 roku dostępny jest certyfikat KSeF, a od 1 stycznia 2027 roku token przestanie istnieć. Dla firm budowlanych i deweloperskich, które przetwarzają setki faktur miesięcznie i korzystają z systemów ERP zintegrowanych z KSeF, jest to decyzja o realnych konsekwencjach operacyjnych. Poniżej wyjaśniamy, czym oba rozwiązania różnią się technicznie, kiedy jedno przeważa nad drugim i jakie kroki należy podjąć, żeby migracja na certyfikat przebiegła bez zakłóceń.
Czym jest token KSeF – jak działa i co zawiera?
Token to alfanumeryczny ciąg znaków generowany przez podatnika po zalogowaniu się do KSeF jedną z podstawowych metod uwierzytelnienia. W odróżnieniu od certyfikatu token łączy w sobie dwie funkcje naraz: identyfikuje użytkownika (uwierzytelnienie) i zawiera w sobie przypisane mu uprawnienia (autoryzacja). Oznacza to, że kiedy oprogramowanie ERP przekazuje token do bramki KSeF, system od razu wie, kto się łączy i co mu wolno robić – wystawiać faktury, przeglądać dokumenty, zarządzać uprawnieniami.
W praktyce integracja z tokenem wygląda prosto: wchodzisz do Aplikacji Podatnika KSeF, generujesz token, kopiujesz ciąg znaków i wklejasz go w ustawieniach programu do fakturowania lub systemu ERP. Od tej chwili oprogramowanie łączy się z KSeF automatycznie, bez konieczności każdorazowego logowania przez użytkownika. Token działa niezależnie od tego, na jakim komputerze uruchomiono oprogramowanie, nie wymaga fizycznego nośnika i nie wygasa przy zmianie hasła użytkownika.
Kluczowe ograniczenia tokena są jednak poważne. Po pierwsze, token ma charakter okaziciela: ktokolwiek wejdzie w jego posiadanie, może działać w systemie z pełnymi uprawnieniami przypisanymi w momencie generowania. Nie ma mechanizmu weryfikacji, czy to właściwa osoba – system wpuszcza każdego, kto przedstawi właściwy ciąg znaków. Po drugie, token nie obsługuje trybów szczególnych KSeF: offline24, trybu awaryjnego ani trybu niedostępności systemu. Wystawienie faktury bez połączenia z KSeF wymaga certyfikatu. Po trzecie, tokeny przestają działać z końcem 2026 roku – jest to termin ostateczny, bez możliwości przedłużenia.
Czym jest certyfikat KSeF – jak działa i co go wyróżnia?
Certyfikat KSeF to elektroniczne poświadczenie tożsamości – plik kryptograficzny generowany przez Centrum Certyfikacji Ministerstwa Finansów i wydawany po uwierzytelnieniu podatnika w KSeF. W odróżnieniu od tokena certyfikat pełni wyłącznie funkcję uwierzytelnienia: potwierdza, kim jest osoba lub podmiot łączący się z systemem. Uprawnienia nie są zapisane w certyfikacie – zarządzane są osobno w KSeF i weryfikowane po każdym zalogowaniu na podstawie NIP lub PESEL powiązanego z certyfikatem.
To rozdzielenie uwierzytelnienia od autoryzacji ma istotną konsekwencję: zmiana uprawnień użytkownika nie wymaga generowania nowego certyfikatu. Wystarczy zaktualizować uprawnienia w systemie – certyfikat pozostaje ważny. Przy tokenie zmiana uprawnień oznacza konieczność wygenerowania nowego tokena i zaktualizowania go w każdej aplikacji, która go używa.
Certyfikat oparty jest na kryptografii asymetrycznej: składa się z klucza publicznego (zapisanego w pliku certyfikatu) i klucza prywatnego (przechowywanego wyłącznie przez właściciela). Nawet jeśli ktoś uzyska dostęp do pliku certyfikatu, bez klucza prywatnego nie może się nim posłużyć. To zasadnicza przewaga bezpieczeństwa nad tokenem.
Certyfikat KSeF jest bezpłatny, ważny przez dwa lata od daty wytworzenia, generowany w Aplikacji Podatnika KSeF lub przez API KSeF 2.0. Może być wydany na osobę fizyczną (identyfikowaną NIP-em lub PESEL-em) lub na podmiot (spółkę). Certyfikat zawierający dane osoby fizycznej może być pobrany i używany wyłącznie przez tę osobę.
Dwa typy certyfikatu – typ 1 i typ 2
KSeF wyróżnia dwa rodzaje certyfikatów o różnym przeznaczeniu, generowane osobno.
Certyfikat typu 1 służy do uwierzytelniania w systemie KSeF w sesji online i wsadowej. To odpowiednik tokena w docelowym modelu KSeF 2.0 – plik wgrywany do oprogramowania ERP, który pozwala na automatyczne, bezobsługowe połączenie z API KSeF. Od 1 stycznia 2027 roku certyfikat typu 1 będzie jedyną dopuszczalną metodą uwierzytelnienia przez API.
Certyfikat typu 2 jest wymagany do wystawiania faktur w trybach szczególnych: offline24 (faktura wystawiana bez połączenia z KSeF, dosyłana do systemu następnego dnia roboczego), trybie niedostępności systemu i trybie awaryjnym. W tych scenariuszach faktura jest generowana lokalnie i oznaczana kodem potwierdzającym tożsamość wystawcy – do wygenerowania tego kodu potrzebny jest właśnie certyfikat typu 2. Bez niego firma traci możliwość legalnego wystawiania faktur w sytuacjach braku łączności z KSeF.
Dla firm budowlanych pracujących na placach budowy, gdzie dostęp do internetu bywa ograniczony, certyfikat typu 2 jest elementem planowania ciągłości operacyjnej – nie opcją, lecz koniecznością.
Kluczowe różnice w tabeli praktycznej
Żeby podjąć właściwą decyzję, warto zestawić oba rozwiązania w wymiarach, które mają znaczenie operacyjne. Token łączy uwierzytelnienie i uprawnienia w jednym obiekcie, certyfikat rozdziela te funkcje. Token nie wymaga konfiguracji kryptograficznej, certyfikat oparty jest na kryptografii asymetrycznej. Token nie obsługuje trybów offline, certyfikat typu 2 jest do tego niezbędny. Token przestaje działać 31 grudnia 2026 roku, certyfikat jest ważny przez dwa lata i stanowi docelowy standard. Token jest prostszy we wdrożeniu, certyfikat wymaga procedury wnioskowania i konfiguracji w systemie. Przy zmianie uprawnień token trzeba zastąpić nowym, certyfikat pozostaje ważny po zmianie uprawnień w systemie. W zakresie bezpieczeństwa token ma poziom hasła alfanumerycznego, certyfikat – poziom podpisu kwalifikowanego.
Kiedy warto już teraz przejść na certyfikat?
Dla firm budowlanych i deweloperów z rozbudowanymi systemami ERP odpowiedź jest jednoznaczna: migracja na certyfikat powinna nastąpić jak najwcześniej, bez czekania na koniec roku 2026. Powodów jest kilka.
Ciągłość operacyjna przy awariach i trybie offline to pierwszy argument. Plac budowy bez dostępu do internetu, awaria łącza w biurze rozliczeń, planowana przerwa techniczna w KSeF – każdy z tych scenariuszy wymaga możliwości wystawienia faktury offline. Bez certyfikatu typu 2 firma jest w takiej sytuacji zablokowana. Przy kilkudziesięciu fakturach wystawianych każdego dnia opóźnienie ma realne skutki dla płynności finansowej i terminów płatności podwykonawców.
Bezpieczeństwo danych finansowych to drugi argument. Token, który „wycieknie" z konfiguracji systemu IT – przez atak hakerski, błąd pracownika lub nieuprawniony dostęp do serwera – daje intruzowi pełne uprawnienia w KSeF w zakresie, jaki token zawierał. Certyfikat bez klucza prywatnego jest bezużyteczny dla osoby trzeciej.
Unikanie migracji w pośpiechu to trzeci argument. Firmy, które zostawią przejście na certyfikat na IV kwartał 2026 roku, będą robić to razem z dziesiątkami tysięcy innych podatników. Wsparcie techniczne dostawców oprogramowania będzie przeciążone, testy integracyjne będą realizowane pod presją czasu, a ryzyko błędów konfiguracyjnych – wyższe.
Jak wygenerować certyfikat KSeF krok po kroku?
Proces uzyskania certyfikatu jest kilkuetapowy, ale niezbyt skomplikowany. Uwierzytelnienie w KSeF: należy zalogować się do Aplikacji Podatnika KSeF jedną z podstawowych metod – Profilem Zaufanym, podpisem kwalifikowanym lub pieczęcią kwalifikowaną. Złożenie wniosku: w sekcji zarządzania certyfikatami wybiera się opcję wnioskowania o certyfikat, podaje dane osoby fizycznej lub podmiotu zgodne z tymi, które były użyte do uwierzytelnienia. Pobranie certyfikatu: po przetworzeniu wniosku (zazwyczaj natychmiast lub w ciągu chwil) certyfikat jest gotowy do pobrania jako plik. Konfiguracja w systemie ERP: plik certyfikatu wgrywa się do oprogramowania w sposób określony przez producenta – zwykle w sekcji ustawień połączenia z KSeF.
Środowiska testowe i produkcyjne KSeF są od siebie całkowicie niezależne. Certyfikat wygenerowany w środowisku testowym nie zadziała w produkcyjnym i odwrotnie. Przy konfiguracji integracji trzeba zachować spójność: certyfikat produkcyjny dla środowiska produkcyjnego, testowy dla testów.
Jak program KSeF Develogic obsługuje oba mechanizmy uwierzytelnienia – token i certyfikat – w środowisku wielopodmiotowym, gdzie kilka spółek celowych dewelopera korzysta z jednego systemu? Odpowiedź znajdziesz w opisie programu KSeF Develogic. Konfigurację certyfikatów dla firm budowlanych i deweloperów, w tym obsługę trybów offline i awaryjnych, omawiamy szczegółowo na szkoleniach KSeF dla branży budowlanej. Umów bezpłatne demo i sprawdź, jak system zarządza certyfikatami w środowisku z wieloma użytkownikami i kontraktami.
FAQ – Czym się różni token od certyfikatu w KSeF
Czy token wygenerowany w KSeF 1.0 przed 1 lutego 2026 roku działa w KSeF 2.0?
Nie. Tokeny wygenerowane w starym systemie KSeF 1.0 utraciły ważność po wdrożeniu KSeF 2.0 w lutym 2026 roku. Konieczne było wygenerowanie nowych tokenów bezpośrednio w KSeF 2.0. Firmy, które nie wykonały tej migracji, napotkały błędy autoryzacji przy pierwszych próbach połączenia z nowym systemem. To jeden z najczęstszych problemów zgłaszanych przez działy IT w pierwszych tygodniach po uruchomieniu KSeF 2.0.
Czy jeden certyfikat KSeF może obsługiwać kilka firm (NIP-ów)?
Certyfikat jest powiązany z konkretną osobą fizyczną (NIP lub PESEL) lub konkretnym podmiotem. Nie obsługuje wielu NIP-ów jednocześnie z jednego pliku. Jednak system uwzględnia powiązania między identyfikatorami – osoba fizyczna uwierzytelniona certyfikatem na swój PESEL może działać w kontekście NIP-ów firm, do których ma nadane uprawnienia. W środowiskach wielospółkowych każda spółka potrzebuje własnego certyfikatu podmiotowego lub osoba mająca uprawnienia w wielu spółkach loguje się certyfikatem osobistym i przełącza konteksty.
Czy token i certyfikat można używać jednocześnie do tego samego systemu?
Tak – do końca 2026 roku obie metody działają równolegle i nie wykluczają się wzajemnie. Firma może mieć skonfigurowany certyfikat jako główną metodę integracji z KSeF i zachować token jako rozwiązanie zapasowe. Warto jednak zadbać o to, by do końca roku IV kwartału 2026 certyfikat był w pełni skonfigurowany i przetestowany, tak żeby przejście po 31 grudnia nie wymagało żadnych nagłych działań.
Co się stanie, jeśli firma nie przejdzie na certyfikat do 1 stycznia 2027 roku?
Od 1 stycznia 2027 roku tokeny przestają być obsługiwane przez system KSeF. Oprogramowanie skonfigurowane wyłącznie z tokenem nie będzie mogło się połączyć z API KSeF i nie wyśle żadnej faktury. W praktyce oznacza to blokadę całego procesu fakturowania do momentu wdrożenia certyfikatu. Przy dużej skali operacji – generalny wykonawca wystawiający kilkaset faktur miesięcznie – każdy dzień przestoju ma wymierny koszt finansowy i organizacyjny.