Brak internetu a wystawienie faktury: Przewodnik po trybie offline24 i kodach QR

Tryb offline24 KSeF – kiedy, dlaczego i jak go uruchomić bez dostępu do internetu

Tryb offline24 KSeF uruchamiasz, gdy router traci łączność, a musisz wystawić fakturę. Decyzja zależy od jakości sieci, nie od urzędu. Podatnik musi posiadać certyfikat KSeF typu 2. Brak tego pliku uniemożliwia wygenerowanie drugiego kodu QR. Na przykład sklep internetowy wysyła paczkę 30 listopada. System nie łączy się z KSeF. Właściciel uruchamia tryb offline, bo musi doręczyć dokument kupującemu tego samego dnia.

Wystawianie faktury bez internetu wymaga czterech kroków. Po pierwsze, otwórz program ERP w wersji 2.0. Po drugie, wybierz opcję „offline24” z menu. Po trzecie, podpisz XML certyfikatem typu 2. Po czwarte, zapisz pliki: PDF z kodami i XML do późniejszego dosłania. Na przykład w PrestaShop wtyczka sama proponuje przełączenie po 5-sekundowym timeout. Każdy podatnik powinien wcześniej przetestować scenariusz awaryjny.

KSeF brak łączności nie zwalnia z terminów. Fakturę offline24 przesyłasz następnego dnia roboczego. Gdy wystąpi całkowita awaria, masz 7 dni roboczych. Jeśli ogłoszono stan klęski żywiołowej, obowiązku dosłania nie masz. Podatnik może więc wybrać tryb, ale czasomierz tyka nieustannie.

Faktura ustrukturyzowana offline wymaga korekty, gdy zapiszesz ją w złym trybie. Urząd naliczy odsetki 8% za każdy dzień zwłoki. Na przykład firma B2B zapomniała dosłać XML do KSeF. Musi wysłać korektę VAT i zapłacić 120 zł odsetek. Każdy podatnik powinien sprawdzić status przesłania przed zamknięciem miesiąca.

• Kody QR offline pojawiają się podczas generowania faktury bez sieci.
• Router traci łączność – ERP automatycznie proponuje tryb offline24.
• Certyfikat typu 2 blokuje dostęp, gdy wygasł.
• Baza danych KSeF zwraca błąd timeout po 30 sekundach.
• Klient oczekuje PDF-a, więc fakturę wystawiasz natychmiast.
• System archiwizacji zapisuje XML z datą wystawienia.

Tryb	Termin przesłania	Kod QR
offline24	Następny dzień rob.	OFFLINE + CERTYFIKAT
offline-niedostępność	1 dzień po przerwie	OFFLINE + CERTYFIKAT
awaryjny	7 dni rob. po awarii	OFFLINE + CERTYFIKAT
całkowita awaria	Brak obowiązku	Brak kodu

Reguły mogą się zmienić; sprawdzaj komunikaty Ministerstwa Finansów.

Liczba godzin przestojów KSeF w pierwszych miesiącach 2025

Dwukodowy QR na fakturze offline – budowa, znaczenie i weryfikacja autentyczności

Dwa kody QR na fakturze zawierają cztery elementy: adres API, datę wystawienia, NIP sprzedawcy i wyróżnik. Kod OFFLINE umieszczasz pod adresem https://api.ksef.gov.pl/verify. Data pochodzi z pola P_1 struktury FA(3). NIP identyfikuje podatnika. Wyróżnik to skrót SHA-256 pliku XML. Podatnik musi upewnić się, że każdy element się zgadza.

Certyfikat KSeF typu 2 zawiera klucz prywatny 2048 bitów. Podpis elektroniczny tworzy się algorytmem RSA-SHA256. Oszust bez certyfikatu nie wygeneruje poprawnego kodu CERTYFIKAT. Na przykład fałszerz podmienia NIP na fakturze. Drugi kod QR nie przejdzie weryfikacji, bo brak aktywnego certyfikatu. Każdy wystawca powinien chronić plik .pfx hasłem.

