Statusy faktur

Każda faktura w BizFlow NH przechodzi przez sekwencję statusów odzwierciedlających jej stan w procesie wysyłki do KSeF.

Diagram stanów

Tryb online

Sending → Sent → Accepted
                → Rejected
                → Error

Tryb offline

OfflinePending → OfflineSent → Accepted
                             → Rejected
                             → Error

Opis statusów

Status	Opis	Następny krok
Sending	Faktura jest w trakcie wysyłki do KSeF	Automatyczny — Sent lub Error
Sent	Faktura wysłana, oczekuje na potwierdzenie KSeF	Automatyczny — Accepted lub Rejected
Accepted	KSeF zaakceptował fakturę — nadany numer KSeF	Status końcowy
Rejected	KSeF odrzucił fakturę (błąd walidacji XML)	Ręczna naprawa + ponowna wysyłka
Error	Błąd techniczny (sieć, timeout, wewnętrzny)	Automatyczna lub ręczna ponowna próba
OfflinePending	Faktura wystawiona offline, oczekuje na dosłanie	Automatyczny — OfflineSent po przywróceniu KSeF
OfflineSent	Faktura offline dosłana do KSeF	Automatyczny — Accepted lub Rejected

Szczegóły statusów

Sending

Faktura została przekazana do kolejki RabbitMQ i oczekuje na przetworzenie przez worker. Czas trwania: od sekund do minut (w zależności od obciążenia kolejki).

Sent

Worker otworzył sesję KSeF i przesłał XML. KSeF przetwarza fakturę. Czas trwania: od sekund do kilku minut.

Accepted

KSeF zaakceptował fakturę i nadał jej numer KSeF (format: XXXX-XXXXXXXX-XXXXXXXXXX-XX). To status końcowy — faktura jest w systemie KSeF.

Dane zapisane:

Numer KSeF
Data przyjęcia
UPO (Urzędowe Poświadczenie Odbioru)

Rejected

KSeF odrzucił fakturę. Najczęstsze przyczyny:

Błąd walidacji XML (niezgodność ze schematem FA(3))
Brakujące wymagane pole (NIP, data, kwota)
Nieprawidłowy NIP
Duplikat faktury

W dashboardzie: kliknij fakturę — zakładka “Błędy” — pełny komunikat z KSeF.

Rejected jest statusem terminalnym — faktura wymaga ręcznej korekty i ponownej wysyłki.

Error

Błąd techniczny po stronie BizFlow NH lub sieci:

Timeout połączenia z KSeF
Błąd certyfikatu (wygasł, niepoprawny)
Wewnętrzny błąd serwera

System automatycznie ponawia próbę (do 3 razy z rosnącym interwałem). Jeśli wszystkie próby zawiodą, faktura wymaga ręcznej interwencji.

Error jest statusem terminalnym — po wyczerpaniu automatycznych ponowień.

OfflinePending

Faktura wystawiona w trybie offline (KSeF niedostępny). Ma wygenerowane kody QR (KOD I + KOD II) i jest zapisana lokalnie w MinIO.

Będzie automatycznie dosłana po przywróceniu KSeF.

OfflineSent

Faktura offline została dosłana do KSeF w sesji zbiorczej. Oczekuje na potwierdzenie — przejdzie do Accepted lub Rejected.

Dane KSeF w SAP

Dane zwrotne z KSeF przechowywane są w dedykowanym UDO @BCD_KSEF_DATA:

Pole UDO	Wartość	Opis
`U_KSeF_Number`	`2026-XXXX-...`	Numer nadany przez KSeF
`U_KSeF_Status`	`S` / `A` / `E`	Status: Sent / Accepted / Error
`U_KSeF_Hash`	SHA-256	Hash wysłanego XML
`U_KSeF_IssueDate`	`2026-03-15`	Data wystawienia
`U_KSeF_Err`	tekst	Komunikat błędu (jeśli status=E)
`U_UPO_Xml`	XML	Urzędowe Poświadczenie Odbioru
`U_QR_Code`	tekst	Dane kodu QR weryfikacyjnego
`U_SendMode`	`Online` / `Offline`	Tryb wysyłki

Na samych dokumentach handlowych SAP (OINV, OCSI, ODPI) dodane jest wyłącznie pole U_BCD_KSEF_COMMENTS — służy do komunikatów zwrotnych (błędy, ostrzeżenia).

Filtrowanie w dashboardzie

Dashboard pozwala filtrować faktury po statusie:

Wszystkie — pełna lista
W trakcie — Sending + Sent + OfflineSent
Zaakceptowane — Accepted
Problemy — Rejected + Error
Offline — OfflinePending