Iniziare · 1 di 3
Come funziona Sepalo
In sostanza: gli dai un foglio Excel con la lista dei pagamenti che devi fare, lui ti restituisce un file XML conforme allo standard CBI obbligatorio in Italia. Quel file lo carichi nell'home banking aziendale come “disposizione massiva” e i bonifici partono.
Prepara il foglio
Una riga per bonifico, con almeno: beneficiario, IBAN, importo, causale e data esecuzione. Vai pure di copia-incolla dal gestionale.
Imposta il profilo (una volta sola)
Apri Sepalo, vai su Profilo e inserisci i dati anagrafici, l'IBAN ordinante e il codice CUC della tua banca. Restano nel browser, cifrati.
Carica e genera
Trascina il file nella schermata Genera. Sepalo controlla ogni riga: IBAN, importi, causali. Tu rivedi, clicchi Genera, scarichi l'XML.
Carica nell'home banking
Sezione "bonifici massivi" della tua banca, importa il file. Autorizzi con OTP/firma e i bonifici partono.
Cos'è il tracciato CBI
CBIBdyPaymentRequest.00.04.01 è il formato XML obbligatorio per i bonifici massivi in Italia dal novembre 2023. È definito da ABI/CBI (Corporate Banking Interbancario) e accettato da tutte le banche italiane principali.
Sepalo valida ogni file generato contro lo schema XSD ufficiale, direttamente nel browser con WASM, prima del download.
Formato CSV / XLSX
Il file deve avere almeno le seguenti colonne (l'ordine non importa — Sepalo le rileva automaticamente):
| Colonna | Descrizione | Obbligatoria |
|---|---|---|
| name / beneficiario | Ragione sociale o nome del destinatario | Sì |
| iban | IBAN del conto destinatario (IT o estero SEPA) | Sì |
| amount / importo | Importo in euro (es. 1250.00) | Sì |
| description / causale | Causale del bonifico (max 140 caratteri) | Sì |
| bic / swift | BIC/SWIFT della banca destinataria | No (derivato) |
| date / data | Data di esecuzione (YYYY-MM-DD) | No (default: oggi) |
Errori comuni
IBAN non valido
Sepalo verifica il checksum ISO 13616. L'IBAN deve essere 27 caratteri per conti italiani (IT + 2 cifre + 23 caratteri alfanumerici).
Causale > 140 caratteri
Il campo viene troncato automaticamente. Sepalo mostra un warning con la lunghezza attuale e quella dopo il troncamento.
Possibile doppio pagamento
Se due righe hanno stesso IBAN, stesso importo e stessa data, Sepalo segnala un potenziale duplicato. Puoi ignorarlo se è intenzionale.
Caratteri non SEPA-compliant
Lettere accentate, apostrofi tipografici e emoji vengono convertiti automaticamente (ò → o, ' → ', emoji → vuoto).
Glossario
- CBI
- Corporate Banking Interbancario. Standard italiano per i pagamenti bancari aziendali.
- CUC
- Codice Univoco CBI. Codice alfanumerico assegnato dalla banca all'azienda ordinante.
- IBAN
- International Bank Account Number. Identificatore internazionale di conto corrente.
- BIC/SWIFT
- Bank Identifier Code. Identifica la banca destinataria. Spesso facoltativo per IBAN italiani.
- Ordinante
- L'azienda o il professionista che dispone i bonifici.
- XSD
- XML Schema Definition. Descrive la struttura valida di un file XML. Sepalo lo usa per validare prima del download.
Sei uno sviluppatore?
Consulta la documentazione tecnica di @sepalo/core per integrare la libreria nel tuo progetto.