Aplikacja KSeF nie działa – co zrobić w takiej sytuacji?

Gdy aplikacja KSeF nie działa, najpierw sprawdź połączenie, wersję programu, metodę logowania i uprawnienia do właściwego NIP-u. Nie usuwaj aplikacji ani nie wysyłaj ponownie faktury, dopóki nie ustalisz jej statusu. Czytaj dalej, aby rozpoznać przyczynę i bezpiecznie kontynuować pracę.

Dlaczego aplikacja KSeF nie działa?

Aplikacja mobilna może przestać odpowiadać z wielu powodów. Problem bywa związany z telefonem, nieaktualną wersją programu, biometrią, Profilem Zaufanym, uprawnieniami użytkownika albo niedostępnością usług Ministerstwa Finansów.

Sam komunikat KSeF nie działa nie oznacza jeszcze awarii całego systemu. Aplikacja mobilna, aplikacja przeglądarkowa, Profil Zaufany, Krajowy Węzeł Identyfikacji Elektronicznej oraz integracja przez API są odrębnymi elementami procesu. Jeden z nich może mieć usterkę, gdy pozostałe działają poprawnie.

W 2026 roku aplikacja mobilna KSeF 2.0 działa w środowisku produkcyjnym. Faktura wysłana z tego środowiska trafia do obiegu prawnego, dlatego nie należy używać jej wyłącznie do przypadkowych testów.

Co sprawdzić przed reinstalacją aplikacji?

Najpierw wykonaj czynności, które nie usuwają danych. Kopia robocza faktury może znajdować się wyłącznie w pamięci telefonu, a jej skasowanie utrudni odzyskanie dokumentu.

Przejdź przez podstawową diagnostykę w tej kolejności:

1. Przełącz Wi-Fi na transmisję komórkową lub odwrotnie.
2. Sprawdź w Google Play albo App Store, czy jest dostępna aktualizacja.
3. Zamknij aplikację i uruchom ponownie telefon.
4. Użyj kodu PIN, jeśli logowanie biometrią nie przechodzi.
5. Sprawdź, czy Profil Zaufany działa poza aplikacją KSeF.
6. Zweryfikuj komunikaty techniczne Ministerstwa Finansów dotyczące KSeF.

Po aktualizacji aplikacja może wymagać ponownego uwierzytelnienia lub zaakceptowania zmienionego regulaminu. Na urządzeniach Apple trzeba także sprawdzić wymagania systemowe – aktualna aplikacja może wymagać systemu iOS 15.0 lub nowszego.

Nie kasuj danych programu jako pierwszego kroku. Najpierw ustal, czy masz synchronizację kopii roboczych, dostęp do drugiego urządzenia lub możliwość wystawienia dokumentu w innym kanale.

Logowanie przez Profil Zaufany

Profil Zaufany służy do potwierdzenia tożsamości użytkownika w KSeF, ale jego niedostępność nie musi oznaczać awarii samego systemu faktur. Sprawdź, czy profil jest aktywny oraz czy podajesz właściwy NIP podmiotu.

Jeśli usługa identyfikacji nie działa, spróbuj mObywatela, mojeID, e-dowodu lub innej dostępnej metody Krajowego Węzła. Gdy wszystkie metody są niedostępne, trzeba sprawdzić oficjalny komunikat i poczekać na przywrócenie działania usługi.

Uprawnienia do profilu firmy

Poprawne uwierzytelnienie nie wystarczy, jeśli użytkownik nie ma dostępu do konkretnej firmy. Brak profilu, pustą listę przedsiębiorstw lub niemożność wysłania faktury może powodować niewłaściwy zakres uprawnień.

W spółkach uprawnienia może poprzedzać formularz ZAW-FA, szczególnie gdy podmiot nie korzysta z kwalifikowanej pieczęci z NIP-em. Administrator powinien sprawdzić, czy dana osoba ma prawo do dostępu do faktur oraz do ich wystawiania.

Jak rozpoznać kod błędu KSeF?

Pełna treść komunikatu i jego numer pomagają odróżnić problem aplikacji od błędu integracji lub uprawnień. Zapisz kod, godzinę wystąpienia, ekran aplikacji i czynność wykonywaną przed pojawieniem się komunikatu.

