Cykl życia faktury i UPO

Wysyłka faktury jest asynchroniczna. Udane POST /v1/invoices może zwrócić status: processing; użyj GET /v1/invoices/{id}, aby obserwować zapisany stan cyklu życia.

Statusy faktur

received
Faktura została przyjęta i znajduje się w cyklu życia faktury.
processing
Faktura jest przetwarzana lub czeka na przetworzenie w wyznaczonym terminie.
accepted
Faktura została przyjęta. UPO może wciąż być niedostępne.
rejected
Nieponawialne odrzucenie produktowe lub biznesowe.
failed
Awaria techniczna lub przetwarzanie zakończone po wyczerpaniu ponowień.

Odpytywanie

Użyj endpointu odczytu faktury, aby obserwować status po wysyłce.

Nigdy nie wysyłaj tej samej faktury ponownie z nowym `Idempotency-Key.

Stan ponawiania

retrying: true oznacza, że zaplanowano ponowienie w tle. next_retry_at podaje czas kolejnego ponowienia, gdy jest udostępniony.

Przez Developer API udostępniane są wyłącznie retrying oraz next_retry_at.

Numery KSeF

Przyjęte faktury w sandboxie otrzymują syntetyczny numer KSEF-TEST-.... Są to symulowane dane testowe.

Dostępność UPO

upo_available: true oznacza, że istnieje utrwalony UPO XML i można go pobrać przez GET /v1/invoices/{id}/upo.

upo_available: false analogicznie.

UPO niedostępne

Endpoint UPO zwraca upo_not_available, gdy faktura istnieje, ale nie ma możliwości pobrania UPO XML.

Dla upo_not_available wartość retryable: true oznacza, że klient może ponowić odczyt później, ponieważ artefakt może się jeszcze pojawić w ramach normalnego cyklu życia po stronie backendu. Nie oznacza to, że żądanie GET wyzwoliło ponowienie po stronie backendu.

Faktury odrzucone i nieudane mogą zwrócić ten sam błąd z retryable: false.