Droga jednej faktury
Jedna faktura, od eksportu z ERP do zdarzeń statusu.
- W sandboxie
- Jeszcze nie w sandboxie
Prostymi słowami
Ta strona pokazuje drogę jednej faktury od ERP klienta do listy faktur z błędami. Dla firmy ważne jest to, że gdy faktura zawiera błąd, odpowiedź wskazuje pole w eksporcie klienta i podaje, kto ma je poprawić, zanim cokolwiek zostanie wysłane. W hostowanym sandboxie ostatni krok nie ma jeszcze połączenia z systemem danego kraju.
Jedna faktura, od eksportu z ERP po listę do obsługi. Żółta karteczka to odpowiedź, która wskazuje pole w eksporcie klienta. Ramka narysowana linią przerywaną to sieć. Hostowany sandbox nie ma jeszcze skonfigurowanej żadnej.
- Faktura opuszcza ERP klienta jako eksport z ERP (Business Central lub SAP Business One), kanoniczny JSON albo gotowy plik XML.
- Trafia do usługi przez
POST /invoices,POST /invoices/xmlalbo jako plik w folderze wymiany. - Model kanoniczny sprawdza strukturę. Błąd wskazuje pole.
- Uruchamiają się walidatory właściwe dla kanału: KoSIT dla Niemiec, Schematron dla Peppol, Francji i Rumunii, schemat FA(3) dla Polski. Odpowiedzią jest
202z identyfikatorem albo422z kodem z katalogu, który wskazuje pole, podaje, kto ma zareagować, i zawiera wskazówkę, jak to poprawić. - Faktura, która przeszła kontrole, czeka w kolejce. KSeF, Peppol, Francja i Niemcy korzystają ze wspólnego szybkiego toru. ANAF ma osobny, wolny tor.
- Kanał z danymi dostępowymi do sieci wysyła fakturę. Niemcy nie mają sieci: ich faktura kończy się w stanie
ready, a plik doręcza partner. Kanał bez danych dostępowych, jak dziś w hostowanym sandboxie, niczego nie wysyła. - Każdy wynik staje się zdarzeniem statusu, zapisywanym po kolei. Zob. statusy.
- Trwałe odrzucenie trafia na listę do obsługi. Przy błędach przejściowych wysyłka jest ponawiana, a faktura trafia na nią dopiero wtedy, gdy ponowienia się wyczerpią.
Uwaga
Gotowy plik XML ma krótszą drogę. Przechodzi kontrolę bezpieczeństwa i walidatory kanału (krok 4), ale nie kontrolę kanoniczną ani mapowanie, i dołącza do kolejki w kroku 5.
POST /validate wykonuje tylko kroki 3 i 4. Niczego nie zapisuje, niczego nie wysyła i zawsze zwraca 200 z raportem. Zob. przebieg próbny.