Token KSeF: ważność i co się dzieje, gdy wygaśnie

Aktualizacja:

Ważność tokena KSeF zależy od ustawień wybranych przy jego tworzeniu. Najnowsze tokeny mogą mieć ograniczony okres ważności. Gdy token wygaśnie, logowanie nim kończy się błędem, a każde narzędzie, które z niego korzysta, przestaje pobierać faktury. Rozwiązanie jest proste: tworzysz nowy token, podmieniasz go w narzędziu, a stary unieważniasz.

Poniżej opisujemy, jak pilnować dat, kiedy wymienić token i jak bezpiecznie go unieważnić.

Czym jest token i dlaczego ma datę ważności

Token to ciąg znaków powiązany z konkretnymi uprawnieniami w KSeF. Służy do logowania programów i integracji, które nie korzystają z profilu zaufanego ani certyfikatu. Różnice między tymi metodami opisujemy w tekście certyfikat KSeF czy token.

Ograniczony okres ważności zmniejsza ryzyko. Token, o którym wszyscy zapomnieli, nie daje dostępu do Twoich faktur latami. Ceną za to jest konieczność pilnowania daty i regularnej wymiany.

Ważne są trzy cechy tokena:

  • jest pokazywany tylko raz, przy utworzeniu,
  • może wymagać zatwierdzenia, zanim zacznie działać,
  • można go unieważnić w dowolnym momencie.

Ile ważny jest Twój token

Nie ma jednej liczby dni, która dotyczy każdego tokena. Okres ważności wybierasz przy tworzeniu tokena, a dostępne opcje zależą od aktualnych ustawień systemu. Starsze tokeny mogą działać na innych zasadach niż najnowsze.

Datę ważności sprawdzisz w Aplikacji Podatnika KSeF, w części dotyczącej tokenów. Wygląd panelu może się zmieniać, więc szukaj listy tokenów z ich statusem i datami. Jeśli masz wątpliwości co do zasad, sprawdź komunikaty Ministerstwa Finansów.

Co się dzieje, gdy token wygaśnie

Po upływie okresu ważności KSeF odrzuca logowanie tym tokenem. Integracja zwykle dostaje komunikat o tokenie poza okresem ważności. W praktyce wygląda to tak:

  • program albo aplikacja przestaje pokazywać nowe faktury kosztowe,
  • nie przychodzą alerty o nowych fakturach,
  • miesięczna paczka dla księgowej może wyjść niepełna albo wcale.

Faktury od dostawców dalej trafiają do KSeF. Problem polega na tym, że nikt ich stamtąd nie pobiera. Najgorszy scenariusz to kilka tygodni ciszy, przegapiony termin płatności i braki w dokumentach u księgowej.

Jak notować daty ważności tokenów

Jeśli masz jeden token, wystarczy przypomnienie w kalendarzu. Przy kilku narzędziach albo kilku firmach przyda się prosta tabela. Nie wpisuj do niej samego tokena, tylko jego opis.

Do czego służyUprawnieniaUtworzonyWażny doGdzie wpisany
Pobieranie faktur kosztowychprzeglądanie fakturdatadatanazwa narzędzia
Program do wystawiania fakturwystawianie fakturdatadatanazwa programu

Kilka praktycznych zasad:

  1. Nazwij token tak, żeby było jasne, do czego służy (o ile panel na to pozwala).
  2. Ustaw przypomnienie z wyprzedzeniem, na przykład dwa tygodnie przed datą ważności.
  3. Daj znać księgowej, jeśli jej biuro korzysta z tokena wygenerowanego przez Ciebie.

Kiedy wymienić token

Nie czekaj do ostatniego dnia. Nowy token może wymagać zatwierdzenia, a wymiana w kilku miejscach zajmuje czas. Bezpieczna kolejność wygląda tak:

  1. Utwórz nowy token z tymi samymi, minimalnymi uprawnieniami. Instrukcję znajdziesz w tekście jak wygenerować token KSeF.
  2. Skopiuj go od razu, bo później nie zobaczysz go ponownie.
  3. Wpisz nowy token w narzędziu w miejsce starego.
  4. Sprawdź, czy narzędzie poprawnie pobiera faktury.
  5. Unieważnij stary token i zaktualizuj datę w swojej tabeli.

