Początkujący10 minAutoryzacja

Jak wygenerować nowy token autoryzacyjny KSeF

Przewodnik krok po kroku pokazujący jak wygenerować nowy token autoryzacyjny w panelu KSeF.

15 420 wyświetleń8234 ukończonych7891 pomocne

Przed rozpoczęciem

Posiadanie aktywnego konta na platformie KSeF
Zainstalowany certyfikat kwalifikowany lub profil zaufany

Potrzebne narzędzia

Przeglądarka internetowaCertyfikat kwalifikowany lub profil zaufany

Kroki (6)

Zaloguj się do panelu KSeF

Otwórz stronę https://ksef.mf.gov.pl i zaloguj się używając certyfikatu kwalifikowanego lub profilu zaufanego. Upewnij się, że logujesz się na właściwe środowisko (testowe lub produkcyjne).

Oczekiwany rezultatPo zalogowaniu powinieneś zobaczyć panel główny KSeF z menu po lewej stronie.

Jeśli coś poszło nie takJeśli nie możesz się zalogować, sprawdź czy Twój certyfikat nie wygasł oraz czy masz zainstalowane odpowiednie oprogramowanie do podpisu.

Przejdź do sekcji 'Tokeny autoryzacyjne'

W menu głównym znajdź i kliknij opcję 'Tokeny autoryzacyjne' lub 'Zarządzanie tokenami'. Lokalizacja może się różnić w zależności od wersji interfejsu.

Oczekiwany rezultatZobaczysz listę istniejących tokenów (jeśli są) oraz przycisk do tworzenia nowego tokena.

Kliknij 'Generuj nowy token'

Na stronie zarządzania tokenami kliknij przycisk 'Generuj nowy token' lub 'Utwórz token'. Zostaniesz poproszony o podanie nazwy tokena i opcjonalnie daty ważności.

Nazwa tokena: np. 'Token produkcyjny ERP 2026'
Data ważności: opcjonalnie, np. '2026-12-31'

Oczekiwany rezultatFormularz tworzenia tokena powinien się otworzyć.

Skonfiguruj uprawnienia tokena

Wybierz uprawnienia dla tokena: - Odczyt faktur - pozwala pobierać faktury - Zapis faktur - pozwala wysyłać nowe faktury - Zarządzanie - pełne uprawnienia Dla integracji z systemem ERP zazwyczaj potrzebujesz uprawnień do odczytu i zapisu.

Oczekiwany rezultatUprawnienia zostały wybrane zgodnie z potrzebami.

Jeśli coś poszło nie takJeśli niektóre opcje są nieaktywne, sprawdź czy Twoje konto ma odpowiednie uprawnienia w organizacji.

Potwierdź generowanie tokena

Kliknij przycisk 'Generuj' lub 'Zatwierdź'. System poprosi o potwierdzenie operacji certyfikatem kwalifikowanym lub profilem zaufanym.

Oczekiwany rezultatToken zostanie wygenerowany i wyświetlony na ekranie.

Jeśli coś poszło nie takJeśli podpis nie działa, upewnij się że oprogramowanie do podpisu jest uruchomione i certyfikat jest aktywny.

Zapisz token w bezpiecznym miejscu

WAŻNE: Token jest wyświetlany tylko raz! Skopiuj go i zapisz w bezpiecznym miejscu (np. menedżer haseł, sejf). Nigdy nie przechowuj tokena w kodzie źródłowym ani w plikach konfiguracyjnych bez szyfrowania.

# Przykład bezpiecznego przechowywania w zmiennej środowiskowej:
export KSEF_TOKEN='twoj-token-tutaj'

# Lub w pliku .env (dodaj do .gitignore!):
KSEF_TOKEN=twoj-token-tutaj

Oczekiwany rezultatToken jest bezpiecznie zapisany i gotowy do użycia w integracji.

Jeśli coś poszło nie takJeśli zgubiłeś token, musisz wygenerować nowy. Stary token pozostanie aktywny do czasu jego unieważnienia.

Rozwiązuje błędy

AUTH-001 AUTH-002

Ukończyłeś playbook?

Oznacz jako ukończony i podziel się opinią