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? [UZUPEŁNIJ-LINK-KONSULTACJI] umów bezpłatną 20-minutową konsultację - przejdziemy po Twoich procesach fakturowania i powiemy wprost, czy wystarczy Ci poziom 1, czy trzeba budować alerty.