Dzięki temu nie powstaje okres, w którym nic nie działa.

Co zrobić, gdy token już wygasł

Jeśli zauważysz, że faktury przestały spływać, a narzędzie zgłasza błąd logowania, postępuj tak:

  1. Sprawdź w Aplikacji Podatnika KSeF status tokena i jego datę ważności.
  2. Utwórz nowy token z tymi samymi uprawnieniami.
  3. Podmień go w narzędziu i poczekaj na pierwsze pobranie.
  4. Przejrzyj faktury kosztowe z okresu przerwy, zwłaszcza terminy płatności.
  5. Jeśli paczka dla księgowej poszła niepełna, uzupełnij ją albo uprzedź biuro.

Dobre narzędzie po podmianie tokena pobierze również faktury z okresu przerwy, bo nadal są w KSeF. Mimo to warto zerknąć na listę ręcznie.

Unieważnianie tokena

Wygaśnięcie następuje samo, unieważnienie robisz Ty. Po unieważnieniu narzędzie, które korzystało z tokena, traci dostęp. Unieważnij token, gdy:

  • rezygnujesz z aplikacji lub programu,
  • zmieniasz biuro rachunkowe,
  • token mógł trafić w niepowołane ręce, na przykład w mailu lub notatce,
  • utworzyłeś nowy token i stary nie jest już potrzebny.

Przy okazji sprawdź, jakie uprawnienia ma każdy token. Do samego odbioru faktur wystarczy przeglądanie faktur. Więcej o tym w tekście o uprawnieniu do przeglądania faktur.

Token w ksefapp

ksefapp korzysta z tokena tylko z uprawnieniem do przeglądania faktur. Nie wystawia faktur i niczego nie zmienia w KSeF, tylko czyta. Token jest przechowywany w postaci zaszyfrowanej. Możesz go unieważnić w KSeF w każdej chwili.

Gdy token straci ważność, ksefapp, jak każde inne narzędzie, nie pobierze nowych faktur, dopóki nie wpiszesz nowego tokena. Dlatego przypomnienie w kalendarzu warto ustawić niezależnie od tego, z jakiego narzędzia korzystasz.

Start ksefapp planujemy na grudzień 2026, a cennik znajdziesz na stronie głównej. Jeśli chcesz dostać informację o uruchomieniu, zapisz się na listę ksefapp. Pozostałe tematy związane z odbiorem faktur zebraliśmy w Poradniku KSeF.

Najczęściej zadawane pytania

Jak długo jest ważny token KSeF?

To zależy od ustawień wybranych przy tworzeniu tokena i od aktualnych zasad systemu. Najnowsze tokeny mogą mieć ograniczony okres ważności. Datę sprawdzisz w Aplikacji Podatnika KSeF, na liście tokenów.

Czy mogę przedłużyć ważność istniejącego tokena?

Najbezpieczniej przyjąć, że nie. Tworzysz nowy token, podmieniasz go w narzędziu i unieważniasz stary. Aktualne możliwości panelu sprawdź w Aplikacji Podatnika KSeF lub w komunikatach Ministerstwa Finansów.

Czy po wygaśnięciu tokena stracę faktury?

Nie, faktury od dostawców nadal są w KSeF. Przestaje działać tylko ich pobieranie przez narzędzie korzystające z tego tokena. Po podmianie tokena sprawdź faktury z okresu przerwy.

Zgubiłem token, a on jeszcze działa. Co zrobić?

Tokena nie da się wyświetlić ponownie, bo jest pokazywany tylko raz. Utwórz nowy, wpisz go w narzędziu i unieważnij stary. Tak samo postąp, jeśli token mógł trafić do osób trzecich.

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.