Guida
Esporta MarkdownCTC/clearance e portali nell’UE: come costruire integrazioni affidabili
Nei sistemi di clearance o guidati da portale, la risposta della piattaforma (accettata/rifiutata, ID, timestamp) può far parte del record legalmente rilevante. Questo cambia cosa conservi, come fai retry e come supporti i clienti.
Cosa significa “clearance” / CTC (senza buzzword)
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.
Implicazioni ingegneristiche: storage, retry, idempotenza
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.
Playbook di supporto: cosa devi saper rispondere subito
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.
Checklist pratica: Implicazioni ingegneristiche: storage, retry, idempotenza
- Usa chiavi fattura stabili per la deduplicazione
- Persisti ogni payload di risposta
- Mostra lo stato agli utenti (inviata/accettata/rifiutata)