Vai al contenuto

Errore

FX-SCH-A-000417: Il tipo di documento deve essere uno ammesso dal profilo

In breve

Errore: non supera i controlli selezionati.

FX-SCH-A-000417 significa che il codice del tipo di documento (BT-3) non vuoto di un file Basic WL non è nell'elenco ammesso dal profilo. Correggi ram:TypeCode dentro rsm:ExchangedDocument usando un codice ammesso che corrisponda al tipo effettivo del documento, poi esporta e ricontrolla il file.

In questa pagina

Che cosa significa

Nel profilo Basic WL di Factur-X e ZUGFeRD, il valore non vuoto di rsm:ExchangedDocument/ram:TypeCode deve appartenere all'elenco del profilo. Esempi sono 380 per una fattura e 381 per una nota di credito. Un valore vuoto supera questo specifico controllo, ma ciò non dimostra che il tipo di documento possa essere omesso. Non sono i codici della FatturaPA, dove il tipo documento è TD01 per la fattura e TD04 per la nota di credito.

Perché è importante

Il codice del tipo di documento indica quale documento hai emesso e deve conservarne il significato.

Come correggerlo

Controlla il tipo effettivo del documento (BT-3) e usa il codice corrispondente dell'elenco Basic WL. Usa 380 per una fattura o 381 per una nota di credito solo quando descrivono correttamente il documento. Non sostituire un altro tipo ammesso soltanto perché è meno comune. Nell'XML correggi ram:TypeCode dentro rsm:ExchangedDocument, non ram:ExchangedDocument. Esporta e ricontrolla il file.

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

Value of 'ram:TypeCode' is not allowed.

Dove si applica questa regola

Set di regole Versione
Factur-X 1.09 BASIC WL 1.0.9-2
ZUGFeRD 2.5 BASIC WL 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-000417 dà ancora errore e quali altre regole non sono rispettate.

Aggiornato il 7 novembre 2026