Sprawdzenie faktury QR trwa 3 sekundy. Krok 1: Skanujesz kod OFFLINE telefonem. Krok 2: Porównujesz datę i kwotę z PDF-em. Krok 3: Klikasz „Pobierz XML” w KSeF. Na przykład klient widzi rozbieżność w VAT. Może zgłosić nieprawidłowość przez formularz MF. Nabywca powinien zapisać zrzut ekranu jako dowód.

Podrabianie faktur KSeF jest prostsze, niż myślisz. Fałszywy kod QR działa, gdy pochodzi z innej faktury. System nie sprawdza integralności treści, tylko tożsamość wystawcy. Eksperci ostrzegają: „Kodem QR można opatrzyć dowolną fakturę – oszust wklei go do fałszywego PDF-a” – Piotr Kępisty. Dlatego zawsze porównuj numery NIP i kwoty ręcznie.

• Brak kodu CERTYFIKAT oznacza brak podpisu.
• Fałszywy certyfikat oznacza oszustwo.
• Nieznany wyróżnik wskazuje na manipulację.
• Inny adres API sugeruje próbę phishingu.
• Zerowy rozmiar pliku .pfx uniemożliwia weryfikację.

Element	Kod OFFLINE	Kod CERTYFIKAT
Adres API	Tak	Tak
Data	Tak	Tak
NIP	Tak	Tak
Wyróżnik	Tak	Tak
Podpis	Nie	Tak

Specyfikacja API KSeF 2.0 może ulec zmianie; śledź komunikaty.

Wykryte podejrzane faktury KSeF w kwartałach 2025

Fakturowanie offline w e-commerce – praktyczny scenariusz dla sklepu internetowego

Fakturowanie offline e-commerce uruchamia webhook. Timeout 5 s wystarczy, by system oznaczył KSeF jako niedostępny. ERP przełącza się automatycznie w tryb offline24. Na przykład platforma PrestaShop wysyła żądanie POST na adres /invoice/offline. Sklep zapisuje zamówienie 30 listopada. Klient opłaca je kartą. System generuje fakturę bez czekania na KSeF.

Wystawianie faktury PDF z kodem QR trwa 180 ms. Biblioteka qrcode-python 7.4 tworzy obrazki 300×300 px. Pseudokod SQL zapisuje dane:

INSERT INTO invoice (order_id, xml, qr_offline, qr_cert)
VALUES (12345, :xml, :qr1, :qr2);

Na przykład cron o 02:00 pobiera rekordy z flagą pending. System dołącza PDF-a 500 kB do e-maila. Każdy sklep powinien testować wersję PDF na telefonie klienta.

Faktura dla konsumenta KSeF wymaga trzech danych: e-mail, język, waluta. Klient z Niemiec otrzymuje PDF po angielsku. Kwota wyświetla się w EUR zgodnie z UE. Na przykład konsument klika „Pobierz fakturę” w panelu sklepu. System wysyła mu link z kodem OFFLINE. Nabywca może zapisać dokument w aplikacji mobilnej.

XML faktury offline24 archiwizujesz do późniejszego dosłania. Cron uruchamia się o 02:00 w dni robocze. Skrypt wysyła pliki po 50 sztuk w paczce. Na przykład 30 listopada system wysłał 120 XML-i. Każdy plik otrzymał numer KSeF przed 09:00. Sklep powinien logować czas przesłania i status odpowiedzi.

1. Sprawdź timeout webhooka – ustaw 5 s.
2. Zweryfikuj certyfikat typu 2 – nie może być expired.
3. Popraw adres e-mail – uniknij bounce.
4. Dodaj załącznik PDF – max 10 MB.
5. Automatyzacja fakturowania offline zapisuje XML w kolejce.
6. Ustaw cron na 02:00 – rano faktury są już w KSeF.
7. Poinformuj klienta – wyślij e-mail z kodami QR.

Parametr	Wartość	Uwaga
URL	/invoice/offline	endpoint REST
timeout	5 s	czas oczekiwania
retry	3×	liczba prób
cert	TLS 1.3	szyfrowanie
header	Authorization	token JWT

HTTPS jest wymagany; inaczej dane trafiają w czystym tekście.

Konwersja koszyka – offline24 vs online KSeF, procent