Vai al contenuto

Errore

FX-SCH-A-000321: L'agente del cliente può avere un solo codice di ruolo

In breve

Errore: non supera i controlli selezionati.

FX-SCH-A-000321 significa che la parte che agisce per conto del cliente (ram:BuyerAgentTradeParty) ha più di un codice di ruolo (ram:RoleCode). Mantieni il codice pertinente e rimuovi quelli duplicati o non necessari, poi esporta di nuovo la fattura e ricontrollala.

In questa pagina

Che cosa significa

Ogni ram:BuyerAgentTradeParty sotto ram:ApplicableHeaderTradeAgreement può contenere al massimo un ram:RoleCode, il codice del ruolo che quella parte svolge. Il test conta gli elementi in quel blocco, senza verificarne i valori o contare i codici di ruolo presenti altrove. Il controllo vale per il profilo Extended di Factur-X e ZUGFeRD, formati esteri di fattura elettronica, non per la FatturaPA.

Perché è importante

Il profilo ammette al massimo un campo per il codice di ruolo in ciascun blocco dell'agente del cliente.

Come correggerlo

Controlla il ruolo indicato per l'agente del cliente nei dati della fattura. Se costruisci tu l'XML, lascia al massimo un ram:RoleCode dentro ogni ram:BuyerAgentTradeParty, eliminando le voci duplicate o non necessarie. Esporta di nuovo la fattura e ricontrollala.

Dopo aver corretto il file, controllalo di nuovo gratis: Verificare una fattura ZUGFeRD

Oppure correggi la fattura in un modulo e scarica il file corretto, per 1 credito: Correggere una fattura elettronica con errori Beta

Il testo ufficiale della regola

Element 'ram:RoleCode' may occur at maximum 1 times.

Dove si applica questa regola

Set di regole Versione
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 EXTENDED 2.5.2
Testo della regola tratto da phive-rules 4.6.4.

Verifica il file

Trascina qui la fattura elettronica per vedere se FX-SCH-A-000321 dà ancora errore e quali altre regole non sono rispettate.

Aggiornato il 7 novembre 2026