Errore di schema XML nel file SEPA: «This element is not expected»
Aggiornato al: 28 ottobre 2026
Il validatore o la banca segnalano che un elemento del Suo file SEPA non è previsto dallo schema XSD. Di solito il file mescola due versioni, oppure un campo è fuori posto o manca del tutto. Carichi il file qui sotto: il controllo gratuito indica riga e campo, e molti di questi errori si correggono in automatico.
Controlli se il Suo file contiene errori di schema
Scegli un fileIl controllo è gratuito. Correzione se necessaria: 14,95 € + IVA per 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.
- Errore
- Errore di schema (XSD)
- Dove
- Qualsiasi elemento, spesso BIC o BICFI
- Correzione
- Automatica per i nomi di un'altra versione, altrimenti segnalata
Come si presenta il messaggio di errore
Il testo dell'errore è in inglese, anche se il Suo programma è in italiano. Lo trova nel portale della banca dopo il caricamento, nel rendiconto di stato pain.002 o nel software che ha generato il file, se questo valida l'XML prima dell'invio.
Lo stesso errore cambia formulazione a seconda del validatore: libxml2 scrive «This element is not expected», i validatori Java come Xerces scrivono «cvc-complex-type.2.4.a: Invalid content was found starting with element …». Se invece manca un elemento obbligatorio, il messaggio parla di «Missing child element(s)».
Validatore di schema XML (libxml2, ad esempio xmllint e molti validatori online)
18: Element '{urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}BIC': This element is not expected. Expected is one of ( {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}BICFI, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}ClrSysMmbId, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}LEI, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}Nm, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}PstlAdr, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}Othr ).
23: Element '{urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}MndtId': This element is not expected. Expected is one of ( {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}AmdmntInd, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}AmdmntInfDtls, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}ElctrncSgntr, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}FrstColltnDt, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}FnlColltnDt, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}Frqcy, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}Rsn, {urn:iso:std:iso:20022:tech:xsd:pain.008.001.08}TrckgDays ).
Validatori Java (Xerces)
cvc-complex-type.2.4.a: Invalid content was found starting with element 'BIC'. One of '{"urn:iso:std:iso:20022:tech:xsd:pain.008.001.08":BICFI, "urn:iso:std:iso:20022:tech:xsd:pain.008.001.08":ClrSysMmbId, "urn:iso:std:iso:20022:tech:xsd:pain.008.001.08":LEI, "urn:iso:std:iso:20022:tech:xsd:pain.008.001.08":Nm, "urn:iso:std:iso:20022:tech:xsd:pain.008.001.08":PstlAdr, "urn:iso:std:iso:20022:tech:xsd:pain.008.001.08":Othr}' is expected.
Validatori .NET
The element 'FinInstnId' in namespace 'urn:iso:std:iso:20022:tech:xsd:pain.008.001.08' has invalid child element 'BIC' in namespace 'urn:iso:std:iso:20022:tech:xsd:pain.008.001.08'. List of possible elements expected: 'BICFI, ClrSysMmbId, LEI, Nm, PstlAdr, Othr' in namespace 'urn:iso:std:iso:20022:tech:xsd:pain.008.001.08'.
La Sua banca (rendiconto di stato pain.002)
FF01InvalidFileFormatCH17ElementNotAdmittedCH21RequiredCompulsoryElementMissing
Nel rendiconto la banca indica il motivo nel campo Rsn/Cd. L'home banking ne mostra spesso una traduzione. FF01 indica in generale un formato di file non valido, CH17 un elemento non ammesso in quel punto e CH21 un elemento obbligatorio mancante.
Il nostro controllo
- Il campo <BIC> si trova nella posizione sbagliata oppure non appartiene a questa versione. Atteso: <BICFI>, <ClrSysMmbId>, <LEI>, <Nm>, <PstlAdr>, <Othr>.
- Il campo <MndtId> (riferimento univoco del mandato (MndtId)) si trova nella posizione sbagliata oppure non appartiene a questa versione. Atteso: <AmdmntInd>, <AmdmntInfDtls>, <ElctrncSgntr>, <FrstColltnDt>, <FnlColltnDt>, <Frqcy>.
- SeqTp (FRST/RCUR/OOFF/FNAL) manca.
Causa
Lo schema XSD ufficiale ISO 20022 stabilisce quali elementi può contenere un file SEPA, con quale nome e in quale ordine. Ogni versione ha il proprio schema. Il validatore confronta il file con lo schema e segnala ogni elemento che in quel punto non è previsto: perché è fuori posto, perché in questa versione ha un altro nome o perché non esiste affatto.
La causa più frequente è un file che mescola due versioni. Lo spazio dei nomi in testa dichiara pain.008.001.08, ma all'interno compaiono ancora nomi della versione precedente pain.008.001.02: <BIC> al posto di <BICFI>, oppure <BICOrBEI> al posto di <AnyBIC>. Nei bonifici in pain.001.001.09 succede lo stesso con <ReqdExctnDt> scritto senza il sottocampo <Dt>.
Altre volte i nomi sono giusti ma l'ordine no, ad esempio <MndtId> collocato dopo <DtOfSgntr>. Oppure manca un elemento obbligatorio, come il tipo di sequenza <SeqTp> dell'addebito diretto.
Correggere l'errore a mano
Per una correzione puntuale basta un editor di testo. Prima di modificare qualcosa, conservi una copia del file originale.
- Apra il file e legga lo spazio dei nomi in testa, ad esempio
urn:iso:std:iso:20022:tech:xsd:pain.008.001.08: è la versione con cui il file verrà validato. - Vada alla riga indicata nel messaggio e individui l'elemento citato.
- Se l'elemento porta il nome di un'altra versione, lo rinomini con quello della versione dichiarata, sia nel tag di apertura sia in quello di chiusura.
- Se il nome è corretto ma la posizione no, sposti l'elemento nel punto che il messaggio indica tra gli elementi attesi.
- Validi di nuovo il file e ripeta finché non resta alcun errore.
Prima
<CdtrAgt>
<FinInstnId>
<BIC>ABNANL2A</BIC>
</FinInstnId>
</CdtrAgt>Dopo
<CdtrAgt>
<FinInstnId>
<BICFI>ABNANL2A</BICFI>
</FinInstnId>
</CdtrAgt>Nell'esempio il file dichiara pain.008.001.08 ma usa ancora <BIC> per la banca del creditore. In questa versione il campo si chiama <BICFI>; il codice BIC in sé resta identico.
Come lo strumento corregge l'errore
Il controllo segnala ogni errore di schema con il numero di riga, il nome del campo e i campi che lo schema si aspetta in quel punto, in italiano.
Con la correzione, i nomi che appartengono a un'altra versione vengono rinominati in automatico: BIC diventa BICFI, BICOrBEI diventa AnyBIC, ReqdExctnDt riceve il sottocampo Dt. Un file scritto interamente in una versione precedente (pain.008.001.02 o pain.001.001.03) viene convertito per intero in pain.008.001.08 o pain.001.001.09; i dettagli sono nella pagina Versioni SEPA XML. Se manca SeqTp, lo strumento Le chiede il valore corretto (FRST, RCUR, OOFF o FNAL) e lo inserisce.
Ogni file corretto viene validato di nuovo con lo schema XSD prima della consegna. La correzione avviene prima del pagamento: se il file non supera questa verifica, non riceve alcun file e non paga nulla.
Che cosa la correzione annota nel rapporto delle modifiche:
- Campo BIC (BIC) rinominato per questa versione (BICFI).
Gli altri errori di ordine vengono segnalati ma non corretti: in quel caso lo strumento non fornisce un file corretto. Li sistemi nel software che genera il file.
Pagine correlate
- Versioni SEPA XML – riconoscere la versione del file e passare a pain.008.001.08.
- Formato di importo o IBAN – un altro errore di schema, dovuto al valore e non al nome del campo.
- Totale di controllo errato – l'errore che lo schema non vede.
- Tutti gli errori nei file SEPA – i motivi più frequenti per cui una banca scarta un file.
Domande frequenti
Che cosa significa cvc-complex-type.2.4.a?
È il codice con cui i validatori Java (Xerces) segnalano un elemento non previsto in quel punto. Corrisponde a «This element is not expected» di libxml2. Dopo il codice il messaggio elenca gli elementi che lo schema si aspetta: è l'indicazione più utile per correggere.
Perché il mio software produce un file che la banca non accetta?
Spesso il software dichiara una versione recente ma scrive ancora alcuni campi con i nomi di quella precedente. Verifichi se esiste un aggiornamento; nel frattempo la correzione rinomina questi campi in automatico.
La banca scarta solo l'operazione errata?
Di solito no. Un file che non rispetta lo schema XSD viene scartato per intero, con un codice come FF01, CH17 o CH21 nel rendiconto pain.002.
Fonti
- European Payments Council: SDD Core Customer-to-PSP Implementation Guidelines 2025 – in inglese; regole tecniche del file pain.008: campi, lunghezze massime e set di caratteri SEPA
- European Payments Council: 2025 SDD Core Rulebook, version 1.1 – in inglese; regole dell'addebito diretto SEPA Core, compresi i termini di presentazione
- ISO 20022: External Code Sets – in inglese; elenco dei codici motivo usati nei rendiconti pain.002, ad esempio AM10