# CTC/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)

## Risorse correlate

- [Errori del validatore KoSIT (come risolverli)](/resources/kosit-validator-errors)
- [Panoramica e-fatturazione UE](/resources/eu/eu-e-invoicing-2026)
- [Guida paese Italia (SdI)](/resources/countries/it)
- [Guida paese Polonia (KSeF)](/resources/countries/pl)