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.
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 — prostszy w codziennym użyciu przy automatycznych integracjach.
Dwa środowiska – dwa osobne tokeny
- Token TEST — do środowiska testowego KSeF (
api-test.ksef.mf.gov.pl). Służy do sprawdzania integracji bez ryzyka wysyłki prawdziwych faktur. - Token PROD — do środowiska produkcyjnego KSeF (
api.ksef.mf.gov.pl). Używany w codziennej pracy firmy.
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
- Wejdź na stronę testowego KSeF i zaloguj się przy użyciu podpisu zaufanego lub certyfikatu kwalifikowanego.
- Przejdź do sekcji Ustawienia → Tokeny i kliknij Generuj nowy token.
- Nadaj tokenowi nazwę (np. "KSEBridge TEST") i przypisz uprawnienia: wystawianie faktur i odczyt faktur.
- Skopiuj wygenerowany token — będzie widoczny tylko raz. Zapisz go w bezpiecznym miejscu.
Jak uzyskać token KSeF PRODUKCJA
- Zaloguj się do KSeF przy użyciu podpisu kwalifikowanego lub Profilu Zaufanego.
- Upewnij się, że logujesz się jako właściciel firmy lub osoba z uprawnieniami do zarządzania tokenami.
- Wejdź w Ustawienia → Tokeny → Generuj token, ustaw uprawnienia i opcjonalny termin ważności.
- Skopiuj i zabezpiecz token — traktuj go jak hasło.
Jak skonfigurować token w KSEBridge
- Otwórz KSEBridge i wejdź w Ustawienia.
- W polu Token KSeF TEST wklej token testowy.
- W polu Token KSeF PROD wklej token produkcyjny.
- Wybierz Środowisko KSeF: TEST lub PRODUKCJA.
- Kliknij Zapisz ustawienia — aplikacja automatycznie się zrestartuje.
Po zapisaniu wskaźnik KSeF w pasku nagłówka powinien zaświecić się na zielono. Obok wskaźnika NIP pojawi się numer firmy odczytany z tokena.
Wskaźniki tokena w aplikacji
- Zielona kropka — token jest wpisany i aktywny.
- Czerwona kropka — pole jest puste, token wymagany do uzupełnienia.
Kiedy token wygasa i co wtedy?
Po wygaśnięciu wskaźnik KSeF zmieni się na czerwony, a wysyłka faktur zostanie zablokowana. Wygeneruj nowy token w panelu KSeF, wklej go w Ustawieniach KSEBridge i zapisz.
Problemy z tokenem – co sprawdzić?
- Czy token w ustawieniach jest kompletny (brak spacji na początku/końcu).
- Czy środowisko (TEST/PROD) zgadza się z typem tokena — token TEST nie zadziała w środowisku PROD.
- Czy jest dostęp do internetu i możliwość połączenia z
api.ksef.mf.gov.pl. - Czy token nie wygasł lub nie został unieważniony w panelu KSeF.
- Jeśli problem się utrzymuje: Ustawienia → Eksport paczki diagnostycznej i wyślij do wsparcia.
FAQ
Czy jeden token mogę używać w kilku aplikacjach?
Technicznie tak, ale 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 jest metodą logowania do KSeF. Token to klucz API generowany po zalogowaniu — używany przez aplikacje do automatycznej komunikacji.
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.