De weg van één factuur | eurinvoice-documentatie

In gewone woorden

Deze pagina volgt één factuur van het ERP van de eindklant tot de lijst met mislukte facturen. Wat voor het bedrijf telt: als een factuur fout is, noemt het antwoord het veld in de export van de eindklant en zegt het wie het oplost, voordat er iets wordt verzonden. In de gehoste sandbox heeft de laatste stap nog geen verbinding met een land.

Eén factuur, van de export van het ERP tot de opvolgingslijst. Het gele briefje is het antwoord dat het veld in de export van de eindklant noemt. Het vak met de onderbroken rand is het netwerk. De gehoste sandbox heeft er nog geen ingesteld.

De factuur verlaat het ERP van de eindklant als ERP-export (Business Central of SAP Business One), als canonieke JSON of als kant-en-klaar XML-bestand.
Ze komt binnen via POST /invoices, POST /invoices/xml of als bestand in de bestandsmap.
Het canonieke model controleert de structuur. Een fout noemt het veld.
De eigen validators van het verzendkanaal draaien: KoSIT voor Duitsland, Schematron voor Peppol, Frankrijk en Roemenië, het FA(3)-schema voor Polen. Het antwoord is 202 met een ID, of 422 met een cataloguscode die het veld noemt, zegt wie handelt en een tip voor de correctie geeft.
Een factuur die de controles doorstaat, wacht in een wachtrij. KSeF, Peppol, Frankrijk en Duitsland delen de snelle baan. ANAF heeft een eigen trage baan.
Een verzendkanaal met toegangsgegevens voor het netwerk verzendt de factuur. Duitsland heeft geen netwerk: de factuur eindigt op ready en de partner levert het bestand af. Een verzendkanaal zonder toegangsgegevens, zoals nu in de gehoste sandbox, verzendt niets.
Elk resultaat wordt een statusbericht, in volgorde bewaard. Zie statussen.
Een definitieve afwijzing komt op de opvolgingslijst. Tijdelijke fouten worden opnieuw geprobeerd en komen er pas op als alle herhaalpogingen zijn opgebruikt.

Opmerking

Een kant-en-klaar XML-bestand neemt een kortere weg. Het krijgt een veiligheidscontrole en de validators van het verzendkanaal (stap 4), maar geen canonieke controle en geen mapping, en sluit bij stap 5 aan in de wachtrij.

POST /validate voert alleen de stappen 3 en 4 uit. Het slaat niets op, verzendt niets en antwoordt altijd 200 met een rapport. Zie proefrun.