Powrót do bazy wiedzy

Jak sprawdzić obsługę trybów offline w systemie

8 stycznia 2026Strefa KSeF
instrukcjekrok po kroku

Jak sprawdzić obsługę trybów offline w systemie

Tryby offline to mechanizmy awaryjne pozwalające wystawiać faktury gdy KSeF jest niedostępny: brak internetu, prace serwisowe, awaria systemu. Istnieją 3 tryby: offline24 (do 24h), offline-niedostępność (planowane prace), offline-awaria (powyżej 24h). WSZYSTKIE tryby wymagają certyfikatu typu 2 i generują DWA kody QR. Brak obsługi trybów offline = firma nie może wystawiać faktur podczas przerwy w dostępie KSeF!


Kroki do wykonania

1. Sprawdź obsługę trybu offline24 (brak łączności)

Tryb offline24 używasz gdy KSeF jest chwilowo niedostępny (brak internetu, awaria do 24h). Sprawdź:

  1. Czy w systemie jest przełącznik 'Tryb offline' lub system automatycznie wykrywa brak połączenia
  2. Czy w ustawieniach jest informacja o wymaganiu certyfikatu typu 2
  3. Wystaw fakturę testową w trybie offline - system powinien: oznaczyć ją jako 'offline24', nadać tymczasowy ID wewnętrzny (nie ma jeszcze numeru KSeF), zapisać w kolejce do późniejszego dosłania
  4. Sprawdź wizualizację PDF - MUSZĄ być DWA kody QR (weryfikujący + certyfikatu).

Jeśli widzisz tylko jeden kod QR lub system nie pozwala wystąpić faktury offline - to BRAK WSPARCIA dla trybu offline24.

2. Sprawdź obsługę trybu offline-niedostępność (prace serwisowe)

Tryb offline-niedostępność używasz podczas planowanych prac serwisowych KSeF (ogłaszanych wcześniej przez MF). Sprawdź:

  1. Czy system ma osobną opcję 'Niedostępność KSeF' lub czy offline24 działa tak samo
  2. Czy system pokazuje komunikaty MF o planowanych pracach (jeśli są integrowane z API powiadomień)
  3. Wystaw fakturę w tym trybie - proces powinien być identyczny jak offline24 (tymczasowy ID, dwa kody QR, kolejka do dosłania)
  4. Termin dosłania: według komunikatu MF (zazwyczaj do kilku godzin po zakończeniu prac).

Faktury niedosłane w terminie mogą być odrzucone!

3. Sprawdź obsługę trybu offline-awaria (awaria całkowita)

Tryb offline-awaria używasz gdy KSeF jest całkowicie niedostępny przez ponad 24h (ogłoszona awaria systemu). Sprawdź:

  1. Czy system ma opcję 'Tryb awaryjny' lub 'Awaria KSeF'
  2. Wystaw fakturę w trybie awaryjnym - powinna być oznaczona jako 'offline-awaria'
  3. Termin dosłania: do 7 dni roboczych od zakończenia awarii (dłuższy niż offline24)
  4. System powinien ostrzegać o zbliżającym się deadline (np. 'Zostały 3 dni do dosłania 15 faktur offline').

Brak obsługi trybu awaryjnego = firma nie może działać podczas długotrwałej awarii KSeF!

4. Sprawdź automatyczne dosyłanie faktur offline

Po przywróceniu połączenia z KSeF, system MUSI automatycznie dosłać wszystkie faktury offline. Sprawdź:

  1. Wystaw kilka faktur offline (3-5 testowych)
  2. Przełącz system z powrotem w tryb online (lub symuluj przywrócenie połączenia)
  3. System powinien: wykryć faktury oczekujące w kolejce, automatycznie rozpocząć dosyłanie (bez Twojej interwencji), pokazać status dosyłania ('Wysyłanie 1 z 5...')
  4. Po dosłaniu każda faktura powinna otrzymać: oficjalny numer KSeF, UPO od MF, status 'Zaakceptowana'
  5. Sprawdź logi - wszystkie faktury powinny być dosłane i potwierdzone.

Jeśli musisz RĘCZNIE dosyłać faktury offline - to OGROMNY PROBLEM wydajnościowy!

5. Sprawdź wymaganie certyfikatu typu 2

WSZYSTKIE tryby offline wymagają certyfikatu KSeF typu 2 (certyfikat typu 1 NIE działa w trybie offline!). Sprawdź:

  1. Czy system informuje o wymaganiu certyfikatu typu 2 w ustawieniach offline
  2. Czy możesz zaimportować certyfikat typu 2 (plik .p12 lub .pem)
  3. Spróbuj wystąpić fakturę offline BEZ certyfikatu typu 2 - system powinien ZABLOKOWAĆ i pokazać błąd 'Wymagany certyfikat typu 2 do trybu offline'
  4. Po zaimportowaniu certyfikatu typu 2 - faktury offline powinny być podpisywane tym certyfikatem.

Certyfikat typu 2 generujesz w MCU (mcu.mf.gov.pl). Jeśli system akceptuje tryb offline bez certyfikatu typu 2 - faktury będą ODRZUCONE przez KSeF!

6. Test integracyjny: Pełny cykl faktury offline

Finalny test pełnego cyklu offline:

  1. Zaimportuj certyfikat typu 2 do systemu (jeśli nie masz testowego - wygeneruj w środowisku demo MCU)
  2. Przełącz system w tryb offline24
  3. Wystaw fakturę testową - sprawdź: czy ma status 'offline24', czy jest w kolejce do dosłania, czy ma tymczasowy ID
  4. Wygeneruj PDF faktury - MUSZĄ być DWA kody QR (zeskanuj oba telefonem i sprawdź)
  5. Przełącz system z powrotem online
  6. System powinien automatycznie dosłać fakturę w ciągu kilku sekund
  7. Po dosłaniu faktura powinna mieć: numer KSeF (zamiast tymczasowego ID), UPO, status 'Zaakceptowana'.

Jeśli wszystkie kroki przeszły bez problemów - tryb offline działa!

7. Weryfikacja zgodności z wymaganiami

Checklist weryfikacyjny: ✓ Obsługa trybu offline24 (do 24h)? ✓ Obsługa trybu offline-niedostępność (prace serwisowe)? ✓ Obsługa trybu offline-awaria (awaria powyżej 24h)? ✓ Wymaganie certyfikatu typu 2 (blokada bez niego)? ✓ Generowanie DWÓCH kodów QR (weryfikujący + certyfikatu)? ✓ Automatyczne dosyłanie po przywróceniu online? ✓ Ostrzeżenia o zbliżającym się deadline dosłania? ✓ Monitoring kolejki faktur offline? Jeśli wszystkie punkty są ✓ - system obsługuje tryby offline. Jeśli KTÓRYKOLWIEK punkt jest ✗ - to KRYTYCZNY BRAK. Tryby offline to funkcja OBOWIĄZKOWA, nie opcjonalna - firma musi móc działać podczas awarii KSeF!


Powiązane pojęcia