I file SEPA XML sono il formato standard per bonifici e addebiti diretti in Europa. Che tu sia un tesoriere, un contabile o uno sviluppatore, comprendere la struttura di questi file e fondamentale per automatizzare i flussi di pagamento. Questa guida illustra ogni fase, dalla struttura XML agli strumenti di generazione.
Cos'e un file SEPA XML?
Un file SEPA XML e un documento XML strutturato conforme allo standard ISO 20022. Consente di avviare bonifici (pain.001) o addebiti diretti (pain.008) presso la propria banca. Il formato e standardizzato in tutta l'area SEPA, garantendo l'interoperabilita tra i 36 paesi membri.
A differenza dei vecchi formati proprietari, SEPA XML offre una struttura universale accettata da ogni banca della zona euro. Ogni file contiene un'intestazione di gruppo (GroupHeader), blocchi di informazioni di pagamento (PaymentInformation) e transazioni individuali.
A differenza dei vecchi formati proprietari, SEPA XML offre una struttura universale accettata da ogni banca della zona euro. Ogni file contiene un'intestazione di gruppo (GroupHeader), blocchi di informazioni di pagamento (PaymentInformation) e transazioni individuali.
I formati pain.001 e pain.008
Lo standard ISO 20022 definisce diversi tipi di messaggi:
pain.001 (CustomerCreditTransferInitiation): per avviare bonifici. L'azienda invia questo file alla banca per ordinare pagamenti ai beneficiari.
pain.008 (CustomerDirectDebitInitiation): per avviare addebiti diretti SEPA. Il creditore invia questo file per incassare dai conti dei debitori. Richiede mandato firmato (RUM) e identificativo creditore SEPA (ICS).
Ogni formato segue uno schema XSD che definisce i campi consentiti, il loro ordine e i vincoli.
pain.001 (CustomerCreditTransferInitiation): per avviare bonifici. L'azienda invia questo file alla banca per ordinare pagamenti ai beneficiari.
pain.008 (CustomerDirectDebitInitiation): per avviare addebiti diretti SEPA. Il creditore invia questo file per incassare dai conti dei debitori. Richiede mandato firmato (RUM) e identificativo creditore SEPA (ICS).
Ogni formato segue uno schema XSD che definisce i campi consentiti, il loro ordine e i vincoli.
Struttura di un file pain.001
1. GroupHeader (GrpHdr): identificativo del messaggio, data di creazione, numero di transazioni e somma di controllo.
2. PaymentInformation (PmtInf): dati dell'emittente — nome, IBAN, BIC, data di esecuzione e metodo di pagamento.
3. CreditTransferTransactionInformation (CdtTrfTxInf): dettaglio di ogni transazione — importo, valuta, IBAN del beneficiario, riferimento end-to-end e causale.
2. PaymentInformation (PmtInf): dati dell'emittente — nome, IBAN, BIC, data di esecuzione e metodo di pagamento.
3. CreditTransferTransactionInformation (CdtTrfTxInf): dettaglio di ogni transazione — importo, valuta, IBAN del beneficiario, riferimento end-to-end e causale.
Campi obbligatori e buone pratiche
Ogni file SEPA XML deve contenere come minimo:
• MsgId: identificativo unico del messaggio.
• CreDtTm: data e ora di creazione in formato ISO 8601.
• NbOfTxs: numero totale di transazioni.
• CtrlSum: somma di controllo.
• IBAN e BIC di emittente e beneficiari.
• Importo (InstdAmt): con codice valuta.
• EndToEndId: riferimento unico per transazione.
Buone pratiche: usa identificativi univoci, valida ogni IBAN con l'algoritmo MOD 97-10 e verifica sempre il file contro lo schema XSD prima dell'invio.
• MsgId: identificativo unico del messaggio.
• CreDtTm: data e ora di creazione in formato ISO 8601.
• NbOfTxs: numero totale di transazioni.
• CtrlSum: somma di controllo.
• IBAN e BIC di emittente e beneficiari.
• Importo (InstdAmt): con codice valuta.
• EndToEndId: riferimento unico per transazione.
Buone pratiche: usa identificativi univoci, valida ogni IBAN con l'algoritmo MOD 97-10 e verifica sempre il file contro lo schema XSD prima dell'invio.
Validazione XSD: perche e come
La validazione XSD verifica che il file XML rispetti la struttura definita dallo schema ISO 20022. Un errore strutturale causa il rifiuto bancario.
Usa strumenti come il validatore ISO 20022 della nostra piattaforma, che rileva errori di schema, verifica IBAN e BIC e segnala incongruenze comuni.
La validazione preventiva riduce drasticamente i rifiuti bancari.
Usa strumenti come il validatore ISO 20022 della nostra piattaforma, che rileva errori di schema, verifica IBAN e BIC e segnala incongruenze comuni.
La validazione preventiva riduce drasticamente i rifiuti bancari.
Strumenti per generare file SEPA XML
Sviluppo su misura: i team tecnici possono usare librerie XML. Controllo totale ma richiede sviluppo e manutenzione.
Export ERP/contabile: alcuni software (Sage, SAP) offrono export SEPA XML nativo.
Generatore online: strumenti come ISO 20022 Generator consentono di creare file conformi direttamente nel browser. Importa CSV/Excel o inserisci i dati manualmente.
Export ERP/contabile: alcuni software (Sage, SAP) offrono export SEPA XML nativo.
Generatore online: strumenti come ISO 20022 Generator consentono di creare file conformi direttamente nel browser. Importa CSV/Excel o inserisci i dati manualmente.
Errori comuni da evitare
Le cause di rifiuto piu frequenti:
• IBAN non valido: errori di digitazione o cifre di controllo errate.
• BIC mancante o errato: alcune banche lo richiedono anche all'interno della SEPA.
• Data di esecuzione passata: deve essere un giorno lavorativo futuro.
• Importo zero o negativo: ogni transazione deve avere un importo positivo.
• MsgId duplicato: deve essere univoco per ogni file.
• Encoding errato: e richiesto UTF-8 senza BOM.
Un validatore preventivo rileva questi problemi prima che raggiungano la banca.
• IBAN non valido: errori di digitazione o cifre di controllo errate.
• BIC mancante o errato: alcune banche lo richiedono anche all'interno della SEPA.
• Data di esecuzione passata: deve essere un giorno lavorativo futuro.
• Importo zero o negativo: ogni transazione deve avere un importo positivo.
• MsgId duplicato: deve essere univoco per ogni file.
• Encoding errato: e richiesto UTF-8 senza BOM.
Un validatore preventivo rileva questi problemi prima che raggiungano la banca.