lang: pl category: Biurko — produkt tags: [KSeF, tryb offline24, awaria KSeF, automatyzacja, faktury] funnel: MOFU
SEO METADATA
Meta title: Automatyczne dosyłanie faktur do KSeF po awarii | Biurko
Meta description: KSeF padł, a termin biegnie. Biurko wykrywa awarię, kolejkuje faktury offline24 i dosyła je automatycznie po powrocie systemu. Sprawdź, jak to działa.
URL slug: automatyczne-dosylanie-faktur-ksef
Primary keyword: automatyczne dosyłanie faktur do KSeF
Secondary keywords: tryb offline24, awaria KSeF, kolejka faktur offline, termin przesłania faktury do KSeF, KSeF nie działa
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.
Od 1 stycznia 2027 r. za takie potknięcie grozi kara administracyjna. 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 trzy osobne przepisy.
Tryb Kiedy Termin przesłania do KSeF Podstawa offline24 problem po Twojej stronie (brak internetu, KSeF odpowiada zbyt wolno) niezwłocznie, najpóźniej w następnym dniu roboczym po dniu wystawienia art. 106nda offline — niedostępność MF ogłasza niedostępność w BIP najpóźniej w następnym dniu roboczym po zakończeniu niedostępności art. 106nh awaryjny MF ogłasza awarię w BIP 7 dni roboczych od zakończenia awarii art. 106nf awaria całkowita komunikat w środkach społecznego przekazu faktur nie dosyła się do KSeF art. 106nf ust. 4
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 krótkim oknie czasowym powtarza się seria nieudanych odpowiedzi, Biurko przełącza dane środowisko w stan niedostępności.
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 testów, a problemy na demo nie blokują realnych faktur. To brzmi jak szczegół techniczny, ale w biurze rachunkowym obsługującym kilkanaście firm oznacza, że jedna zablokowana sesja nie paraliżuje reszty panelu.
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) z oznaczeniem trybu, w jakim faktura powstała,
kod offline liczony z kanonicznej postaci XML, unikalny dla tego dokumentu,
kod QR z oznaczeniem OFFLINE prowadzący do weryfikacji faktury w bazie KSeF,
kod QR z certyfikatu KSeF typu 2, potwierdzający tożsamość wystawcy,
PDF z widocznym blokiem offline i terminem dosłania.
To jest dokładnie ten zestaw, którego wymaga MF przy udostępnianiu faktury nabywcy poza KSeF. Kontrahent zagraniczny, konsument albo podmiot bez NIP dostaje dokument, który może zweryfikować, zanim jeszcze KSeF nada mu numer.
Po powrocie KSeF kolejka rusza sama
Tu jest sedno. Kiedy środowisko wraca do normy, Biurko cyklicznie przegląda transmisje oczekujące w trybie offline i wypuszcza je do wysyłki.
Mechanizm pilnuje czterech rzeczy:
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.
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.
Termin. Rekordy po upływie ustawowego terminu nie są cicho dosyłane w tle. Trafiają do Ciebie jako sprawa do rozstrzygnięcia, a nie do zamiecenia pod dywan.
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.
Certyfikat KSeF typu 2 musisz mieć wcześniej. Bez niego nie da się wygenerować drugiego kodu QR, a faktura offline bez tego kodu nie spełnia wymogów przy przekazaniu jej nabywcy poza KSeF. Certyfikat pobierasz w Aplikacji Podatnika lub przez API, jest ważny 2 lata. Wyrób go, 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ę. Biurko pilnuje kolejności, ale nie obejdzie przepisu.
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 biuro rachunkowe pod Katowicami, obsługuje 23 firmy. 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 przełącza środowisko produkcyjne w tryb offline. Kolejne 14 faktur wystawionych tego popołudnia dostaje kody offline, kody QR i wychodzi do klientów mailem jako PDF. W panelu pojawia się baner z liczbą dokumentów w kolejce i terminem.
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
Pobierz certyfikat KSeF typu 2 i sprawdź datę jego ważności. To warunek wystawiania faktur offline.
Sprawdź, czy Twój system sam wykrywa niedostępność, czy czeka, aż klikniesz "wyślij" i zobaczysz błąd.
Ustal z kontrahentami kanał przekazywania faktur offline, żeby nie było sporu o datę otrzymania.
Upewnij się, że wizualizacja PDF zawiera oba kody QR, a nie tylko jeden.
Sprawdź, czy dosyłka po powrocie systemu jest automatyczna, i czy istnieje zabezpieczenie przed wysłaniem tej samej faktury dwa razy.
Zapamiętaj różnicę: offline24 i niedostępność to następny dzień roboczy, awaria to 7 dni roboczych.
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 i przetestuj tryb offline24 na środowisku testowym, zanim sprawdzi Cię produkcja. 14 dni za darmo, bez karty.
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 cyklicznie sprawdza dostępność bramki i wypuszcza zakolejkowane faktury automatycznie, 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? Tak. Certyfikat KSeF typu 2 służy do wygenerowania kodu QR potwierdzającego tożsamość wystawcy. Bez niego nie przekażesz nabywcy faktury offline zgodnie z wymogami MF. Certyfikat pobierasz w Aplikacji Podatnika KSeF 2.0 lub przez API, ważny jest 2 lata.
Co grozi za przekroczenie terminu dosłania faktury? Sankcje administracyjne z art. 106ni ustawy o VAT obowiązują od 1 stycznia 2027 r. Do tego czasu trwa okres przejściowy, ale obowiązek przesłania faktury istnieje niezależnie od kar. Szczegóły: podatki.gov.pl.
Linki wewnętrzne do podstawienia: [SLUG-CERTYFIKAT-KSEF-TYP-2], [SLUG-KODY-QR-KSEF], [SLUG-KSEF-TERMINY-2026], [SLUG-BIURO-RACHUNKOWE-PANEL]