downdetector: Co robić przy awarii logowania KSeF

Pisałem ten tekst tuż po tym, jak klientów w mojej firmie zaskoczyło: “Nie mogę się zalogować do KSeF”. Szybko sprawdziłem downdetector i zobaczyłem, że to nie tylko my — pojawiła się fala zgłoszeń o problemach. Jeśli teraz wpisujesz w wyszukiwarkę “ksef problem z logowaniem” albo “logowanie do ksef” i czujesz presję deadline’ów VAT — ten artykuł jest praktycznym planem działania.

Jak użyć Downdetector, żeby odróżnić awarię systemu od lokalnego błędu

Downdetector to pierwsze miejsce, do którego idę, gdy widzę komunikaty o błędach. Na stronie serwisu (lub w aplikacji) znajdziesz wykresy zgłoszeń i mapę — to od razu pokazuje, czy problem jest ogólnopolski, czy lokalny.

Krótka instrukcja:

• Wejdź na downdetector.pl.
• Wyszukaj “KSeF” lub nazwę usługi, której dotyczy problem.
• Sprawdź wykres zgłoszeń: nagły skok to zwykle awaria po stronie usługi.
• Przejrzyj najnowsze komentarze użytkowników — często tam trafisz na potwierdzenia typu “logowanie ksef nie działa” lub “profil zaufany awaria”.

To szybki filtr: jeśli downdetector pokazuje masowe zgłoszenia, poświęć czas na komunikację z księgowością i odłóż ryzykowne akcje. Jeśli nie ma wzrostu zgłoszeń — przechodzisz do lokalnego debugowania.

Co zrobić natychmiast: 7 kroków, które działają

To lista, którą sam stosuję, gdy słyszę “logowanie do ksef nie działa”. Wykonuj po kolei — oszczędzasz czas i unikasz fałszywych zgłoszeń do supportu.

1. Sprawdź Downdetector — potwierdź, że to nie ogólny outage.
2. Odśwież przeglądarkę i spróbuj trybu prywatnego (incognito). Czasem ciasteczka i cache blokują logowanie.
3. Spróbuj innej przeglądarki lub wyczyść cache — Chrome/Edge/Firefox różnie traktują certyfikaty.
4. Sprawdź status Profilu Zaufanego — jeśli “profil zaufany awaria” pojawia się w wyszukiwaniach, to często blokada logowania do KSeF. Oficjalne info znajdziesz na stronie rządowej: gov.pl: Profil Zaufany.
5. Jeżeli używasz certyfikatu kwalifikowanego (e‑certyfikat), upewnij się, że certyfikat nie wygasł i że masz zainstalowane potrzebne certyfikaty pośrednie.
6. Sprawdź połączenie z API KSeF (jeśli korzystasz z integracji) — logi aplikacji pokażą HTTP error code (401, 503 itp.).
7. Jeśli dalej nie działa, zrób zdjęcie/ zrzut ekranu błędu i otwórz zgłoszenie do pomocy technicznej KSeF oraz do dostawcy Profilu Zaufanego.

Mała uwaga z doświadczenia: bardzo często problemem jest sesja wygasła podczas pracy z wieloma narzędziami jednocześnie. Restart przeglądarki potrafi zaoszczędzić 15 minut paniki.

Przykłady komunikatów i ich znaczenie

• 401 / “Nieautoryzowany” — problem z uwierzytelnieniem; sprawdź Profil Zaufany lub certyfikat.
• 503 / “Service Unavailable” — najczęściej awaria po stronie KSeF (sprawdź downdetector i oficjalne komunikaty na stronie podatki.gov.pl: podatki.gov.pl – KSeF).
• Błędy związane z CORS lub certyfikatami — raczej po stronie integracji lub przeglądarki.

Jeśli problem to Profil Zaufany: szybkie obejścia i kontakty

Gdy widzę “profil zaufany awaria” w komentarzach na downdetector lub w mediach społecznościowych, robię trzy rzeczy jednocześnie: informuję zespół, sprawdzam alternatywne metody logowania i przygotowuję plan B.

Alternatywy do Profilu Zaufanego (gdy jest niedostępny):

• Logowanie certyfikatem kwalifikowanym (jeżeli twoje konto ma przypisany e‑certyfikat) — działa niezależnie od Profilu Zaufanego.
• Zlecenie wysłania dokumentów przez pełnomocnika (jeśli czas pozwala).
• Jeśli to masowa operacja, rozważ przesunięcie terminów wewnętrznych i powiadomienie klienta, że problem jest po stronie systemu (udokumentuj to zrzutami z downdetector).

W praktyce: ja zawsze robię zrzuty ekranu z downdetector i oficjalnych komunikatów — to pomaga udowodnić, że to nie lokalny błąd i usprawnia komunikację z urzędem lub supportem.

Co napisać do supportu KSeF — szablon zgłoszenia

Do supportu pisz krótko i konkretnie. Oto fragment, którego używam:

<language>PL
Szanowni Państwo,

