Jak uzyskać tokeny KSeF

Wygeneruj token uwierzytelniający w portalu KSeF i podłącz go do eKsięgowy AI.

Aby wysyłać i odbierać faktury przez KSeF, eKsięgowy AI potrzebuje tokenu uwierzytelniającego wydanego przez portal KSeF. Ten przewodnik przeprowadzi Cię przez proces jego wygenerowania i wklejenia do aplikacji. Będziesz potrzebować Kwalifikowanego Podpisu Elektronicznego (KEP) lub Profilu Zaufanego.

Najpierw użyj środowiska testowego

Wygeneruj token w środowisku testowym KSeF, sprawdź, czy działa w eKsięgowy AI, a następnie powtórz proces dla produkcji.

Otwórz portal KSeF

Otwórz portal KSeF w nowej karcie. Najpierw użyj środowiska testowego, aby zweryfikować konfigurację; następnie przejdź na produkcję, gdy nabierzesz pewności.

Strona logowania Aplikacji Podatnika KSeF. Wybierz Login.gov.pl (mObywatel, bankowość, Profil Zaufany) lub Certyfikat kwalifikowany.

Zaloguj się i wybierz podmiot

Po kliknięciu wybranej metody logowania ukończ proces uwierzytelniania (mObywatel, bankowość albo Profil Zaufany przez Login.gov.pl, lub certyfikat kwalifikowany). Po powrocie do KSeF wpisz NIP podmiotu, w imieniu którego będziesz działać.

Wybór identyfikatora podmiotu (NIP) — Wpisz NIP firmy, w imieniu której będziesz wystawiać i odbierać faktury.

Otwórz sekcję Tokeny

Po zalogowaniu przejdź do Uprawnienia → Tokeny w bocznym menu.

Pulpit KSeF z bocznym menu zawierającym Tokeny — Pulpit KSeF. Boczne menu zawiera Faktury, Historia sesji, Uprawnienia, Tokeny i Certyfikaty.

Wypełnij formularz tokenu

W bocznym menu otwórz Tokeny → Generuj token. Nadaj tokenowi rozpoznawalną nazwę (na przykład 'eKsiegowyAI'). Pod nazwą zaznacz uprawnienia, których potrzebuje eKsięgowy AI: 'wystawianie faktur' i 'przeglądanie faktur'. Nie nadawaj uprawnień administracyjnych.

Formularz generowania tokenu z polem nazwy i checkboxami uprawnień — Formularz tokenu: pole nazwy u góry, checkboxy uprawnień poniżej.

Wygeneruj i poczekaj

Kliknij 'Generuj token' u dołu formularza. KSeF zakolejkuje żądanie — ekran statusu pokaże 'W realizacji'. Klikaj 'Odśwież' co jakiś czas, aby zaktualizować status. Generowanie może potrwać kilka minut.

Ekran trwającego generowania tokenu — Ekran statusu 'Generowanie tokena' — kliknij 'Odśwież' aby zaktualizować.

Skopiuj token

Po zakończeniu generowania ekran pokazuje 'Zakończono pomyślnie'. Token pojawia się w polu kopiowania z przyciskiem 'Kopiuj'. KSeF ostrzega: 'Token wyświetlany jest tylko raz' — natychmiast skopiuj go do menedżera haseł.

Wygenerowany token z przyciskiem Kopiuj — Generowanie tokenu zakończone. Kliknij 'Kopiuj' i zapisz token w bezpiecznym miejscu.

Token jest wyświetlany tylko raz

Jeśli go zgubisz, musisz wygenerować nowy. Przechowuj go w menedżerze haseł lub w sejfie sekretów Twojego zespołu.

Wklej token do eKsięgowy AI

Otwórz ustawienia KSeF w naszej aplikacji. Wybierz 'Direct KSeF API' jako tryb integracji oraz odpowiednie środowisko (Production, Demo lub Test — to samo, w którym wygenerowałeś token). Wklej token do pola 'KSeF Authorization Token', wpisz NIP i kliknij 'Save Settings'.

Strona ustawień KSeF w eKsięgowy AI — Strona /ksef/settings — wpisz token i NIP, następnie kliknij Save Settings.