Formato CBI Bonifico
Guida completa al formato CBIPaymentRequest per bonifici bancari tramite remote banking
Contenuto informativo a scopo divulgativo: non costituisce consulenza fiscale, legale o professionale.
Il percorso nell’app
Pagamenti → Lotti → Nuovo lotto → Dettagli
- Apri il nuovo lotto e scegli il metodo di inserimento.
- Nel campo Tipo di pagamento trovi CBI Bonifico; confronta i requisiti del formato descritti in questa guida.
- Verifica con la banca il formato richiesto e prepara i dati del foglio prima di procedere.
Schermate della demo con dati fittizi. Seleziona un’immagine per ingrandirla in una nuova scheda. Le voci disponibili dipendono dai tuoi permessi.
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