Po co komu offline24 - kiedy system ratuje fakturę
Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia
Tryb offline24 stanowi rozwiązanie systemowe dla przedsiębiorców, którzy napotykają na bariery techniczne uniemożliwiające natychmiastową komunikację z API KSeF. Scenariusze takie jak awaria lokalnego dostawcy usług internetowych (ISP), praca w lokalizacjach o słabym zasięgu sieci komórkowej czy planowana przerwa serwisowa po stronie Ministerstwa Finansów nie blokują możliwości dokumentowania sprzedaży. Faktura wystawiona w tym modelu jest pełnoprawnym dokumentem księgowym od daty wskazanej w polu P_1 struktury FA(3). Faktura zachowuje datę wystawienia z pola DataWystawienia, co pozwala na zachowanie chronologii dokumentacji niezależnie od momentu faktycznego przesłania pakietu danych do infrastruktury rządowej.
Zasada działania trybu offline24 opiera się na elastyczności, jednak nakłada na podatnika konkretne obowiązki dokumentacyjne. Przedsiębiorca wystawiający fakturę bez dostępu do sieci musi dysponować oprogramowaniem księgowym zgodnym z aktualną strukturą logiczną e-faktury. W momencie wystawienia dokumentu, system generuje dwa kody QR: pierwszy oznaczony jako "OFFLINE" oraz drugi jako "CERTYFIKAT". Dokument ten musi zostać udostępniony nabywcy w sposób z nim uzgodniony, co najczęściej odbywa się poprzez wysłanie pliku PDF o maksymalnym rozmiarze 10 MB. Należy zaznaczyć, że tryb offline24 działa bez konieczności ogłaszania komunikatu o awarii przez Ministerstwo Finansów, co odróżnia go od procedur awaryjnych.
Kluczowym aspektem jest rygorystyczne przestrzeganie terminów przesyłu danych do systemu centralnego. Termin przesłania faktury do KSeF w trybie offline upływa najpóźniej w następnym dniu roboczym po dniu jej wystawienia, co oznacza czas na automatyczną wysyłkę aż do godziny 23:59 następnego dnia roboczego. Przykładowo, jeśli faktura zostanie wystawiona 15 marca o godzinie 22:00 (czwartek), ostateczny termin na nadanie numeru KSeF upływa 16 marca o 23:59. Brak przesłania dokumentu w tym terminie skutkuje utratą statusu faktury ustrukturyzowanej oraz ryzykiem nałożenia sankcji administracyjnej w wysokości 0,05% wartości faktury, zgodnie z obowiązującymi przepisami karno-skarbowymi.
Wdrożenie trybu offline24 wymaga opracowania wewnętrznych instrukcji operacyjnych w przedsiębiorstwie. Procedura powinna precyzyjnie określać osobę odpowiedzialną za włączenie trybu offline w programie fakturującym oraz weryfikację statusu synchronizacji. Statystyki wskazują, że 96% klientów pobiera faktury w formacie PDF, a jedynie 12% decyduje się na ich wydruk, co podkreśla dominację obrotu cyfrowego. Przedsiębiorca powinien każdorazowo sprawdzić status przesłania przed zamknięciem miesiąca rozliczeniowego, aby uniknąć błędów w deklaracjach JPK_V7M.
Certyfikat i oprogramowanie - minimalny zestaw startowy
Podstawowym warunkiem technicznym umożliwiającym korzystanie z trybu offline24 jest posiadanie aktywnego Certyfikatu KSeF. Jest to certyfikat typu 2, który zawiera klucz prywatny o długości 2048 bitów, co zapewnia wysoki poziom bezpieczeństwa kryptograficznego dokumentów. Aby wygenerować drugi kod QR (oznaczony jako "CERTYFIKAT"), konieczne jest pobranie i zainstalowanie tego certyfikatu w lokalnym systemie finansowo-księgowym. Bez aktywnego certyfikatu KSeF, kod QR potwierdzający autentyczność dokumentu nie zostanie poprawnie wygenerowany, co uniemożliwi legalne wystawienie faktury w trybie offline.
Proces pozyskiwania narzędzi niezbędnych do pracy offline jest wieloetapowy i wymaga uwierzytelnienia tożsamości podatnika. Pierwszym krokiem jest logowanie do Modułu Certyfikatów i Uprawnień (MCU) przy użyciu podpisu kwalifikowanego lub Profilu Zaufanego. Następnie należy złożyć wniosek o wydanie certyfikatu na stronach Biuletynu Informacji Publicznej Ministerstwa Finansów. Certyfikaty te są dostępne dla przedsiębiorców od 1 listopada 2025 r. i zachowują ważność przez okres 24 miesięcy. Po wygenerowaniu certyfikatu, musi on zostać zaimplementowany w oprogramowaniu księgowym, które obsługuje komunikację z adresem API KSeF.
Oprogramowanie fakturujące musi być w pełni zgodne ze schematem XML FA(3), aby poprawnie obsługiwać parametry trybu offline. Program przy generowaniu dokumentu musi stworzyć plik kontrolny o rozszerzeniu .ksef oraz zaopatrzyć wizualizację faktury w dwa obrazy o rozmiarze 300×300 px (tworzone np. przez bibliotekę qrcode-python 7.4). Prawidłowa struktura XML wymaga precyzyjnego wypełnienia pól; przykładowo, w sekcji stawek podatkowych, pole GTU_01 musi pozostać puste, jeżeli dany towar nie podlega pod tę kategorię klasyfikacji towarowo-usługowej. Niepoprawny plik XML zostanie odrzucony przez bramkę API Ministerstwa Finansów z błędem walidacji logicznej.
Wybór oprogramowania powinien być podyktowany obecnością funkcji automatycznego przełączania się w tryb offline24 w przypadku wykrycia timeoutu bazy danych KSeF (następującego po 30 sekundach braku odpowiedzi). Zaleca się, aby każdy podatnik wcześniej przetestował scenariusz awaryjny w środowisku testowym udostępnionym przez resort finansów. Lista zgodnych programów jest publikowana co kwartał na stronie gov.pl/ksef, co pozwala przedsiębiorcom na wybór sprawdzonych rozwiązań IT. Przedsiębiorca będzie musiał korzystać z oprogramowania zgodnego z KSeF, umożliwiającego generowanie faktur offline w odpowiednim formacie.
- Pobranie Certyfikatu KSeF typu 2 do generowania drugiego kodu QR
- Weryfikacja zgodności oprogramowania ze strukturą logiczną FA(3)
- Instalacja podpisu kwalifikowanego do autoryzacji sesji
- Zapewnienie stabilnego modułu do generowania kodów QR o rozmiarze 300×300 px
Procedura wystawiania - checklista dla zespołu
Wdrożenie trybu offline24 wymaga ścisłej współpracy między sprzedawcą, działem księgowości a działem IT. W momencie wystąpienia braku łączności, sprzedawca zaznacza w systemie opcję "offline24", wypełnia wszystkie wymagane pola faktury i zapisuje wygenerowany plik XML na lokalnym dysku lub serwerze firmowym. Dokument w tym stanie posiada blokadę edycji danych przesyłanych do ministerstwa, co ma zapobiec rozbieżnościom między kopią udostępnioną nabywcy a dokumentem, który trafi do bazy KSeF. Faktura wystawiana w trybie offline24 jest otrzymywana przez nabywcę przy użyciu KSeF dopiero po jej późniejszej synchronizacji przez wystawcę.
Kolejnym etapem jest proces synchronizacji, który powinien nastąpić niezwłocznie po przywróceniu dostępu do internetu. Księgowa lub system automatyczny (uruchamiany np. przez cron o godzinie 02:00 w dni robocze) przesyła pliki XML zgromadzone w kolejce "DoWyslania" do centralnego repozytorium. System KSeF po otrzymaniu dokumentu przydziela mu unikalny numer identyfikujący, a data tego przydzielenia staje się oficjalną datą otrzymania faktury przez nabywcę (art. 106gb ust. 4 ustawy). Dokumentem kończącym procedurę jest Urzędowe Poświadczenie Odbioru (UPO), które program powinien zapisać i zarchiwizować jako dowód nadania.
Warto zwrócić uwagę, że UPO jest jedynym prawnym potwierdzeniem, iż faktura ustrukturyzowana została skutecznie wprowadzona do obrotu prawnego. Brak UPO oznacza, że faktura nie istnieje w systemie centralnym, co może narazić przedsiębiorcę na dotkliwe sankcje finansowe. W przypadku awarii trwającej dłużej niż przewiduje tryb offline24, termin na przesłanie faktur wynosi 7 dni roboczych od dnia zakończenia awarii ogłoszonej przez MF. Firmy powinny dążyć do zachowania wewnętrznego SLA, zakładającego upload plików do godziny 10:00 każdego dnia roboczego następującego po dniu wystawienia faktury.
| Rola | Zadanie | Deadline |
|---|---|---|
| Sprzedawca | Wystawienie faktury w trybie offline24 i nadanie kodów QR | Moment sprzedaży |
| Księgowa | Upload plików XML do KSeF oraz weryfikacja i zapis UPO | Do 10:00 nast. dnia roboczego |
| IT | Monitorowanie stabilności API i backup plików XML | Codziennie godz. 18:00 |
Najczęstsze błędy i jak ich unikać
Jednym z najpoważniejszych błędów podczas pracy w trybie offline24 jest niedotrzymanie 24-godzinnego terminu przesłania dokumentu do KSeF. Jeśli termin ten zostanie przekroczony, faktura traci status dokumentu ustrukturyzowanego i nie może zostać uznana za poprawnie wystawioną w tym trybie. W takiej sytuacji należy unieważnić dokument własnym dokumentem korygującym w systemie wewnętrznym i wystawić nową e-fakturę z prawidłowym oznaczeniem i aktualną datą. Należy pamiętać, że termin 24 h liczy się w dniach roboczych; dokument wystawiony w piątek wieczorem musi zostać przesłany najpóźniej do poniedziałku do godziny 23:59.
Podczas próby synchronizacji danych z KSeF, użytkownicy mogą napotkać błędy techniczne zwracane przez serwer Ministerstwa Finansów. Najczęstszym komunikatem jest "Kod 400", który sygnalizuje, że struktura XML jest nieprawidłowa lub pole DataWystawienia zawiera datę późniejszą niż aktualna data systemowa (tzw. fakturowanie z przyszłością). Błąd "Kod 401" wskazuje na brak lub wygaśnięcie Certyfikatu KSeF, co blokuje dostęp do API. W przypadku wystąpienia błędu logicznego "Kod 422", należy sprawdzić spójność danych merytorycznych faktury przed ponowieniem próby wysyłki.
Innym istotnym problemem jest nieprawidłowe generowanie kodów QR na wizualizacji PDF faktury. Skaner mobilny udostępniony przez Ministerstwo Finansów rozpoznaje wyłącznie kody o strukturze "OFFLINE" i "CERT". Użycie nieprawidłowych parametrów przy generowaniu obrazu QR spowoduje odrzucenie weryfikacji dokumentu przez nabywcę. Czas sprawdzania poprawności kodu QR wynosi zazwyczaj 3 sekundy, a ewentualne opóźnienia mogą wynikać z niskiej rozdzielczości obrazu. Aby uniknąć bounce'ów i reklamacji od kontrahentów, należy każdorazowo weryfikować poprawność adresu e-mail odbiorcy przed wysyłką dokumentu z kodami QR.
Czy mogę wysłać fakturę offline24 w sobotę?
Czy UPO jest potwierdzeniem VAT?
Regularne audyty wewnętrzne są najlepszym sposobem na minimalizację ryzyka. Zaleca się generowanie cotygodniowych raportów zbiorczych sprawdzających, czy każda faktura wystawiona w trybie offline posiada przypisany numer KSeF oraz odpowiadający jej plik UPO. W przypadku braku synchronizacji faktury z przyczyn technicznych, system powinien ponawiać próbę wysyłki co godzinę aż do skutku. Każdy podatnik powinien również przeszkolić zespół sprzedaży w zakresie obsługi komunikatów błędów, aby wiedzieli, jak reagować w sytuacjach kryzysowych.
Redakcja · wszystkie artykuły