Token KSeF – jak uzyskać i używać tokenu autoryzacyjnego KSeF

Tablixa Blog · 2026-05-28

Token KSeF – jak uzyskać i używać tokenu autoryzacyjnego KSeF

Token autoryzacyjny KSeF to klucz API, który pozwala wysyłać i odbierać faktury przez Krajowy System e-Faktur bez logowania się przez przeglądarkę. To niezbędne narzędzie dla biur rachunkowych, programistów i firm wysyłających dużo faktur.

Czym jest token KSeF?

Token KSeF to ciąg znaków (zwykle 64–128 znaków) generowany przez Ministerstwo Finansów dla konkretnego NIP. Działa jak hasło API – zamiast logować się każdorazowo przez stronę ksef.mf.gov.pl, wysyłasz fakturę programowo, przekazując token w nagłówku żądania HTTP.

Tokeny KSeF dzielą się na:

  • Token samofakturowania – firma wystawia faktury we własnym imieniu
  • Token podmiotu uprawnionego – biuro rachunkowe wysyła w imieniu klienta (na podstawie pełnomocnictwa)

Jak uzyskać token KSeF?

Krok 1: Zaloguj się do KSeF

Wejdź na ksef.mf.gov.pl i zaloguj się przez:

  • Profil Zaufany
  • Kwalifikowany podpis elektroniczny (kwalifiKowany certyfikat)
  • e-Dowód z warstwą elektroniczną

Krok 2: Wygeneruj token

  1. Po zalogowaniu przejdź do sekcji „Tokeny" lub „Zarządzanie tokenami"
  2. Kliknij „Wygeneruj token"
  3. Nadaj tokenowi nazwę (np. „Tablixa – biuro xyz")
  4. Wybierz uprawnienia:
  • invoices_read – odczyt faktur
  • invoices_write – wysyłanie faktur
  • credentials_read – odczyt uprawnień
  1. Zatwierdź profilem Zaufanym lub podpisem
  2. Skopiuj wygenerowany token i zapisz go w bezpiecznym miejscu

Ważne: Token jest wyświetlany tylko raz. Jeśli go zgubisz, musisz wygenerować nowy.

Krok 3: Przekaż token do narzędzia (np. Tablixa)

W Tablixa wejdź w ustawienia i wklej token KSeF dla swojego NIP. Od tej chwili możesz wysyłać faktury FA(3) do KSeF jednym kliknięciem, bez ponownego logowania.

Token KSeF dla biur rachunkowych

Biura rachunkowe mogą wysyłać faktury w imieniu klientów po uzyskaniu specjalnego tokenu podmiotowego. Procedura:

  1. Klient generuje token z uprawnieniami invoices_write w swoim panelu KSeF
  2. Klient przekazuje token biuru rachunkowemu
  3. Biuro zapisuje token w Tablixa przy danych klienta
  4. Wysyłka faktur odbywa się automatycznie – bez potrzeby logowania się na konto klienta

Tablixa pozwala zarządzać tokenami wielu klientów jednocześnie, co znacznie przyspiesza pracę biura rachunkowego.

Jak długo ważny jest token KSeF?

Tokeny KSeF nie mają domyślnego czasu wygaśnięcia, chyba że ustawisz datę ważności podczas tworzenia. Możesz unieważnić token w dowolnym momencie w panelu ksef.mf.gov.pl.

Warto co 6-12 miesięcy regenerować tokeny jako dobra praktyka bezpieczeństwa.

Środowisko testowe KSeF

Ministerstwo Finansów udostępnia środowisko demo pod adresem: https://ksef-demo.mf.gov.pl/api/

Możesz tam testować wysyłanie FA(3) XML bez ryzyka rejestrowania prawdziwych faktur. Tablixa obsługuje zarówno środowisko produkcyjne jak i testowe.

Podsumowanie

Token KSeF to konieczny krok przed automatycznym wysyłaniem e-faktur. Dla biur rachunkowych to szczególnie istotne – zamiast logować się na konto każdego klienta, wystarczy jeden token per NIP klienta. Tablixa zarządza tokenami i wysyła faktury FA(3) XML automatycznie po wgraniu PDF.

Zacznij za darmo: tablixa.app – 20 konwersji gratis, bez karty płatniczej.