503 Service Unavailable to odpowiedź serwera, który chwilowo nie obsługuje zapytań — z powodu przerwy technicznej, awarii albo przeciążenia. Problem leży po stronie KSeF, nie Twojej faktury. Sprawdź status KSeF i — jeśli niedostępność trwa — wystaw fakturę w trybie offline.
Aktualizacja: 11 października 2026 · Opisy z dokumentacji API KSeF 2.0 (MF) · Przykłady sprawdzone na środowisku testowym KSeF
Gdzie pojawia się kod 503 — brzmienie z dokumentacji MF
Odpowiedź HTTP API KSeF
„Service Unavailable”
Najpierw sprawdź, czy KSeF działa
Na stronie Czy KSeF działa? co minutę sprawdzamy API KSeF, Aplikację Podatnika i logowanie, a obok pokazujemy oficjalny status z Latarni KSeF Ministerstwa Finansów. Jeśli wszystko jest zielone, a Twój program dalej zwraca 503, problem może leżeć po stronie dostawcy programu albo połączenia.
„Operacja została anulowana przez system” — przerwane z przyczyn wewnętrznych; spróbuj ponownie.
21184
Wysyłka faktury
„Sesja tymczasowo niedostępna” — prace serwisowe; otwórz nową sesję.
Faktura z takim statusem nie ma numeru KSeF. Ponowna wysyłka po przywróceniu działania nie będzie duplikatem.
Faktura offline: terminy dosłania
Sytuacja
Do kiedy wysłać fakturę do KSeF
Tryb offline24 (każdy powód, bez ogłoszenia MF)
następny dzień roboczy po dacie wystawienia
Ogłoszona przerwa techniczna (niedostępność)
następny dzień roboczy po jej zakończeniu
Ogłoszona awaria
7 dni roboczych od jej zakończenia
Awaria całkowita (ogłoszona w mediach)
nie trzeba dosyłać
Fakturę offline wystawiasz w strukturze FA(3) i oznaczasz kodami QR. Dokładny termin dla konkretnej daty policzysz w kalkulatorze na stronie Czy KSeF działa? — uwzględnia weekendy i święta, w tym Wigilię.
Pytania o błąd 503
Czy przy 503 mogę wystawić fakturę poza KSeF?
Tak, w trybie offline24 możesz wystawić fakturę z dowolnego powodu i dosłać ją do KSeF do końca następnego dnia roboczego. Przy ogłoszonej awarii termin jest dłuższy — 7 dni roboczych od jej zakończenia.
Skąd wiem, czy MF ogłosiło awarię?
Oficjalne komunikaty MF publikuje w Latarni KSeF i na ksef.podatki.gov.pl. Pokazujemy je na stronie statusu razem z historią dostępności z ostatnich 90 dni — od ogłoszenia zależy, który termin dosłania faktur obowiązuje.