Przejdź do głównej zawartości

Integracja z KSeF (token)

Napisane przez Julia Pieprzyk
Zaktualizowano ponad miesiąc temu

Wymagania wstępne

  • dostęp do KSeF (konto podatnika lub osoby uprawnionej),

  • możliwość zalogowania się Profilem Zaufanym,

  • uprawnienia do nadawania tokenów w KSeF,

  • dostęp administracyjny do eGabinet (moduł Finanse).


Krok 1. Zaloguj się do KSeF

  1. Wejdź na stronę KSeF.

  2. Kliknij Zaloguj się do KSeF.

  3. Wybierz Uwierzytelnij się w Krajowym Systemie e-Faktur.

    Jako metodę logowania wybierz Profil zaufany.


Krok 2. Wprowadź kontekst logowania

  1. Jako identyfikator wybierz NIP firmy.

  2. Wpisz NIP podmiotu, dla którego będą wystawiane faktury.

  3. Kliknij Uwierzytelnij.

  4. Zatwierdź operację podpisem Profilem Zaufanym.


Krok 3. Przejdź do generowania i konfiguracji tokena

  1. Poczekaj na zakończenie generowania (status „W realizacji”).

  2. Kliknij Odśwież, aby wyświetlić token.

  3. Skopiuj token i zapisz go w bezpiecznym miejscu.

⚠️ Uwaga:

Token jest wyświetlany tylko jeden raz.

Po opuszczeniu strony nie będzie możliwości ponownego jego odczytu.

  1. W menu bocznym KSeF wybierz Tokeny -> Generuj token.

  2. Uzupełnij :

  • Nazwę tokena

  • Uprawnienia: wystawianie faktur - bez nich integracja nie zadziała

3. W polu "Nazwa tokena" wpisz np. eGabinet.

4. W sekcji uprawnień zaznacz:

wystawianie faktur

Kliknij Generuj token.

🔒 Zakres uprawnień tokena decyduje o tym, jakie operacje eGabinet będzie mógł wykonywać w KSeF. Bez zaznaczenia opcji wystawianie faktur integracja nie zadziała!


Krok 4. Skopiuj wygenerowany token


Krok 6. Wklej token w eGabinet

  1. Zaloguj się do eGabinet.

  2. Przejdź do: Moduły → Finanse → KSeF.

  3. Wklej skopiowany token w pole "Token KSeF".

4. Kliknij Połącz z KSeF.


Krok 7. Sprawdź status połączenia

Po poprawnym połączeniu system wyświetli komunikat:

  • Status: Połączono poprawnie

  • Data połączenia: aktualna data

Od tego momentu:

  • faktury wystawiane w eGabinet są automatycznie wysyłane do KSeF,

  • status wysyłki jest widoczny na liście faktur.

Gotowe! 😃


Najczęstsze problemy i wskazówki

❓ Token nie działa

  • upewnij się, że token został wklejony w całości,

  • sprawdź, czy ma nadane uprawnienie wystawianie faktur.

  • sprawdź czy w danych billingowych placówki wprowadzony jest poprawny NIP

❓ Nie widzę opcji Tokeny w KSeF

  • konto nie ma odpowiednich uprawnień (wymagane role administracyjne).

❓ Chcę zmienić token

  • wygeneruj nowy token w KSeF,

  • wklej go ponownie w eGabinet (stary token przestanie być używany).


Informacja o certyfikatach

🔔 Autoryzacja certyfikatem kwalifikowanym oraz pieczęcią elektroniczną będzie dostępna od 01.04.2026 r.

Do tego czasu jedyną obsługiwaną metodą integracji eGabinet z KSeF jest token dostępu.

Czy to odpowiedziało na twoje pytanie?