Automatyczne dosyłanie faktur do KSeF po awarii systemu

W skrócie: Faktura wystawiona w trybie offline24 musi trafić do KSeF najpóźniej w następnym dniu roboczym. Nikt nie da Ci przypomnienia. Biurko wykrywa niedostępność bramki KSeF, wystawia fakturę w trybie offline z kodami QR, trzyma ją w kolejce i dosyła automatycznie w momencie, w którym system wraca. Bez Twojego kliknięcia, bez duplikatów, z pełnym logiem.

Piątek, 16:40. Wystawiasz ostatnią fakturę w tygodniu, a bramka KSeF przestaje odpowiadać. Faktura jest ważna od momentu wystawienia, klient ją dostanie, ale zegar już tyka: zgodnie z art. 106nda ustawy o VAT dokument z trybu offline24 przesyła się do KSeF niezwłocznie, najpóźniej w następnym dniu roboczym.

W praktyce to znaczy: poniedziałek do 23:59. Chyba że w międzyczasie Ministerstwo Finansów ogłosi awarię i termin się przesunie. Chyba że poniedziałek jest świętem. Chyba że po prostu zapomnisz, bo w poniedziałek rano masz w głowie inne rzeczy niż jedna faktura z piątku.

Zgodnie z obecną ustawą kary z art. 106ni ustawy o VAT obowiązują od 1 stycznia 2027 r. Ministerstwo Finansów zapowiedziało 16 września 2026 r. ich przesunięcie na 1 stycznia 2028 r. — to projekt ustawy, jeszcze nieuchwalony. Przesunięcie dotyczy tylko kar, a nie samego obowiązku korzystania z KSeF. Ten artykuł pokazuje, dlaczego pilnowanie kolejki offline nie powinno być zadaniem człowieka, i jak Biurko rozwiązuje to po swojej stronie.

Termin nie zaczyna biec wtedy, kiedy sobie o nim przypomnisz

Tryby szczególne KSeF mają różne zegary. To jest źródło większości pomyłek, bo w interfejsie wyglądają identycznie, a w ustawie o VAT to cztery osobne przepisy.

Dwie rzeczy, które warto zapamiętać. Po pierwsze, "offline24" nie oznacza 24 godzin zegarowych. Faktura wystawiona w piątek wieczorem ma termin w poniedziałek do końca dnia, a jeśli poniedziałek jest wolny, w kolejny dzień roboczy. Po drugie, przy niedostępności i awarii termin liczy się od zakończenia przerwy ogłoszonego przez MF, a nie od daty wystawienia faktury. Jeśli przerwa trwała trzy dni i wystawiłeś w tym czasie 60 faktur, wszystkie mają jeden wspólny deadline.

Człowiek nie jest dobrym mechanizmem do liczenia takich terminów. Cron jest.

Biurko wykrywa niedostępność, zanim zdążysz się zorientować

Aplikacja nie czeka, aż klikniesz "wyślij" i zobaczysz błąd. Każde odwołanie do bramki KSeF jest obserwowane. Kiedy w ciągu 60 sekund bramka zwróci trzy błędy, Biurko kieruje nowe wysyłki w tym środowisku do trybu offline24. Dodatkowo co 5 minut czyta komunikaty MF o niedostępności, awarii i awarii całkowitej (źródło „Latarnia”) i na tej podstawie dobiera tryb oraz termin dosłania.

Próg jest celowo tolerancyjny. Jeden błąd 5xx nie może wywrócić trybu pracy całej firmy, bo bramka KSeF potrafi zwrócić losowy timeout i wrócić do normy sekundę później. Dopiero powtarzalność jest sygnałem.

Detekcja działa osobno dla każdego środowiska. Awaria produkcji nie zatrzymuje demo, a problemy na demo nie blokują realnych faktur.

Osobno obsługiwany jest rate limiting. KSeF potrafi odesłać nagłówek Retry-After z wartością liczoną w tysiącach sekund, co w praktyce zamroziłoby Twój kreator faktur na kilkadziesiąt minut, mimo że bramka wraca do życia po chwili. Biurko przycina taki czas do rozsądnego maksimum i próbuje ponownie.

Faktura offline jest pełnoprawnym dokumentem od pierwszej sekundy

Przełączenie w tryb offline nie oznacza, że faktura "czeka". Jest wystawiona, ma datę z pola P_1 struktury FA(3) i klient może ją dostać natychmiast.

