SEPA File Checker

Tracciato SDD CBI XML: che cos'è e che cosa controlla questo strumento

Aggiornato al: 28 ottobre 2026

In Italia molte banche chiedono i file di addebiti diretti e di bonifici nel tracciato CBI, una variante italiana di ISO 20022. Qui trova che cosa lo distingue da un normale file SEPA XML, gli errori più frequenti e che cosa il nostro strumento fa oggi con questi file.

Controlli il Suo tracciato SDD CBI XML

Scegli un file

Il nostro server controlla il Suo file solo in memoria, non lo salva mai su disco e lo cancella al più tardi dopo 30 minuti.

Guardi come funziona

Controllo basato sugli Standard CBI (fonte: CBI S.c.p.a.).

In breve

  • CBI è il consorzio interbancario italiano che pubblica i formati CBI XML, basati su ISO 20022 ma con struttura propria.
  • Un file CBI non si riconosce da pain.008 o pain.001, ma da altri elementi radice e da una busta propria.
  • Il nostro strumento controlla e ripara i file CBI per addebiti diretti e bonifici, anche dentro la busta, come i file pain.008 e pain.001.
  • Il file corretto resta un file CBI: stessa struttura, stesso numero di operazioni e stessi totali.

Che cos'è il CBI

CBI è il consorzio interbancario italiano. Definisce, tra l'altro, i tracciati XML con cui aziende, associazioni e professionisti trasmettono alla banca addebiti diretti e bonifici. Questi tracciati seguono ISO 20022, ma non sono identici ai file pain.008 e pain.001 usati negli altri Paesi SEPA.

  • Elementi radice. Per gli addebiti diretti SEPA si incontra CBISDDReqLogMsg, per le richieste di pagamento CBIPaymentRequest.
  • Busta. Il messaggio è racchiuso in una busta, ad esempio CBIBdySDDReq.
  • Versioni. Attualmente valgono la versione 00.01.01 per gli addebiti diretti (SDD) e 00.04.01 per le richieste di pagamento; dal 15 novembre 2026 si aggiungono gli aggiornamenti descritti più avanti. Il messaggio logico segue i messaggi ISO 20022 pain.008.001.08 e pain.001.001.09.

Errori frequenti nei file CBI

Molti errori sono gli stessi di ogni addebito diretto SEPA. Un elenco non esaustivo:

  • IBAN. Cifra di controllo errata o IBAN del debitore incompleto.
  • Codice identificativo del creditore. Mancante, scritto male o con cifra di controllo errata.
  • Tipo di sequenza. Ad esempio «primo» al posto di «ricorrente», oppure il contrario, rispetto allo storico del mandato.
  • Data nel passato. La data di scadenza dell'addebito è già trascorsa o non rispetta i termini della banca.
  • Totali di controllo. Il numero di operazioni o l'importo complessivo non corrispondono alla somma delle singole operazioni.
  • CUC. Il Codice Univoco CBI nell'elemento InitgPty manca, l'emittente non è «CBI» oppure il codice non è quello della Sua azienda. Lo strumento segnala i primi due casi; il terzo lo verifichi con la Sua banca.
  • Codice ABI. Il codice ABI della banca non è composto da cinque cifre, cambia all'interno dello stesso messaggio o non corrisponde all'IBAN.
  • Tipo di addebito. Il valore deve essere CORE o B2B, senza mescolarli nello stesso messaggio.
  • EndToEndId. Deve essere univoco all'interno del messaggio logico.
  • Bonifici. Con un IBAN italiano del beneficiario serve la categoria del pagamento; con un IBAN estero serve l'indirizzo del beneficiario.

Indirizzi strutturati nel CBI

