CTC/clearance e portali nell’UE: come costruire integrazioni affidabili

Nei modelli in stile clearance, una fattura viene inviata a una piattaforma che restituisce una conferma (spesso con un ID piattaforma). La consegna al cliente può dipendere da questa conferma.

Questo crea un ciclo di vita aggiuntivo: bozza → inviato → accettato/rifiutato → consegnato/archiviato.

Tratta la piattaforma come una state machine. Devi conservare: l’XML esatto inviato, ID di submission, conferme, timestamp e qualsiasi versione “accettata” trasformata restituita dalla piattaforma.

L’idempotenza è cruciale. Un retry non deve creare fatture duplicate sulla piattaforma.

Quando una fattura fallisce in un modello di clearance, gli utenti hanno bisogno di una spiegazione chiara: cosa è fallito (dati vs consegna), cosa correggere e se possono reinviare in sicurezza.

Integra nel prodotto gli “artefatti di supporto”: XML scaricabile, log del validatore e ID di conferma della piattaforma.