Biurko generuje w tym momencie:

• XML w strukturze FA(3),

• KOD I — kod QR z linkiem do weryfikacji w KSeF (NIP sprzedawcy, data wystawienia i skrót SHA-256 pliku faktury; bez numeru faktury i kwot), podpisany „OFFLINE”,

• KOD II (podpis „CERTYFIKAT”) — drugi kod QR, potwierdzający tożsamość wystawcy; powstaje tylko wtedy, gdy firma ma certyfikat KSeF typu Offline,

• PDF z widocznym blokiem offline i terminem dosłania.

Taki zestaw kodów przewiduje MF przy udostępnianiu faktury nabywcy poza KSeF. Kontrahent zagraniczny, konsument albo podmiot bez NIP dostaje dokument z kodami QR; weryfikacja faktury po KOD I jest możliwa w KSeF po jej przesłaniu.

Po powrocie KSeF kolejka rusza sama

Tu jest sedno. Kiedy środowisko wraca do normy, Biurko co 5 minut przegląda transmisje oczekujące w trybie offline i wypuszcza je do wysyłki.

Mechanizm pilnuje czterech rzeczy:

1. Tylko własne środowisko. Transmisja z produkcji nie zostanie wypchnięta, dopóki to produkcja nie wróci. Rekordy z innych środowisk płyną dalej.

2. Zero duplikatów. Każda transmisja jest przejmowana pod blokadą wiersza i oznaczana znacznikiem czasu. Nawet jeśli kolejka jest zatkana i przetwarza zaległości, ta sama faktura nie poleci do KSeF dwa razy.

3. Termin. Rekordy, którym minął ustawowy termin, nie są dosyłane automatycznie. Biurko oznacza je statusem „Wymaga przeglądu” i wysyła powiadomienie — o dalszym kroku decydujesz Ty. Przed upływem terminu Biurko nie ostrzega.

4. Oryginalne oznaczenie. Faktura dosłana po powrocie systemu nadal nosi kod offline, z którym trafiła do klienta. Ten sam dokument, ten sam kod QR, dodany numer KSeF.

Po udanej wysyłce Biurko pobiera UPO i wysyła powiadomienie. Jeśli KSeF odrzuci fakturę, dostajesz błąd przetłumaczony na ludzki język, a nie surowy kod z dokumentacji API.

Czego Biurko za Ciebie nie zrobi

Uczciwie, bo to jest sekcja, którą większość dostawców pomija.

• Drugi kod QR wymaga certyfikatu KSeF typu Offline. To osobny certyfikat od tego, którym logujesz się do KSeF (Uwierzytelniającego) — Biurko potrafi zamówić w MF oba. Bez certyfikatu Offline Biurko wystawi fakturę offline z jednym kodem (KOD I) i ostrzeżeniem; faktura offline przekazywana nabywcy poza KSeF powinna nieść oba kody. Zamów certyfikat, zanim będzie potrzebny.

• Awaria całkowita to inna procedura. Ogłasza ją minister finansów w środkach społecznego przekazu i faktur z tego okresu do KSeF się nie dosyła. Automat tu nie pomoże, bo nie ma czego dosyłać.

• Korekta wymaga numeru KSeF oryginału. Jeśli faktura pierwotna wisi w kolejce offline, najpierw musi dostać numer KSeF, dopiero potem wystawiasz korektę. Tego przepisu nie obejdzie żaden program.

• Automat nie naprawi błędnych danych. Jeśli NIP nabywcy jest zły, faktura wróci z odrzuceniem niezależnie od tego, kto ją wysłał i kiedy.

Scenariusz z życia

Marta prowadzi małą firmę projektową pod Katowicami i ma w Biurko certyfikat KSeF typu Offline. W czwartek o 15:20 bramka KSeF zaczyna zwracać timeouty. Marta tego nie zauważa, bo akurat rozmawia z klientem.

Biurko wykrywa serię błędów i kieruje nowe wysyłki do trybu offline24. Kolejne 14 faktur wystawionych tego popołudnia dostaje dwa kody QR i wychodzi do klientów mailem jako PDF z terminem przesłania do KSeF. W panelu czekają w statusie „Oczekuje wysyłki”.