Od [godzina, data] występuje problem z logowaniem do KSeF (użytkownik: [login/nip]). Komunikat błędu: “[treść błędu]”. Sprawdziłem: Downdetector pokazuje wzrost zgłoszeń, próbowałem innej przeglądarki i trybu incognito, certyfikat jest ważny. Proszę o informację, czy to awaria globalna i przewidywany czas przywrócenia usługi.

Załączam zrzuty ekranu.
Pozdrawiam,
[Imię i nazwisko]
</language>

Takie zgłoszenie skraca czas odpowiedzi, bo od razu dostawca widzi, że wykonałeś podstawowe kroki diagnostyczne.

Integracje i API: jak sprawdzić, czy to problem techniczny czy integracyjny

Jeśli twoja firma używa integratora do wysyłki faktur do KSeF, sprawdź logi API. Najczęstsze symptomy:

• Masowe błędy 503 — problem po stronie KSeF.
• 401/403 — błędna autoryzacja, token wygasł albo Profil Zaufany nie potwierdził sesji.
• Timeouty — przeciążenie sieci lub serwera.

Co robić:

1. Zaloguj się ręcznie do interfejsu KSeF — jeśli nie działa dla użytkownika, to prawdopodobnie jest awaria.
2. Sprawdź dokumentację integratora i komunikaty dostawcy o statusie (często publikują statusy na swoich dashboardach).
3. Jeżeli integrator ma tryb diagnostyczny, uruchom go i wyślij przykładowe żądanie do sandboxa (jeśli dostępny).

Jak komunikować problem wewnętrznie i na zewnątrz

Gdy widzę falę zgłoszeń, robię krótkie, jasne komunikaty:

• Dla zespołu: “Występuje ogólnopolska awaria usług logowania do KSeF — sprawdzamy sytuację. Nie wysyłajcie zmian do systemu X do czasu potwierdzenia.”
• Dla klientów: “Obecnie niektóre funkcje logowania do KSeF mogą być niestabilne. Monitorujemy sytuację; prosimy o cierpliwość.”

Po przywróceniu działania wyjaśniam przyczynę i kroki, które wykonaliśmy, by naprawić problem — to buduje zaufanie.

Prewencja: jak zmniejszyć wpływ przyszłych awarii

Nie ma idealnej recepty, ale doświadczenie nauczyło mnie kilku praktycznych zasad:

• Miej zawsze alternatywną metodę autoryzacji (e‑certyfikat obok Profilu Zaufanego).
• Automatycznie zbieraj zrzuty logów i statusy (np. co 5 minut) — pomagają w raportach do urzędu.
• Szkol zespół: procedura postępowania przy awarii powinna być jasna i przetestowana.
• Subskrybuj oficjalne kanały statusowe KSeF i Profilu Zaufanego, by nie polegać wyłącznie na downdetector.

Jak rozpoznać, że problem został rozwiązany

W mojej praktyce oznaki powrotu do normalności to:

• Downdetector pokazuje spadek zgłoszeń do normalnego poziomu.
• Oficjalny komunikat na stronie podatki.gov.pl lub gov.pl informuje o przywróceniu usługi.
• Możesz się zalogować na kilku kontach i wysłać testową fakturę (w integracji — wysyłka testowa zwraca normalny kod 200/201).

Gdy nic nie działa: dalsze kroki

Jeśli po wszystkich próbach nadal stoi “logowanie ksef” — zrób dokumentację i eskaluj:

• Zapisz czasy i zrzuty błędów.
• Wyślij zgłoszenie do KSeF i Profilu Zaufanego z pełną historią kroków diagnostycznych.
• Jeśli masz opiekuna technicznego u dostawcy integracji — zadzwoń i poproś o potwierdzenie, że to awaria globalna.

W moim przypadku takie uporządkowane zgłoszenie skracało czas reakcji supportu i przyspieszało wprowadzenie tymczasowych obejść.

Rzetelne źródła i gdzie sprawdzać statusy

• KSeF — oficjalne informacje i dokumentacja: podatki.gov.pl/e-faktura/ksef
• Profil Zaufany — komunikaty i instrukcje: gov.pl: Profil Zaufany
• Downdetector — bieżące zgłoszenia i mapa awarii: downdetector.pl

Korzyść z odwoływania się do tych źródeł: masz potwierdzenie od strony autorytetu (rząd) i społecznego monitoringu (downdetector), co usprawiedliwia opóźnienia i ułatwia eskalacje.

Moje podsumowanie: co naprawdę działa

Gdy słyszę “ksef problem z logowaniem” — najpierw sprawdzam downdetector. Jeśli to awaria, komunikuję i czekam. Jeśli to lokalny błąd, idę krok po kroku przez listę diagnostyczną powyżej. Co działa najlepiej? Mieć alternatywną metodę uwierzytelniania, automatyczne logowanie błędów i prosty szablon do supportu — to ratuje czas i nerwy.

Jeżeli chcesz, mogę przygotować dla twojego zespołu krótką checklistę lub gotowy e‑mail do wsparcia technicznego — napisz, a zrobię to pod wasze potrzeby.