Per gli indirizzi valgono in linea di principio le regole SEPA descritte nella pagina Indirizzo strutturato. Per il creditore e il debitore degli addebiti, e per l'ordinante e il beneficiario dei bonifici, il CBI ha anche una regola propria, che cambia il 15 novembre 2026:

  • Fino al 14 novembre 2026. Accanto alla riga di indirizzo è ammesso solo il paese; senza riga di indirizzo servono almeno città e paese.
  • Dal 15 novembre 2026. Il controllo è disattivato per permettere gli indirizzi ibridi: riga di indirizzo insieme a città e paese.

Lo strumento applica la regola valida alla data di addebito o di esecuzione indicata nel file. Se la data non è determinabile, controlla secondo la versione del 15 novembre e La avvisa di ciò che non sarebbe ammesso nella versione attuale.

Che cosa fa oggi questo strumento

Formati e supporto dello strumento
FormatoControlloCorrezione
pain.008 (addebiti diretti SEPA)sìsì
pain.001 (bonifici SEPA)sìsì
CBI SDD: CBISDDReqLogMsg 00.01.01, anche in CBIBdySDDReq e CBISDDReqPhyMsgsìsì (una busta con un solo messaggio logico)
CBI bonifici: CBIPaymentRequest 00.04.01, anche in CBIBdyPaymentRequest e CBIPaymentRequestMsgsìsì (una busta con un solo messaggio logico)

Lo strumento convalida il messaggio logico con lo schema XSD ufficiale del CBI e applica le stesse verifiche dei file pain.008 e pain.001: IBAN, BIC, codice identificativo del creditore, mandato, tipo di sequenza, date, numero di operazioni, totali, caratteri e indirizzi. A queste aggiunge le regole del CBI, come CUC, codice ABI e tipo di addebito. Una busta viene convalidata per intero con gli schemi XSD ufficiali, comprese le intestazioni CBIHdrTrt e CBIHdrSrv e il blocco di firma CBISgnInf; lo strumento controlla anche il numero di messaggi logici e la coerenza del servizio indicato. Non verifica invece la validità crittografica di una firma né i codici CUC delle intestazioni. Altre versioni o altri messaggi CBI, come i rendiconti di stato, vengono riconosciuti ma non controllati.

La correzione riguarda ciò che è univoco, come totali di controllo, emittente del CUC e indirizzi; IBAN, codice identificativo o date li inserisce Lei. Il controllo non sostituisce le verifiche della banca, che ha l'ultima parola sull'accettazione del file.

Controllo basato sugli Standard CBI (fonte: CBI S.c.p.a.).

Domande frequenti

Un file CBI è un normale file SEPA XML?

Non del tutto. I formati CBI si basano su ISO 20022, ma sono una variante italiana con elementi radice e buste propri. Un file pain.008 o pain.001 standard non è quindi un file CBI e viceversa. Per sapere quale formato accetta il Suo home banking, consulti la banca o le specifiche CBI.

Potete controllare o correggere il mio file CBI?

Sì. Lo strumento controlla gli addebiti diretti in CBISDDReqLogMsg 00.01.01 e i bonifici in CBIPaymentRequest 00.04.01, anche dentro la busta. La correzione costa 14,95 € + IVA: il file corretto resta un file CBI, con lo stesso numero di operazioni e gli stessi totali, ed è verificato con lo schema XSD del CBI prima della consegna.

Che cosa lo strumento non può verificare?

Se il CUC e il codice ABI sono davvero quelli registrati per la Sua azienda e la Sua banca, e se il MsgId è già stato usato: questi dati li conosce solo la banca. I file firmati digitalmente (CBISgnInf) non sono leggibili e quindi non vengono controllati. Una busta con più messaggi logici viene controllata, ma va corretta un messaggio alla volta. Il controllo dei bonifici riguarda quelli SEPA: bonifici FAST e urgenti, assegni e pagoPA non vengono controllati nel dettaglio.

Dove trovo le specifiche ufficiali del CBI?

Sul sito del consorzio CBI, alla pagina dedicata agli standard (cbi-org.eu). La versione richiesta per il Suo file dipende dalla banca: in caso di dubbio la interpelli.

Fonti

Approfondimenti

Controlla il file