Panel integracji KSeF
Panel integracji KSeF to centrum zarządzania połączeniem z Krajowym Systemem e-Faktur: sprawdzisz tu status połączenia, uprawnienia, synchronizację faktur i przeprowadzisz diagnostykę.
Gdzie znajdziesz panel
Kliknij w menu zakładkę "Inne" i wybierz "KSeF - Krajowy System e-Faktur" lub przejdź pod adres https://app.fakturnia.pl/konto/ksef.
Wybierz Więcej → Krajowy System e-Faktur.
Status połączenia
W górnej części panelu znajduje się karta "Status połączenia". Przy poprawnej konfiguracji zobaczysz komunikat "Połączono z KSeF" oraz:
- "NIP": numer firmy połączonej z KSeF,
- "Metoda": sposób uwierzytelnienia, czyli "Token" albo "Certyfikat",
- "Certyfikat ważny do": data, do której certyfikat jest ważny (tylko przy połączeniu certyfikatem, token nie ma daty ważności),
- "Sprawdzono": moment ostatniego sprawdzenia połączenia, obok przycisk "Odśwież".
Gdy certyfikat zbliża się do końca ważności, na karcie pojawi się przycisk "Certyfikat wygasa za N dni, odnów go lub przejdź na token", który od razu otwiera okno "Połącz z KSeF".
Połączenie tokenem nie wymaga żadnych zmian. Ministerstwo Finansów zdecydowało o zachowaniu tokenów na czas nieokreślony, więc wcześniejsza zapowiedź ich wyłączenia 1 stycznia 2027 roku jest nieaktualna. Więcej w artykule Konfiguracja KSeF.
Uprawnienia
Sekcja "Uprawnienia" wyświetla uprawnienia, z którymi Fakturnia łączy się z KSeF, na przykład odczyt i wystawianie faktur. Jeżeli brakuje kluczowego uprawnienia, zobaczysz ostrzeżenie "Brakujące uprawnienia w KSeF" z wyjaśnieniem, czego dotyczy. Przy certyfikacie uprawnienia nadaje się w systemie Ministerstwa Finansów. Przy tokenie są zapisane w tokenie, więc trzeba wygenerować nowy token z właściwymi uprawnieniami.
Zmiana tokena lub certyfikatu
Jeżeli chcesz użyć nowego tokena, odnowić certyfikat albo zmienić metodę połączenia:
- W sekcji "ZARZĄDZANIE POŁĄCZENIEM" wybierz "Zmień token lub certyfikat".
- W oknie "Połącz z KSeF" wybierz metodę: "Token KSeF" albo "Certyfikat KSeF". Metoda, z której konto korzysta teraz, ma plakietkę "Obecna metoda".
- Przy tokenie wklej nowy token. Przy certyfikacie wgraj oba pliki pobrane z KSeF (certyfikat i klucz prywatny, rozpoznawane po zawartości w formacie PEM) i wprowadź "Hasło klucza prywatnego".
- Kliknij "Połącz z KSeF". Konto łączy się jedną metodą naraz, więc po zmianie metody poprzedni token albo certyfikat zostanie usunięty z konta.
Diagnostyka połączenia
- "Odśwież" na karcie statusu: sprawdza połączenie i aktualizuje czas ostatniego sprawdzenia. Okno z wynikiem pojawia się tylko przy błędzie.
- "Diagnostyka połączenia" w sekcji "ZARZĄDZANIE POŁĄCZENIEM": to samo sprawdzenie, ale okno z wynikiem otwiera się zawsze, także gdy wszystko działa.
- Jeżeli ostatnie sprawdzenie się nie powiodło, nad kartą statusu pojawi się ostrzeżenie "Ostatnia weryfikacja połączenia nie powiodła się" z listą najczęstszych przyczyn i przyciskiem "Sprawdź ponownie".
- "Dezaktywuj połączenie": wyłącza połączenie z systemem KSeF.
Na ekranie Więcej → Krajowy System e-Faktur, w sekcji "ZARZĄDZANIE POŁĄCZENIEM", znajdziesz te same akcje: "Zmień token lub certyfikat", "Komunikaty techniczne KSeF" i "Dezaktywuj połączenie". Ostrzeżenia o brakujących uprawnieniach i wstrzymanej synchronizacji wyglądają tak samo jak w przeglądarce.
Synchronizacja faktur
W sekcji "Synchronizacja faktur" zobaczysz, że nowe faktury pobierają się automatycznie do 30 minut. Przyciskiem "Synchronizuj faktury" uruchomisz pobieranie ręcznie z wybranego okresu. Więcej w artykule Faktury kosztowe z KSeF.
Jeżeli subskrypcja konta wygasła, w panelu pojawi się ostrzeżenie "Synchronizacja wstrzymana": automatyczne pobieranie faktur z KSeF zostaje wstrzymane do czasu odnowienia planu, po którym wznowi się samo.
Komunikaty techniczne KSeF
W sekcji "ZARZĄDZANIE POŁĄCZENIEM" znajdziesz link "Komunikaty techniczne KSeF" do aktualnych komunikatów Ministerstwa Finansów o działaniu systemu, na przykład o przerwach technicznych, oraz link "Poradnik konfiguracji" do instrukcji połączenia.
Zobacz też
Zapytaj AI o ten artykuł
Wybierz asystenta. Otworzy się z gotowym pytaniem, przeczyta ten artykuł i odpowie na Twoje pytania.