Formato CBI Bonifico
Guida completa al formato CBIPaymentRequest per bonifici bancari tramite remote banking
Cos'è il CBI Bonifico?
Il CBI Bonifico (CBIPaymentRequest) è lo standard italiano per la disposizione di bonifici tramite i sistemi di Corporate Banking Interbancario. Si basa sullo standard ISO 20022 e viene utilizzato per l'invio di ordini di pagamento alla propria banca attraverso i canali di remote banking.
Il formato è definito dal Consorzio CBI (Customer to Business Interaction) e rappresenta l'evoluzione italiana dello standard SEPA Credit Transfer (pain.001).
Versioni Disponibili
| Versione | Stato | Namespace |
|---|---|---|
| 00.04.01 | Raccomandato | urn:CBI:xsd:CBIPaymentRequest.00.04.01 |
| 00.04.00 | Legacy | urn:CBI:xsd:CBIPaymentRequest.00.04.00 |
Nota: La versione 00.04.01 è quella attualmente raccomandata dal Consorzio CBI. La versione 00.04.00 è mantenuta per compatibilità con banche che non hanno ancora aggiornato i propri sistemi.
Struttura del File XML
Il file CBIPaymentRequest è un documento XML con la seguente struttura gerarchica:
<CBIPaymentRequest>
├── <GrpHdr>
│ ├── <MsgId>
│ ├── <CreDtTm>
│ ├── <NbOfTxs>
│ ├── <CtrlSum>
│ └── <InitgPty>
│
└── <PmtInf>
├── <PmtInfId>
├── <PmtMtd>
├── <PmtTpInf>
├── <ReqdExctnDt>
├── <Dbtr>
├── <DbtrAcct>
├── <DbtrAgt>
├── <ChrgBr>
│
└── <CdtTrfTxInf> (1..n)
├── <PmtId>
├── <Amt>
├── <Cdtr>
├── <CdtrAcct>
└── <RmtInf>
</CBIPaymentRequest>Campi Principali
Group Header (GrpHdr)
| Campo | Descrizione | Max | Obbl. |
|---|---|---|---|
| MsgId | Identificativo univoco del messaggio | 35 | Sì |
| CreDtTm | Data e ora di creazione (ISO 8601) | - | Sì |
| NbOfTxs | Numero totale di transazioni | 15 | Sì |
| CtrlSum | Somma di controllo degli importi | 18 | Sì |
| InitgPty/Nm | Nome dell'azienda ordinante | 70 | Sì |
| InitgPty/Id | Codice SIA o P.IVA dell'ordinante | 35 | Sì |
Dettaglio Transazione (CdtTrfTxInf)
| Campo | Descrizione | Max | Obbl. |
|---|---|---|---|
| EndToEndId | Identificativo end-to-end della transazione | 35 | Sì |
| InstdAmt | Importo e valuta (es: 1500.00 EUR) | - | Sì |
| Cdtr/Nm | Nome/ragione sociale del beneficiario | 70 | Sì |
| Cdtr/PstlAdr | Indirizzo del beneficiario | - | Racc. |
| CdtrAcct/IBAN | IBAN del beneficiario | 34 | Sì |
| RmtInf/Ustrd | Causale non strutturata | 140 | No |
Codice SIA
Il Codice SIA è un identificativo assegnato dalla SIA S.p.A. alle aziende che utilizzano
i servizi di Corporate Banking. Viene inserito nel campo InitgPty/Id con il prefisso "SIA*".
Esempio: SIA*12345
Se non si dispone del codice SIA, è possibile utilizzare alternativamente:
- Company Code - Codice assegnato dalla propria banca (con issuer "BANK")
- Partita IVA - Come fallback generico (con issuer "TXID")
Differenze con SEPA pain.001
| Aspetto | CBI Bonifico | SEPA pain.001 |
|---|---|---|
| Namespace | urn:CBI:xsd:CBIPaymentRequest | urn:iso:std:iso:20022:tech:xsd:pain.001 |
| Elemento root | CBIPaymentRequest | Document/CstmrCdtTrfInitn |
| Identificazione banca | ClrSysMmbId (ABI code) | BIC opzionale |
| Codice SIA | Richiesto (InitgPty/Id) | Non previsto |
| Utilizzo | Solo banche italiane | Tutte le banche SEPA |
Quando Usare CBI Bonifico
✓ Usa CBI Bonifico quando:
- • La tua banca richiede il formato CBI
- • Utilizzi un sistema di remote banking italiano
- • Hai un codice SIA assegnato
- • Devi disporre bonifici verso IBAN italiani
- • La banca rifiuta il formato SEPA generico
✗ Usa SEPA pain.001 quando:
- • La banca accetta lo standard SEPA generico
- • Devi inviare bonifici a banche estere SEPA
- • Non hai un codice SIA
- • Utilizzi una banca non italiana
- • Necessiti di massima portabilità
Errori Comuni e Soluzioni
Errore I101: Indirizzo beneficiario mancante
Soluzione: Assicurarsi che ogni beneficiario abbia almeno il campo Paese (Ctry) compilato. PagoPro estrae automaticamente il paese dall'IBAN se non specificato.
Errore: Codice SIA non valido
Soluzione: Verificare che il codice SIA sia nel formato corretto (5 caratteri alfanumerici). Contattare la propria banca se non si conosce il proprio codice SIA.
Errore: Schema XSD non conforme
Soluzione: Verificare la versione richiesta dalla propria banca (00.04.00 o 00.04.01) e selezionarla nelle impostazioni del lotto.
Domande Frequenti
Posso usare CBI Bonifico per pagamenti esteri?
Come ottengo il codice SIA?
Quale versione devo usare: 00.04.00 o 00.04.01?
Qual è la differenza tra TRA e TRF come metodo di pagamento?
Pronto per generare i tuoi bonifici CBI?
Carica il tuo file Excel o CSV e genera automaticamente il file CBI pronto per la banca.
Crea nuovo lotto