Come si muove una fattura

Una fattura, dall’export dell’ERP all’elenco degli scarti. Il foglietto giallo è la risposta che indica il campo nell’export del cliente. Il riquadro tratteggiato è l’infrastruttura. La sandbox ospitata non ne ha ancora configurata nessuna.

1. La fattura esce dall’ERP del cliente come export dell’ERP (Business Central o SAP Business One), JSON canonico o file XML già pronto.
2. Arriva tramite POST /invoices, POST /invoices/xml o un file nella cartella di deposito.
3. Il modello canonico controlla la struttura. Un errore indica il campo.
4. Vengono eseguiti i validatori propri del canale: KoSIT per la Germania, Schematron per Peppol, Francia e Romania, lo schema FA(3) per la Polonia. La risposta è 202 con un id, oppure 422 con un codice del catalogo che indica il campo, dice chi interviene e dà un suggerimento di correzione.
5. Una fattura che supera i controlli attende in coda. KSeF, Peppol, Francia e Germania condividono la corsia veloce. ANAF ha una corsia lenta tutta sua.
6. Un canale con una credenziale per l’infrastruttura invia la fattura. La Germania non ha un’infrastruttura: la sua fattura termina a ready e il partner consegna il file. Un canale senza credenziale, come oggi nella sandbox ospitata, non invia nulla.
7. Ogni esito diventa un evento di stato, conservato in ordine. Vedere stati.
8. Uno scarto definitivo finisce nell’elenco degli scarti. Le fatture con errori temporanei vengono ritentate e vi arrivano solo quando i tentativi si esauriscono.

POST /validate esegue solo i passaggi 3 e 4. Non memorizza nulla, non invia nulla e risponde sempre 200 con un report. Vedere simulazione.