# 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.

> **Il percorso di una fattura KSeF, online e offline**
>
> Polonia: il venditore emette la fattura come XML FA(3) e la invia a KSeF, il Krajowy System e-Faktur. KSeF la accetta, assegna il numero KSeF e restituisce la ricevuta UPO; l’acquirente scarica la fattura da KSeF e, per un acquirente polacco registrato ai fini IVA, la fattura si considera ricevuta il giorno in cui viene assegnato il numero KSeF. Nelle modalità offline il venditore emette la fattura FA(3) al di fuori di KSeF e consegna all’acquirente una copia con due codici QR, OFFLINE e CERTYFIKAT, poi la invia a KSeF in seguito: in offline24 entro il giorno lavorativo successivo, in modalità di emergenza entro sette giorni lavorativi dalla fine del guasto annunciato.

## 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 è importante. Un retry non deve creare fatture duplicate sulla 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)

## 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.

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