Czym jest token KSeF
Token KSeF to tajny ciąg znaków, który podatnik generuje w aplikacji Ministerstwa Finansów. Oprogramowanie używa go do logowania do API KSeF w imieniu firmy (identyfikowanej numerem NIP), z uprawnieniami wybranymi przy tworzeniu tokena. Zastępuje podpis kwalifikowany przy każdym logowaniu, dzięki czemu fakturowanie może być zautomatyzowane.
Testujesz Notaly? Nie potrzebujesz tokena. Konta sandbox wysyłają faktury do KSeF TEST z testowymi danymi Notaly (NIP sprzedawcy 2745013933). Własny token jest potrzebny dopiero w planie płatnym.
Zanim zaczniesz
- Wybierz środowisko. Token działa tylko w środowisku, w którym go utworzono: TEST (
ap-test.ksef.mf.gov.pl, dane fikcyjne), DEMO (ap-demo.ksef.mf.gov.pl, prawdziwe dane, bez skutków prawnych) lub PRODUKCJA (ap.ksef.mf.gov.pl). - Przygotuj sposób logowania. Aplikacja przyjmuje Profil Zaufany, kwalifikowany podpis elektroniczny lub pieczęć kwalifikowaną albo e-dowód.
- Miej prawo do nadawania uprawnień. Musisz być właścicielem firmy lub mieć uprawnienie do zarządzania uprawnieniami dla tego NIP.
Generowanie tokena krok po kroku
- Otwórz aplikację KSeFWejdź do aplikacji KSeF Ministerstwa Finansów dla wybranego środowiska (Aplikacja Podatnika KSeF, Moduł Certyfikatów i Uprawnień) i zaloguj się w kontekście NIP firmy.
- Przejdź do tokenówOtwórz sekcję tokenów i wybierz generowanie nowego tokena. Nadaj mu nazwę, którą rozpoznasz później, np.
Notaly API. - Wybierz uprawnieniaZaznacz co najmniej wystawianie faktur (
InvoiceWrite). Dodaj przeglądanie faktur (InvoiceRead), jeśli chcesz też odczytywać faktury z KSeF. Nie nadawaj zarządzania uprawnieniami, jeśli nie jest potrzebne. - Wygeneruj i od razu skopiujKSeF pokazuje token tylko raz. Skopiuj go od razu do menedżera haseł lub do Notaly. Jeśli go zgubisz, unieważnij go i wygeneruj nowy.
Traktuj token jak hasło. Każdy, kto go ma, może wystawiać faktury w imieniu Twojej firmy. Nigdy nie wysyłaj go e-mailem, w zgłoszeniu, na czacie ani nie umieszczaj w kodzie.
Podłączenie tokena do Notaly
- Otwórz panelZaloguj się na /login i otwórz Ustawienia → Połączenie KSeF.
- Podaj NIP, token i środowiskoUżyj tego samego NIP, w którego kontekście się logowałeś, oraz środowiska, w którym wygenerowano token.
- PołączNotaly od razu loguje się do KSeF Twoim tokenem (challenge i szyfrowanie RSA-OAEP). Po sukcesie połączenie ma status active, a faktury są wystawiane z Twoim NIP jako sprzedawcą.
Podłączenie własnego tokena jest częścią planów płatnych (Starter 49 €/mc, Scale 199 €/mc), a ekran „Połącz KSeF” jest udostępniany razem z dostępem produkcyjnym. Plan płatny zaczyna obowiązywać po zweryfikowaniu połączenia z KSeF.
Jak Notaly przechowuje token
- Token jest szyfrowany AES-256-GCM, powiązany z Twoim kontem, NIP i środowiskiem, i nigdy nie jest ponownie wyświetlany, także naszemu zespołowi wsparcia.
- Jest odszyfrowywany tylko na czas logowania do KSeF i nigdy nie trafia do logów.
- Rozłącz w panelu usuwa zaszyfrowany token. Unieważnij go też w aplikacji KSeF.
Rozwiązywanie problemów
| Objaw | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
Połączenie ma status invalid | Token unieważniony, błędnie wpisany lub z innego środowiska | Wygeneruj nowy token we właściwym środowisku i połącz ponownie |
| KSeF odrzuca logowanie | NIP tokena różni się od podanego NIP | Użyj NIP, w którego kontekście tworzyłeś token |
| Faktury odrzucane z powodu uprawnień | Token bez InvoiceWrite | Wygeneruj token z uprawnieniem do wystawiania faktur |
| Działało w TEST, nie działa na produkcji | Środowiska są rozdzielone | Wygeneruj token produkcyjny w ap.ksef.mf.gov.pl |
Nadal masz problem? Otwórz zgłoszenie przez formularz wsparcia. Opisz błąd, ale nigdy nie podawaj samego tokena.