Tryb offline

BizFlow NH automatycznie przechodzi w tryb offline, gdy system KSeF jest niedostępny. Faktury wystawiane w trybie offline zachowują pełną moc prawną dzięki kodom QR podpisanym certyfikatem offline.

Monitorowanie dostępności KSeF

BizFlow NH monitoruje dostępność KSeF poprzez API Latarni — oficjalny serwis Ministerstwa Finansów informujący o stanie systemu.

Możliwe stany:

Stan	Opis	Działanie BizFlow NH
Available	KSeF działa normalnie	Wysyłka online
Maintenance	Planowana przerwa techniczna	Tryb offline
Failure	Awaria	Tryb offline
TotalFailure	Całkowita awaria	Tryb offline

System odpytuje API Latarni co 60 sekund i automatycznie przełącza tryb.

Status Latarni w interfejsie

Aktualny stan Latarni jest widoczny w selektorze firm (CompanySelector) w nagłówku dashboardu — kolorowa kropka obok nazwy firmy:

• Zielona — Available
• Żółta — Maintenance
• Czerwona — Failure / TotalFailure

W środowiskach testowych i demo dostępny jest override Latarni — dropdown w selektorze firm pozwalający ręcznie przełączyć stan na Failure lub Available. Przydatne do testowania trybu offline bez czekania na prawdziwą awarię KSeF.

Co się dzieje w trybie offline

1. Wystawienie faktury

   Użytkownik (lub AutoSend) inicjuje wysyłkę faktury jak zwykle. System wykrywa, że KSeF jest niedostępny.

2. Generowanie XML

   Profil mapowania generuje XML identycznie jak w trybie online.

3. Podpis offline

   XML jest podpisywany certyfikatem offline (ECDSA P-256). Na jego podstawie generowane są dwa kody QR: KOD I (weryfikacja) i KOD II (podpis certyfikatem).

4. Zapis lokalny

   Faktura zapisywana jest w MinIO ze statusem OfflinePending. XML i PDF z kodami QR są dostępne natychmiast.

5. Generowanie PDF

   PDF Sidecar generuje wizualizację faktury z oboma kodami QR.

6. Automatyczne dosyłanie

   Gdy KSeF wróci do stanu Available, BizFlow NH automatycznie dosyła faktury offline w sesji zbiorczej (batch).

Statusy faktur offline w interfejsie

Status offline jest widoczny jako badge (ikona WifiOff) na listach dokumentów SAP i stronach szczegółów:

Status	Badge	Opis
OfflinePending	Pomarańczowy	Faktura wystawiona offline, oczekuje na dosłanie
OfflineSent	Niebieski	Faktura dosłana do KSeF po przywróceniu
Accepted	Zielony	KSeF zaakceptował dosłaną fakturę
Rejected	Czerwony	KSeF odrzucił dosłaną fakturę (błąd w XML)

Brak dedykowanej strony offline

W systemie nie ma osobnej strony do zarządzania kolejką offline. Statusy offline widoczne są jako badge na standardowych listach dokumentów SAP i na stronach szczegółów faktury.

Terminy dosyłania

Zgodnie z dokumentacją techniczną CIRFMF:

Typ niedostępności	Termin dosyłania
Maintenance (planowana przerwa)	Następny dzień roboczy po przywróceniu
Failure (awaria)	7 dni roboczych od dnia przywrócenia
TotalFailure (całkowita awaria)	7 dni roboczych od dnia przywrócenia

Kaskadowa awaria

Jeśli KSeF ponownie ulegnie awarii w trakcie okna dosyłania, terminy przeliczają się od nowa. BizFlow NH automatycznie obsługuje tę sytuację.

Wymagania

Aby tryb offline działał poprawnie:

• Certyfikat offline — typ ECDSA P-256, wgrany w OpenBao
• API Latarni — dostępne z serwera BizFlow NH
• MinIO — działający serwis do przechowywania plików

Jeśli certyfikat offline nie jest wgrany, system nie może podpisać faktury i zgłosi błąd. Faktura pozostanie w kolejce do ponowienia próby.