Wdrożenie KSeF to nie meta, lecz start utrzymania. System działa online, sesje bywają odrzucane, a w pierwszych tygodniach po starcie produkcyjnym 74% firm zgłosiło błędy operacyjne (raport Grant Thornton cytowany: inforfk.pl, 04.06.2026). Od 2027 r. dochodzą kary administracyjne - do 100% kwoty VAT z faktury poza systemem lub po terminie (art. 106ni; ksiegowosc.infor.pl, 11.06.2026). Poniżej: katalog tego, co trzeba monitorować, trzy poziomy alertów i granica sensownej automatyzacji. Stan prawny sprawdzony 02.09.2026.
Co może się zepsuć: katalog błędów KSeF
| Obszar | Co się dzieje | Skutek, jeśli nie wychwycone |
|---|---|---|
| Sesja wystawiania | Odrzucenie sesji (błąd walidacji FA(3), limit sesji, problem uwierzytelnienia) | Faktura „nie istnieje" - nabywca czeka, termin wystawienia biegnie |
| Faktura kosztowa niepobrana | Dostawca wystawił w KSeF, ale Twój program nie zaciągnął (sesja pobierania padła, NIP nie obejmuje uprawnienia) | Płacisz bez numeru KSeF w tytule (od 2027: problem z art. 108g), okres odliczenia VAT się przesuwa |
| Brak numeru KSeF po wystawieniu | Wysyłka poszła, numer nie wrócił do systemu źródłowego (problem integracji) | Przelew nie może zawrzeć numeru; rozbieżność rejestrów |
| Faktura offline po terminie dosłania | Tryb offline ma twardy termin dosłania; przekroczony = jak faktura poza KSeF | Ryzyko kary z art. 106ni przy kontroli |
| Certyfikat wygasa | Tokeny umierają 31.12.2026, certyfikaty ważne maks. 2 lata (ksef.podatki.gov.pl, 06.02.2026) | Zatrzymanie wystawiania w środku dnia fakturowania |
| Rate-limits API | Limity zapytań per endpoint (sekunda/minuta/godzina; komunikat MF, 13.02.2026) | Integracja "dławi się" przy dużych wolumenach |
| Przerwy techniczne KSeF | System miewa okna niedostępności (np. start produkcyjny 01.02.2026 po przerwie 26-31.01.2026; komunikat techniczny gov.pl/web/kis, sprawdzono 25.08.2026) | Brak reakcji = panika zamiast przełączenia na tryb zapasowy |
Dokładne statusy sesji i kody błędów API KSeF 2.0 - DO POTWIERDZENIA (metoda: dokumentacja techniczna ksef-docs przy API 2.6.x; przegląd przed publikacją tego artykułu).
Cztery alerty, które mają sens w każdej firmie
Wystarczą cztery reguły, które łapią większość realnych awarii:
1. Faktura wysłana, brak numeru KSeF po X minutach
Numer nadaje system przy przyjęciu faktury (art. 108g; taxinsight.pl, 05.03.2026). Jeśli program wystawił fakturę, a numer po np. 30 min nie wrócił do rejestru - coś padło na linii program-KSeF. Alert chroni przed płatnościami bez numeru od 2027 r.
2. Odrzucenie sesji / faktury przy walidacji
Błąd walidacji FA(3) oznacza, że faktura formalnie nie została wystawiona. Alert musi trafić do osoby, która poprawi i wyśle ponownie tego samego dnia - terminy biegną dalej.
3. Faktury kosztowe: nowa pobrana / brak pobrania per NIP
Programy z auto-pobieraniem kosztów robią to cyklicznie (np. wFirma - nocą; wfirma.pl, 25.08.2026). Monitoring powinien raportować dwie rzeczy: nowe faktury dostawców (żeby księgowość wiedziała o kosztach zanim zapłaci) oraz NIP-y, z których nic nie przychodzi mimo że dostawca faktury wystawia. Drugi sygnał to najczęściej problem z uprawnieniem podmiotowym albo sesją pobierania.
4. Wygasające certyfikaty i słabnąca autoryzacja
Tokeny wygasają 31.12.2026 - od stycznia uwierzytelnianie tylko certyfikatami (ksef.podatki.gov.pl, 06.02.2026). Certyfikat ma datę ważności (maks. 2 lata, j.w.): alert 60/30/7 dni przed wygaśnięciem to różnica między planową wymianą a zatrzymaniem fakturowania.
Jak to zbudować: trzy poziomy zaawansowania
Poziom 1: raport codzienny (zero integracji)
Raz dziennie ktoś zagląda do programu: statusy wysyłek, pobrane koszty, ważność certyfikatów. Przy kilku fakturach dziennie to 10 minut. Wady: wykrycie awarii z opóźnieniem do 24 h i zależność od dyscypliny człowieka.
Poziom 2: alerty z programu księgowego
Część programów wystawia zdarzenia o statusach KSeF - np. wFirma ma webhook „zmiana statusu KSeF" (pomoc.wfirma.pl, 04.02.2026). Alert to wtedy kwestia konfiguracji: mail do księgowej przy każdej zmianie statusu na błąd. Poziom „wystarczający" dla większości mikrofirm.
Poziom 3: niezależny monitoring (polling API / middleware)
Niezależny mechanizm odpytuje API KSeF o sesje i statusy (albo zjada webhooki programu) i agreguje reguły: brak numeru >X min, odrzucenia, koszty per NIP, wygasające certyfikaty. API 2.0 ma sesje online i batch z limitami (faktura do 1 MB, do 10 000 faktur na sesję; ksef-docs, komunikat MF 13.02.2026). Budowa i utrzymanie takiego modułu to praca dla integratora.
Jak dokładnie wygląda mechanizm zwiększania limitów API na wniosek - DO POTWIERDZENIA (metoda: komunikat MF „Dostosowanie limitów API", 13.02.2026, i formularz kontaktowy KSeF).
Procedura wdrożenia alertów - krok po kroku
- Zrób mapę fakturowania: gdzie powstaje faktura (program, sklep, marketplace), kto wysyła, kto pobiera koszty, kto płaci. Bez niej alerty wieszają się w próżni.
- Przypisz właściciela alertu: każdy typ alertu ma adresata (księgowa, właściciel, integrator). Alert bez właściciela to powiadomienie, które ktoś skasuje.
- Ustaw progi: brak numeru 30 min vs 4 h to różnica między firmą fakturowaną raz dziennie a sklepem z 200 fakturami. Progi dopasuj do tempa fakturowania.
- Przećwicz awarię na sucho: w grudniu 2026 symulujesz odrzucenie sesji i patrzysz, czy alert doszedł, kto go odebrał i ile trwała reakcja. Test przed 1 stycznia, nie po pierwszej karze.
- Ustal ścieżkę eskalacji: alert zignorowany po 2 h idzie wyżej - jedno zdanie w procedurze wystarczy.
Specyfika: biuro rachunkowe
Biuro monitoruje KSeF za dziesiątki NIP-ów. Trzy rzeczy decydują o skali:
- uprawnienia podmiotowe per klient - bez uprawnienia na NIP klienta biuro nie wystawi ani nie pobierze jego faktur (ksef.podatki.gov.pl, 27.04.2026); monitoring "braku pobrania" złapie brak uprawnienia zanim to zauważy klient,
- alerty per NIP, nie per biuro - jedna awaria pobierania u klienta A nie może zalać skrzynki, ale nie może też ginąć w zbiorczym raporcie,
- limity sesji wsadowych - sesje batch mają limity (do 10 000 faktur; ksef-docs); rozkład wsadu planuj z góry, nie odkrywaj go przy pierwszym odrzuceniu.
Uczciwie: kiedy monitoring to przerost formy
Jeśli wystawiasz 5 faktur miesięcznie, korzystasz z jednego programu i ten program sam pokazuje statusy - wystarczy poziom 1: codzienny rzut oka plus kalendarz z datą ważności certyfikatu. Automatyzacja alertów zaczyna się opłacać, gdy: faktur jest kilkadziesiąt+ miesięcznie, płatności robi biuro (a nie Ty), dochodzą kanały sprzedaży, albo obsługujesz wielu klientów. Wtedy koszt jednej nieodnotowanej awarii przewyższa koszt utrzymania monitoringu.
Chcesz wiedzieć, który poziom pasuje do Twojej firmy? Zobacz monitoring KSeF — umów bezpłatną 20-minutową konsultację - przejdziemy po Twoich procesach fakturowania i powiemy wprost, czy wystarczy Ci poziom 1, czy trzeba budować alerty.