Token KSeF

Token KSeF to jak hasło — traktuj go ostrożnie:

• Zapisz w bezpiecznym miejscu: Użyj menedżera haseł (np. 1Password, Bitwarden) lub zaszyfrowanego pliku
• Nie udostępniaj nikomu: Token daje pełny dostęp do Twoich faktur w systemie KSeF
• Nie wysyłaj e-mailem: E-mail nie jest bezpiecznym kanałem do przesyłania tokenów
• Regularnie sprawdzaj status: Upewnij się, że token jest aktywny (Status: Active ✓)

W aplikacji KSeF Monitor: Token jest przechowywany lokalnie w pamięci przeglądarki (localStorage). Nie jest wysyłany na żadne serwery zewnętrzne — tylko bezpośrednio do API KSeF przez backend proxy.

Tokeny KSeF działają bezterminowo, ale mogą zostać unieważnione lub wygasać z innych powodów:

1. Sprawdź status w sekcji "Szczegóły tokenu":
   • Active ✓ — wszystko OK, token działaczy
   • Expired/Revoked — musisz wygenerować nowy
2. Jeśli token wygasł lub został unieważniony:
   • Wejdź do Aplikacji Podatnika KSeF
   • Przejdź do Tokeny → Generuj token
   • Wygeneruj nowy token z takimi samymi uprawnieniami
   • Skopiuj nowy token i wprowadź w KSeF Monitor (krok 3-4 powyżej)

Tip: Jeśli masz wątpliwości czy token działa, kliknij "Użyj innego tokenu" i wprowadź go ponownie. Aplikacja zweryfikuje go od nowa.

System KSeF ma dwa środowiska — produkcyjne i testowe:

Ważne: Token z środowiska produkcyjnego nie działa w środowisku testowym i odwrotnie. Musisz wygenerować osobny token dla każdego środowiska.

W KSeF Monitor: Aplikacja automatycznie wykrywa środowisko na podstawie tokenu (po segmencie -EC- w numerze referencyjnym) i łączy się z odpowiednim API.

Token może mieć różne uprawnienia (nadawane podczas generowania):

• Odczyt faktur (Invoice Read):
  • Pobieranie list faktur (otrzymanych, wystawionych)
  • Pobieranie szczegółów pojedynczej faktury
  • Eksport do Excel, PDF, XML
• Wysyłanie faktur (Invoice Write):
  • Wystawianie nowych faktur
  • Dodawanie faktur do systemu KSeF
• Zarządzanie tokenami (Token Management):
  • Generowanie nowych tokenów
  • Unieważnianie istniejących tokenów
  • Przeglądanie listy tokenów

Dla KSeF Monitor wystarczy "Odczyt faktur" — aplikacja służy tylko do przeglądania i pobierania faktur. Nie potrzebujesz uprawnień do wysyłania faktur ani zarządzania tokenami.

Najczęstsze problemy i ich rozwiązania:

🔴 "Token musi składać się z 3 części"

• Sprawdź czy skopiowałeś cały token (łącznie z pionowymi kreskami |)
• Usuń przypadkowe spacje na początku lub końcu
• Skopiuj ponownie bezpośrednio z Aplikacji Podatnika KSeF

🔴 "Nieprawidłowy format Reference Number"

• Token może być uszkodzony podczas kopiowania
• Sprawdź czy pierwszy segment ma format: RRRRMMDD-XX-XXXXXXXXXX-XXXXXXXXXX-XX
• Skopiuj token ponownie lub wygeneruj nowy

🔴 "Token wygasł lub został unieważniony"

• Wygeneruj nowy token w Aplikacji Podatnika KSeF
• Sprawdź czy nie unieważniłeś przypadkowo tokenu w portalu
• Upewnij się, że używasz tokenu z właściwego środowiska (produkcja/test)

🔴 "Błąd połączenia z API KSeF"

• Sprawdź połączenie internetowe
• Spróbuj ponownie za chwilę (API może być chwilowo niedostępne)
• Sprawdź czy backend proxy działa (port 7071)

Tak! Ten sam token KSeF może być używany na wielu urządzeniach równocześnie.

