Mobilna Faktura
Zaloguj
KSeF

Połączenie z KSeF

Jak skonfigurować integrację z Krajowym Systemem e-Faktur: token autoryzacyjny albo certyfikat KSeF, środowiska, test połączenia.

Zrzuty ekranu

Screenshot 1 - Połączenie z KSeF

Dostępność: każdy pakiet.

Co to jest KSeF?

KSeF (Krajowy System e-Faktur) to system Ministerstwa Finansów do wystawiania i odbierania faktur ustrukturyzowanych.

Gdzie są ustawienia

Ustawienia → Integracje → KSeF. Najważniejsze pola:

  • Włącz integrację KSeF — bez tego zaznaczenia żadna operacja KSeF nie działa,
  • Środowisko — Testowe, Demo/Przedprodukcyjne albo Produkcyjne,
  • Metoda logowania do KSeF — token autoryzacyjny (domyślnie) albo certyfikat KSeF,
  • Token autoryzacyjny,
  • NIP firmy — tylko do odczytu, pobierany z Ustawienia → Firma → Dane sprzedawcy.

Po zmianach kliknij Zapisz ustawienia.

Ustawienia KSeF — integracja, środowisko, token i metoda logowania

Metody logowania do KSeF

Token autoryzacyjny (domyślna)

  1. Zaloguj się do Aplikacji Podatnika KSeF w środowisku, którego chcesz używać (testowe: ksef-test.mf.gov.pl, demo: ksef-demo.mf.gov.pl, produkcyjne: ksef.mf.gov.pl).
  2. Wygeneruj token autoryzacyjny dla zewnętrznego oprogramowania.
  3. W panelu: Ustawienia → Integracje → KSeF → wklej token w pole Token autoryzacyjny i kliknij Zapisz ustawienia.
  4. Kliknij Testuj połączenie — komunikat „Połączenie z KSeF działa poprawnie!” i zielona etykieta Połączono potwierdzają konfigurację.

Certyfikat KSeF (podpis XAdES)

Metoda zalecana przez Ministerstwo Finansów — certyfikat jest weryfikowany natychmiast:

  1. W Aplikacji Podatnika KSeF przejdź do Certyfikaty → Wnioskuj o certyfikat i wybierz przeznaczenie „Uwierzytelnienie”.
  2. Pobrane pliki (.crt + .key albo .p12) wgraj w panelu: Ustawienia → Integracje → KSeF → sekcja „Certyfikat KSeF — logowanie (uwierzytelnianie)”, podaj hasło i kliknij Wgraj certyfikat.
  3. W polu Metoda logowania do KSeF wybierz Certyfikat KSeF (podpis XAdES), zapisz i kliknij Testuj połączenie.

Hasło nadane przy generowaniu certyfikatu zapisz u siebie — nie da się go odzyskać, a panel go nie przechowuje.

Pozostałe ustawienia

  • NIP — musi mieć 10 cyfr bez myślników; to dla niego musi być wystawiony token lub certyfikat.
  • Automatyczne wysyłanie — „Automatycznie wysyłaj faktury do KSeF przy zapisie”. Przy zapisie wysyłane są: Faktura, Faktura MP, Faktura marża, Faktura zaliczkowa i Faktura końcowa. Korekty i pozostałe typy wysyłasz ręcznie — patrz Wysyłka faktur do KSeF.
  • Import sprzedaży z KSeF — „Importuj moje faktury sprzedaży wystawione poza aplikacją” (pakiet MAX), patrz Pobieranie i import faktur z KSeF.
  • Certyfikat KSeF — tryb offline (awaria KSeF) — do fakturowania podczas awarii KSeF, patrz Tryb offline i certyfikaty KSeF.
  • Powiadomienia o nowych fakturach z KSeF — patrz Powiadomienia o nowych fakturach z KSeF.
  • Przycisk Sprawdź statusy KSeF — odświeża statusy faktur, które czekają na przetworzenie w KSeF.

Środowisko testowe a produkcyjne

  • Testowe — do nauki i testów (faktury nie są prawdziwe); ustawione domyślnie,
  • Demo/Przedprodukcyjne — środowisko przedprodukcyjne,
  • Produkcyjne — prawdziwe faktury.

Token i certyfikaty są wydawane osobno dla każdego środowiska — token z portalu testowego nie zadziała na produkcji.

Rozwiązywanie problemów

„Błąd autoryzacji” (401/403)

  • Sprawdź, czy token jest aktualny i wygenerowany w tym samym środowisku, które wybrano w ustawieniach.
  • Upewnij się, że NIP w danych sprzedawcy zgadza się z NIP-em, dla którego wystawiono token lub certyfikat.

„Środowisko KSeF jest obecnie niedostępne”

  • Awaria lub przerwa techniczna po stronie Ministerstwa Finansów. Jeśli masz wgrany certyfikat offline, faktury wystawiają się dalej w trybie offline.

Faktura z czerwonym ✗ na liście dokumentów

  • Treść błędu sprawdzisz w Ustawienia → Integracje → Dziennik KSeF — dziennik rejestruje wszystkie operacje KSeF razem z treścią błędów. Patrz KSeF: statusy, UPO i dziennik.

Zobacz także