Wprowadzenie
Token KSeF to poświadczenie, którym Twój system uwierzytelnia się w API KSeF i otwiera sesję. Generujesz go w portalu KSeF (albo przez API), podajesz integracji — lub Notaly w Connect KSeF — i dzięki temu wysyłasz faktury bez pieczęci kwalifikowanej. Token uwierzytelnia sesję; nie służy do podpisywania faktury.
Do czego służy token
KSeF to krajowa platforma e-fakturowania Ministerstwa Finansów. Zanim wyślesz fakturę w formacie FA(3), Twój system musi się uwierzytelnić i otworzyć sesję. Są na to dwie drogi: podpisanie wyzwania uwierzytelniającego podpisem XAdES (kwalifikowanym podpisem lub pieczęcią albo certyfikatem KSeF) albo uwierzytelnienie tokenem wydanym przez KSeF.
W wariancie z tokenem jest on szyfrowany kluczem publicznym Ministerstwa Finansów razem ze znacznikiem czasu wyzwania. To otwiera sesję, a plik XML faktury jest następnie szyfrowany (AES-256, klucz zaszyfrowany kluczem publicznym MF) i wysyłany. Token to zatem poświadczenie uwierzytelniające, a nie klucz podpisu — sama faktura nie jest podpisywana.
Jak go wygenerować
Token wydaje się w portalu KSeF albo przez API KSeF, zgodnie z bieżącymi instrukcjami Ministerstwa Finansów. Traktuj go jak każde dane uwierzytelniające: trzymaj poza repozytorium, wygeneruj nowy, gdy wycieknie, i pilnuj daty ważności, żeby żądanie nie zawiodło po cichu w najgorszym momencie.
Rola tokenu w Notaly
W Notaly wklejasz token raz w Connect KSeF, w ustawieniach. Od tej chwili Notaly uwierzytelnia każde zgłoszenie za Ciebie, wysyła fakturę do KSeF i zwraca status oraz UPO przez webhook. Nie musisz sam obsługiwać znaczników czasu, odnawiania sesji ani terminu ważności.
Jeśli dopiero oceniasz integrację, nie generuj jeszcze tokenu produkcyjnego — zacznij od środowiska testowego KSeF, gdzie token testowy pozwala wysyłać faktury testowe bez dotykania danych produkcyjnych.
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