O 18:05 KSeF wraca. Marta jest już w domu. Kolejka rusza sama, faktury dostają numery KSeF, UPO ląduje przy każdym dokumencie. W piątek rano Marta widzi w panelu 14 zielonych statusów i jedno powiadomienie: jedna faktura odrzucona, powód to nieaktywny NIP kontrahenta. Poprawia jeden dokument zamiast pilnować czternastu.

Checklista: co zrobić, zanim KSeF padnie

1. Zamów certyfikat KSeF typu Offline i sprawdź datę jego ważności. Bez niego faktura offline będzie miała tylko jeden kod QR.

2. Sprawdź, czy Twój system sam wykrywa niedostępność, czy czeka, aż klikniesz "wyślij" i zobaczysz błąd.

3. Ustal z kontrahentami kanał przekazywania faktur offline, żeby nie było sporu o datę otrzymania.

4. Upewnij się, że wizualizacja PDF zawiera oba kody QR, a nie tylko jeden.

5. Sprawdź, czy dosyłka po powrocie systemu jest automatyczna, i czy istnieje zabezpieczenie przed wysłaniem tej samej faktury dwa razy.

6. Zapamiętaj różnicę: offline24 i niedostępność to następny dzień roboczy, awaria to 7 dni roboczych.

7. Włącz powiadomienia o zakolejkowaniu faktury offline i o odrzuceniu przez KSeF.

Podsumowanie

Tryby offline nie są funkcją premium ani ciekawostką dla zaawansowanych. Są normalnym elementem pracy z systemem, który czasem nie odpowiada. Różnica polega na tym, czy po awarii siadasz do listy faktur i odhaczasz je ręcznie, licząc dni robocze, czy po prostu widzisz, że wszystko poszło.

Biurko traktuje kolejkę offline jak infrastrukturę, a nie jak Twoje zadanie do zrobienia. Wykrywa, kolejkuje, dosyła, pobiera UPO i mówi Ci tylko wtedy, gdy naprawdę trzeba coś zrobić.

Załóż konto w Biurko — każda nowa firma dostaje 14 dni planu TEAM bez karty, potem przechodzi na bezpłatny plan FREE. Do ćwiczeń bez skutków prawnych użyj demo Biurko (demo.biurko.io, dostęp na 7 dni, środowisko demonstracyjne KSeF). Konto na app.biurko.io wysyła faktury do produkcyjnego KSeF — każda wysłana faktura jest prawdziwa.

FAQ

Ile mam czasu na wysłanie faktury do KSeF w trybie offline24? Niezwłocznie, najpóźniej w następnym dniu roboczym po dniu wystawienia (art. 106nda ustawy o VAT). Skrót "offline24" nie oznacza 24 godzin zegarowych. Faktura z piątku ma termin w poniedziałek do końca dnia, o ile poniedziałek jest dniem roboczym.

Czy program może sam dosłać fakturę po powrocie KSeF? Tak i tak powinien działać. Biurko co 5 minut sprawdza zakolejkowane faktury i wypuszcza je automatycznie, gdy bramka działa, osobno dla każdego środowiska, z blokadą chroniącą przed podwójną wysyłką.

Co, jeśli w trakcie terminu offline24 MF ogłosi awarię? Wtedy stosuje się termin właściwy dla trybu awaryjnego, czyli 7 dni roboczych od zakończenia awarii. Ogłoszenia publikowane są w BIP Ministerstwa Finansów i w oprogramowaniu interfejsowym KSeF.

Czy do trybu offline potrzebuję certyfikatu KSeF? Do samego wystawienia faktury offline nie, ale drugi kod QR (KOD II, potwierdzający tożsamość wystawcy) powstaje tylko z certyfikatem KSeF typu Offline. To osobny certyfikat od certyfikatu do logowania (Uwierzytelniającego); Biurko może zamówić w MF jeden i drugi. Bez certyfikatu Offline Biurko wystawi fakturę z jednym kodem (KOD I) i ostrzeżeniem.

Co grozi za przekroczenie terminu dosłania faktury? Zgodnie z obecną ustawą kary z art. 106ni ustawy o VAT obowiązują od 1 stycznia 2027 r.; Ministerstwo Finansów zapowiedziało 16 września 2026 r. ich przesunięcie na 1 stycznia 2028 r. — to projekt ustawy, jeszcze nieuchwalony. Obowiązek przesłania faktury istnieje niezależnie od kar. Szczegóły: podatki.gov.pl.