Generowanie tokenu

Token dostępu to specjalny klucz autoryzacyjny, który pozwala CPortal na bezpieczne pobieranie faktur z Krajowego Systemu e-Faktur w Twoim imieniu. Wygenerujesz go raz w systemie KSeF, a następnie wprowadzisz do CPortal podczas konfiguracji.

Ważne: Zrzuty ekranu pochodzą ze środowiska DEMO. Środowisko produkcyjne wygląda identycznie, więc możesz śmiało podążać za tym przewodnikiem niezależnie od wersji, której używasz.

Czego będziesz potrzebować?

Profil zaufany lub inną metodę uwierzytelnienia (np. e-dowód, mObywatel)
NIP firmy - numer identyfikacji podatkowej
Telefon - do potwierdzenia kodem SMS (przy logowaniu profilem zaufanym)
Około 10 minut - na cały proces

Jak wygenerować token?

Krok 1: Zaloguj się do systemu KSeF

Otwórz stronę aplikacji KSeF i kliknij przycisk "Uwierzytelnij się w Krajowym Systemie e-Faktur".

Środowisko produkcyjne: https://ap.ksef.mf.gov.pl/web/
Środowisko demo (do testów): https://ap-demo.ksef.mf.gov.pl/web/

Krok 2: Wybierz metodę logowania

Wybierz sposób, w jaki chcesz się uwierzytelnić. W tym przewodniku używamy opcji "Zaloguj profilem zaufanym", ale możesz wybrać inną metodę, jeśli wolisz.

Krok 3: Wprowadź NIP firmy

Wpisz NIP firmy jako kontekst logowania. To ten sam NIP, którego później użyjesz w konfiguracji CPortal.

Kliknij "Uwierzytelnij", aby przejść dalej.

Krok 4: Podpisz dokument autoryzacyjny

System wyświetli dokument do podpisu. Kliknij przycisk "Podpisz", aby kontynuować proces logowania.

Krok 5: Wybierz metodę podpisu

Wybierz sposób podpisania dokumentu. Jeśli logujesz się profilem zaufanym, wybierz "Profil zaufany".

Krok 6: Zaloguj się na profil zaufany

Wprowadź nazwę użytkownika i hasło do swojego profilu zaufanego.

Krok 7: Potwierdź kodem SMS

Wpisz kod weryfikacyjny, który otrzymałeś SMS-em.

Krok 8: Jesteś zalogowany

Po pomyślnym uwierzytelnieniu zobaczysz główną stronę Aplikacji Podatnika KSeF.

Krok 9: Wygeneruj nowy token

Z menu po lewej stronie rozwiń pozycję "Tokeny"
Kliknij "Generuj token"
W formularzu wypełnij:
Nazwa tokena: Wpisz opisową nazwę, np. "System CPortal" lub "Integracja CPortal"
Uprawnienia: Zaznacz uprawnienie do odczytu faktur
Kliknij "Generuj token"

Krok 10: Poczekaj na wygenerowanie

System potrzebuje chwili na wygenerowanie tokena. Zobaczysz komunikat o trwającym procesie.

Odczekaj kilka sekund i kliknij przycisk "Odśwież".

Krok 11: Zapisz token w bezpiecznym miejscu

System wyświetli wygenerowany token - długi ciąg znaków.

BARDZO WAŻNE:

Skopiuj cały token (może mieć nawet kilkaset znaków)
Zapisz go w bezpiecznym miejscu (np. w menedżerze haseł)
Po zamknięciu tej strony NIE będziesz mógł ponownie zobaczyć tego tokena
Jeśli go zgubisz, będziesz musiał wygenerować nowy

Co dalej?

Teraz masz token dostępu do KSeF! Następny krok to:

Przejdź do artykułu Konfiguracja KSeF
Wprowadź token do ustawień CPortal
Włącz automatyczną synchronizację

Jeśli coś poszło nie tak

Nie widzę przycisku "Generuj token" - Upewnij się, że jesteś zalogowany na koncie z odpowiednimi uprawnieniami - Sprawdź, czy wybrałeś właściwy kontekst (NIP firmy)

Zgubiłem token - Niestety, nie można go ponownie wyświetlić - Musisz wygenerować nowy token (powtórz kroki 9-11) - Możesz usunąć stary token z listy tokenów w systemie KSeF

Token nie działa w CPortal - Upewnij się, że skopiowałeś cały token (bez spacji na początku/końcu) - Sprawdź, czy token ma uprawnienie do odczytu faktur - Zweryfikuj, czy NIP w CPortal jest taki sam jak podczas generowania tokenu