Token KSeF – jak uzyskać i skonfigurować krok po kroku

Bez ważnego tokena żadna aplikacja nie wyśle faktury do KSeF. Token autoryzacyjny to klucz dostępu, który identyfikuje Twoją firmę w systemie Ministerstwa Finansów i upoważnia do wystawiania oraz odbierania faktur. W tym artykule przeprowadzimy Cię przez cały proces — od wygenerowania tokena po jego konfigurację w KSEBridge.

Co to jest token KSeF?

Token KSeF (token autoryzacyjny) to ciąg znaków generowany przez system KSeF Ministerstwa Finansów, który potwierdza tożsamość podatnika i nadaje uprawnienia do korzystania z API KSeF. Token jest przypisany do konkretnego NIP-u firmy i środowiska (TEST lub PRODUKCJA). Jest to alternatywa dla uwierzytelniania certyfikatem kwalifikowanym lub podpisem zaufanym — prostszy w codziennym użyciu przy automatycznych integracjach.

Dwa środowiska – dwa osobne tokeny

KSeF posiada dwa niezależne środowiska, z których każde wymaga osobnego tokena:

• Token TEST — do środowiska testowego KSeF (api-test.ksef.mf.gov.pl). Służy do sprawdzania integracji bez ryzyka wysyłki prawdziwych faktur. Faktury testowe nie trafiają do oficjalnego rejestru.
• Token PROD — do środowiska produkcyjnego KSeF (api.ksef.mf.gov.pl). Używany w codziennej pracy firmy. Wystawiane faktury są prawdziwymi dokumentami podatkowymi.

Tokeny TEST i PROD są całkowicie niezależne — token z jednego środowiska nie zadziała w drugim.

Jak uzyskać token KSeF TEST krok po kroku

1. Wejdź na stronę testowego KSeF pod adresem ksef.mf.gov.pl i przełącz się na środowisko testowe.
2. Zaloguj się przy użyciu podpisu zaufanego (Profil Zaufany) lub certyfikatu kwalifikowanego — w środowisku testowym można użyć też dedykowanego mechanizmu testowego.
3. Przejdź do sekcji Ustawienia → Tokeny i kliknij Generuj nowy token.
4. Nadaj tokenowi nazwę (np. "KSEBridge TEST") i przypisz mu uprawnienia: co najmniej wystawianie faktur i odczyt faktur.
5. Skopiuj wygenerowany token — będzie widoczny tylko raz. Zapisz go w bezpiecznym miejscu.

Jak uzyskać token KSeF PRODUKCJA

Procedura dla środowiska produkcyjnego jest analogiczna, ale wymaga silniejszego uwierzytelnienia:

1. Zaloguj się do KSeF przy użyciu podpisu kwalifikowanego lub Profilu Zaufanego z potwierdzeniem tożsamości.
2. Upewnij się, że logujesz się jako właściciel firmy lub osoba z uprawnieniami do zarządzania tokenami (np. pełnomocnik KSeF).
3. Wejdź w Ustawienia → Tokeny → Generuj token.
4. Ustaw odpowiednie uprawnienia (wystawianie + odczyt faktur) i określ ewentualny termin ważności.
5. Skopiuj i zabezpiecz token — po opuszczeniu strony nie będzie już dostępny w pełnej formie.

Ważne: Token produkcyjny to wrażliwy ciąg znaków. Traktuj go jak hasło — nie przechowuj w niezabezpieczonych plikach tekstowych ani nie wysyłaj e-mailem.

Jak skonfigurować token w KSEBridge

Po uzyskaniu tokena skonfiguruj go w aplikacji:

1. Otwórz KSEBridge i wejdź w Ustawienia (menu górne lub skrót w pasku nagłówka).
2. W polu Token KSeF TEST wklej token testowy (jeśli testujesz integrację).
3. W polu Token KSeF PROD wklej token produkcyjny (gdy jesteś gotowy na wysyłkę prawdziwych faktur).
4. Wybierz Środowisko KSeF: TEST lub PRODUKCJA.
5. Kliknij Zapisz ustawienia — aplikacja automatycznie się zrestartuje i połączy z wybranym środowiskiem.

Po zapisaniu, wskaźnik KSeF w pasku nagłówka powinien zaświecić się na zielono — to potwierdzenie aktywnego połączenia. Obok wskaźnika NIP pojawi się numer firmy odczytany z tokena.

Wskaźniki tokena w aplikacji

KSEBridge sygnalizuje stan tokenów kolorowymi kropkami obok każdego pola w oknie ustawień:

• Zielona — token jest wpisany.
• Czerwona — pole jest puste, token wymagany do uzupełnienia.

Dodatkowe informacje o stanie połączenia z KSeF znajdziesz w pasku nagłówka głównego okna aplikacji (wskaźnik KSeF).

Kiedy token wygasa i co wtedy?

Tokeny KSeF mogą mieć określony termin ważności (ustawiany podczas generowania). Po wygaśnięciu wskaźnik licencji lub KSeF zmieni się na czerwony, a wysyłka faktur zostanie zablokowana. W takim przypadku:

1. Wygeneruj nowy token w panelu KSeF.
2. Wklej nowy token w Ustawieniach KSEBridge.
3. Zapisz i zrestartuj aplikację.

Problemy z tokenem – co sprawdzić?

Jeśli wskaźnik KSeF świeci na czerwono lub pomarańczowo:

• Sprawdź, czy token w ustawieniach jest kompletny (brak spacji na początku/końcu).
• Upewnij się, że środowisko (TEST/PROD) zgadza się z typem tokena — token TEST nie zadziała w środowisku PROD.
• Sprawdź dostęp do internetu i możliwość połączenia z api.ksef.mf.gov.pl lub api-test.ksef.mf.gov.pl.
• Sprawdź, czy token nie wygasł lub nie został unieważniony w panelu KSeF.
• Jeśli problem się utrzymuje: Ustawienia → Eksport paczki diagnostycznej i wyślij ZIP do wsparcia KSEBridge.

FAQ

Czy jeden token mogę używać w kilku aplikacjach?
Technicznie tak — token nie jest przypisany do konkretnego urządzenia. Jednak zaleca się generowanie osobnych tokenów dla każdej aplikacji, by móc je niezależnie unieważniać.

Czy token KSeF to to samo co certyfikat kwalifikowany?
Nie. Certyfikat kwalifikowany to alternatywna metoda uwierzytelnienia przy logowaniu do KSeF. Token to klucz API generowany po zalogowaniu — używany przez aplikacje do automatycznej komunikacji z KSeF bez konieczności każdorazowego logowania.

Gdzie token jest przechowywany w KSEBridge?
W zaszyfrowanym pliku konfiguracyjnym %AppData%\KsefIntegrator\config\config.json na lokalnym dysku.

Czy token TEST działa na prawdziwych fakturach?
Nie — środowisko testowe jest całkowicie odizolowane od produkcji. Faktury wysłane tokenem TEST nie trafiają do rejestru KSeF Ministerstwa Finansów.

Integracja z KSeF krok po kroku KSeF API – jak działa i jak się zintegrować Jak wysłać fakturę do KSeF (PDF i XML) – poradnik 2026