• Token jest przypisany do Twojego NIP, nie do konkretnego urządzenia
• Możesz wprowadzić ten sam token w KSeF Monitor na komputerze domowym, służbowym i na laptopie
• Wszystkie urządzenia będą miały dostęp do tego samego konta w systemie KSeF
• Tip: Zapisz token w menedżerze haseł (np. 1Password, Bitwarden) z synchronizacją chmurową — będziesz mógł łatwo skopiować go na każdym urządzeniu

Uwaga bezpieczeństwa: Jeśli używasz tokenu na współdzielonym komputerze, pamiętaj aby kliknąć "Usuń aktualny token" przed wyjściem z aplikacji.

Token KSeF jest bezterminowy — działa do momentu jego unieważnienia.

• Nie wygasa automatycznie: Token będzie działał tak długo, jak długo go nie unieważnisz
• Ważność do 31 grudnia 2026: Po tej dacie system KSeF przestanie akceptować tokeny — będziesz musiał używać certyfikatów kwalifikowanych
• Możesz unieważnić ręcznie: W Aplikacji Podatnika KSeF (Tokeny → Lista tokenów → Unieważnij)
• Powody unieważnienia: Token wyciekł, został skradziony, nie potrzebujesz już dostępu

W KSeF Monitor: Sprawdź status tokenu w sekcji "Szczegóły tokenu". Jeśli widzisz Active ✓ — token działa prawidłowo.

Tak! Możesz wygenerować wiele tokenów z różnymi uprawnieniami.

• Różne zastosowania: Jeden token do przeglądania faktur (Invoice Read), drugi do wystawiania faktur (Invoice Write), trzeci do zarządzania tokenami (Token Management)
• Różne aplikacje: Osobny token dla KSeF Monitor, osobny dla programu księgowego
• Różne środowiska: Osobny token dla produkcji, osobny dla środowiska testowego

W KSeF Monitor: Aplikacja przechowuje tylko jeden token na raz. Jeśli chcesz zmienić token, kliknij "Użyj innego tokenu" i wprowadź nowy. Stary zostanie zastąpiony.

Tip: Nadawaj opisowe nazwy tokenompodczas generowania (np. "KSeF Monitor - odczyt", "Program księgowy - zapis"), aby łatwiej je odróżnić w Aplikacji Podatnika KSeF.

Przycisk "Usuń aktualny token" usuwa token tylko z aplikacji KSeF Monitor, nie z systemu KSeF.

Co zostanie usunięte:

• Token KSeF zapisany w localStorage przeglądarki
• Tokeny JWT (accessToken, refreshToken) używane do autoryzacji API
• Metadane tokenu (status, uprawnienia, ostatnie użycie)

Co NIE zostanie usunięte:

• Token w systemie KSeF — nadal będzie aktywny i widoczny w Aplikacji Podatnika
• Twoje faktury w systemie KSeF — pozostaną nienaruszone
• Uprawnienia tokenu — token nadal będzie działać w innych aplikacjach

Co się stanie po usunięciu:

• Zostaniesz wylogowany z KSeF Monitor
• Wszystkie funkcje aplikacji będą niedostępne (faktury otrzymane, wystawione, szczegóły)
• Zobaczysz formularz wprowadzania tokenu
• Będziesz mógł wprowadzić ten sam token ponownie lub użyć innego

Kiedy używać: Gdy chcesz zmienić token na inny, pracujesz na współdzielonym komputerze (bezpieczeństwo), lub chcesz "odświeżyć" aplikację (reset).

Unieważnienie w systemie KSeF: Jeśli chcesz całkowicie unieważnić token (np. gdy wyciekł lub został skradziony), musisz to zrobić w Aplikacji Podatnika KSeF: Tokeny → Lista tokenów → [wybierz token] → Unieważnij.

Tak! Token KSeF jest bezpieczny, jeśli zastosujesz odpowiednie środki ostrożności.

🔒 Zabezpieczenia systemowe:

