Wprowadzenie
Token KSeF to poświadczenie uwierzytelniające z okresem ważności — gdy wygaśnie, integracja przestaje otwierać sesje i wysyłać faktury. Rutyna, która trzyma Cię w ruchu, jest prosta: sprawdź datę ważności, wygeneruj nowy token zanim stary umrze i podmień go w jednym miejscu — w Connect KSeF w Notaly.
Czym jest token (a czym nie jest)
KSeF (Krajowy System e-Faktur) to krajowa platforma e-fakturowania. Zanim wyślesz fakturę FA(3), Twój system musi się uwierzytelnić i otworzyć sesję online. Token robi właśnie to: jest szyfrowany razem ze znacznikiem czasu wyzwania kluczem publicznym Ministerstwa Finansów i to otwiera sesję. To poświadczenie uwierzytelniające, a nie klucz podpisujący — sam XML faktury jest szyfrowany i wysyłany, nigdy nie jest podpisywany tokenem. Alternatywą uwierzytelniania jest XAdES z podpisem kwalifikowanym lub pieczęcią.
Dlaczego ważność ma znaczenie
Token jest wydawany z okresem ważności ustalonym w momencie utworzenia. Nie ma samoodnawiania: gdy przepadnie, uwierzytelnianie zawodzi i wysyłka staje. Awaria potrafi być cicha aż do momentu, gdy faktycznie spróbujesz wysłać fakturę — a to najgorszy moment na odkrycie problemu. Traktuj datę ważności jak wpis w kalendarzu, a nie coś, co zauważysz dopiero na produkcji.
Rutyna rotacji, która działa
- Znajdź datę ważności. Portal KSeF pokazuje ją przy generowaniu tokenu; zapisz ją tam, gdzie Twój zespół faktycznie zagląda.
- Wygeneruj nowy token wcześniej. Nie czekaj na ostatni dzień. Przygotuj następcę, póki stary token wciąż działa.
- Podmień go w jednym miejscu. W Notaly wklejasz nowy token w Connect KSeF, w ustawieniach. Zmiana obejmuje każdą kolejną wysyłkę.
- Zrób jeden test. Po rotacji wyślij pojedynczą fakturę testową i potwierdź, że przechodzi w stan wysłana, a potem zaakceptowana — żebyś wiedział, że nowy token faktycznie otwiera sesję.
- Unieważnij stary. Jeśli portal pozwala unieważnić stary token, zrób to po potwierdzeniu nowego, żeby nie zostawić nieaktualnego poświadczenia.
Gdzie pomaga Notaly
Notaly przechowuje podany przez Ciebie token i używa go do uwierzytelniania każdej wysyłki, więc nie musisz sam łączyć znaczników czasu wyzwania i odnawiania sesji we własnym kodzie. Cykl życia tokenu — generowanie i podmiana — wciąż należy do Ciebie, ale mechanika jego użycia jest obsłużona. Gdy wysyłka zawiedzie z powodu problemu z uwierzytelnianiem, wynik jest pokazywany, żebyś mógł zareagować, zamiast zniknąć bez śladu.
FAQ
Czy token KSeF to klucz podpisujący? Nie. To poświadczenie uwierzytelniające. Otwiera sesję; XML faktury jest szyfrowany i wysyłany, a nie podpisywany tokenem.
Co się dzieje, gdy token wygaśnie? Uwierzytelnianie zawodzi, więc nie można otworzyć nowych sesji, a wysyłka faktur staje, dopóki nie podasz ważnego tokenu.
Zastrzeżenie
Notaly nie jest doradcą podatkowym, księgowym ani prawnym. Ten artykuł ma charakter informacyjny, nie stanowi porady podatkowej i może być nieaktualny. Ponosisz odpowiedzialność za własne rozliczenia VAT; w razie potrzeby skonsultuj się z wykwalifikowanym księgowym.
Źródła
Źródło: www.podatki.gov.pl