Błędy wymagające pomocy dostawcy programu

Błąd 401, komunikat autoryzacja w trakcie, nieprawidłowy token API oraz informacje AppStore and InConnector must be active zwykle dotyczą programu łączącego się z KSeF, a nie telefonu.

W takim przypadku zgłoś problem do wsparcia technicznego używanego systemu. Podaj adres konta widoczny w ustawieniach, pełną treść komunikatu oraz godzinę zdarzenia. Nie przekazuj haseł, tokenów ani kodów jednorazowych.

Certyfikaty i podpis elektroniczny

Kod 21115 oznacza użycie niewłaściwego certyfikatu. Certyfikat z Aplikacji Podatnika KSeF DEMO nie zadziała w środowisku produkcyjnym, a produkcyjny nie służy do testów.

Przy błędzie 400 pobierz plik XML ponownie, podpisz go aktualnym Profilem Zaufanym, podpisem kwalifikowanym albo pieczęcią i nie edytuj dokumentu po podpisaniu. Kod 21111 wymaga ponownego pobrania jednorazowego wyzwania. Przy 9103 dokument może zawierać tylko jeden podpis.

Co zrobić z fakturą, gdy aplikacja nadal nie działa?

Jeżeli termin wystawienia jest pilny, nie musisz ograniczać się do aplikacji mobilnej. Możesz użyć aplikacji webowej KSeF, systemu księgowego albo integracji API – pod warunkiem posiadania właściwych uprawnień i certyfikatów.

Najpierw sprawdź, czy faktura nie została już przyjęta. Numer KSeF pojawia się w odpowiedzi systemu, a potwierdzenie można znaleźć także w UPO. Samo naciśnięcie przycisku wysyłki nie jest dowodem przyjęcia dokumentu.

Gdy KSeF działa, lecz telefon lub aplikacja odmawia współpracy, zastosuj następujący schemat:

1. Otwórz aplikację webową albo firmowy program księgowy.
2. Odtwórz dokument tylko wtedy, gdy nie ma potwierdzenia wcześniejszej wysyłki.
3. Zweryfikuj strukturę XML FA(3) przed przekazaniem faktury.
4. Sprawdź status przetwarzania po wysyłce.
5. Pobierz numer KSeF i UPO do dokumentacji firmy.

Kiedy można użyć trybu offline24?

Tryb offline24 służy między innymi do sytuacji, w której podatnik nie ma internetu, korzysta z niesprawnego programu albo nie może połączyć się z systemem z przyczyn lokalnych. Faktura musi mieć strukturę XML FA(3), a do jej oznaczenia potrzebny jest certyfikat KSeF typu 2.

Dokument należy przesłać do KSeF najpóźniej w ciągu 24 godzin, czyli następnego dnia roboczego według zasad obowiązujących dla tego trybu. Nie trzeba przedstawiać dowodu braku internetu, ale powtarzalne używanie procedury bez uzasadnienia może rodzić pytania podczas kontroli.

Awaria aplikacji mobilnej nie uruchamia automatycznie trybu awaryjnego KSeF. Ten tryb zależy od oficjalnego komunikatu Ministerstwa Finansów. Jeśli problem dotyczy wyłącznie telefonu, bezpieczniej użyć innego kanału wysyłki niż wystawiać dokument offline bez potrzeby.

Jak zgłosić problem?

Zgłoszenie do Ministerstwa Finansów powinno zawierać informacje techniczne, ale nie dane poufne. Podaj wersję aplikacji, system telefonu, datę i godzinę błędu, ekran, na którym się pojawił, oraz wykorzystaną metodę identyfikacji.

Dołącz zrzut ekranu z zasłoniętym NIP-em, danymi kontrahenta, kwotami i tokenami. W sprawach błędu 401, nieprawidłowego tokenu API lub problemów typu autoryzacja w trakcie właściwym adresatem pozostaje dostawca programu integrującego się z KSeF.

Przy większej liczbie faktur dobrze mieć drugi kanał pracy, zapasowego użytkownika z uprawnieniami oraz rejestr numerów KSeF i UPO. Taki proces ogranicza ryzyko podwójnej wysyłki, nawet gdy telefon przestanie działać w trakcie wystawiania dokumentu.