• Szyfrowanie transmisji: Wszystkie połączenia z API KSeF używają HTTPS (TLS 1.2+)
• Backend proxy: Token nie jest wysyłany bezpośrednio z przeglądarki — tylko przez szyfrowany backend
• Protokół Challenge-Response: Uwierzytelnianie przez kryptograficzny challenge (nie można przechwycić)
• JWT tokeny: Po uwierzytelnieniu używane są krótkotrwałe tokeny JWT (auto-odświeżanie co 15 min)
• localStorage: Token przechowywany lokalnie w przeglądarce, nie na serwerze

🔐 Dobre praktyki użytkownika:

• Nie udostępniaj tokenu: Traktuj go jak hasło — nie wysyłaj nikomu, nie publikuj
• Używaj menedżera haseł: Zapisz token w zaszyfrowanym menedżerze (1Password, Bitwarden, LastPass)
• Ogranicz uprawnienia: Token dla KSeF Monitor potrzebuje tylko "Odczyt faktur"
• Regularnie sprawdzaj: Monitoruj listę tokenów w Aplikacji Podatnika (Tokeny → Lista tokenów)
• Unieważnij stare: Jeśli token wyciekł lub go nie używasz — unieważnij go

⚠️ Ryzyko:

• Token to klucz dostępu: Każdy kto ma Twój token może uzyskać dostęp do faktur
• Brak 2FA: Token nie wymaga dodatkowego uwierzytelniania (np. SMS, aplikacja)
• Ważność do 2026: Po 31 grudnia 2026 tokeny przestaną działać (wymagany certyfikat kwalifikowany)

Podsumowanie: Token KSeF jest bezpieczny, jeśli go chronisz. Nie udostępniaj go nikomu, przechowuj w bezpiecznym miejscu, regularnie monitoruj jego użycie i unieważnij gdy już nie potrzebujesz.

KSeF Monitor przechowuje token lokalnie w Twojej przeglądarce, nie na serwerze.

📍 Lokalizacja:

• localStorage przeglądarki: Token zapisany w mechanizmie Web Storage API
• Dane przechowywane:
  • ksefToken — pełny token KSeF (3 segmenty)
  • accessToken — JWT token do autoryzacji API (ważny 15 min)
  • refreshToken — JWT token do odświeżania sesji (ważny 24h)
  • tokenDetails — metadane (status, uprawnienia, ostatnie użycie)
• Ścieżka: W narzędziach deweloperskich przeglądarki: Application → Local Storage → https://localhost:3000

🔒 Bezpieczeństwo localStorage:

• Izolacja domeny: Tylko aplikacja z localhost:3000 ma dostęp do tych danych
• Brak dostępu z innych stron: Inne strony/aplikacje nie mogą odczytać tokenu
• Przechowywanie lokalne: Dane nie są wysyłane na żadne serwery zewnętrzne
• Automatyczne odświeżanie: JWT tokeny odświeżane co 15 min (proaktywnie, 5 min przed wygaśnięciem)

🗑️ Usuwanie danych:

• Przycisk "Usuń aktualny token": Usuwa wszystkie dane z localStorage
• Wyczyszczenie pamięci przeglądarki: Settings → Privacy → Clear browsing data → Cookies and site data
• Tryb incognito: Po zamknięciu okna wszystkie dane są automatycznie usuwane

Czy to bezpieczne? Tak, dla aplikacji Office Add-in to standard. localStorage jest izolowany per domena i nie jest dostępny z zewnątrz. Jedyne ryzyko to fizyczny dostęp do komputera — dlatego zawsze blokuj komputer gdy odchodzisz.

Tip: Jeśli pracujesz na współdzielonym komputerze, używaj trybu incognito (Ctrl+Shift+N w Chrome) — token zostanie automatycznie usunięty po zamknięciu okna.

Jeśli nie masz jeszcze tokenu KSeF, sprawdź instrukcję krok po kroku jak go wygenerować w Aplikacji Podatnika KSeF.

Oficjalna aplikacja KSeF do zarządzania fakturami elektronicznymi w środowisku produkcyjnym.

Środowisko testowe do sprawdzania funkcjonalności przed wdrożeniem w produkcji.

Oficjalny portal informacyjny Krajowego Systemu e-Faktur z aktualnościami i dokumentacją.