Errori comuni Factur-X / ZUGFeRD: guida alla risoluzione
I 10 errori più frequenti nelle fatture Factur-X e ZUGFeRD e come correggerli. PDF non conforme, XML non valido, profilo insufficiente.
Perché le fatture Factur-X generano errori?
Factur-X e ZUGFeRD sono formati ibridi complessi che combinano un PDF leggibile dall'uomo con un XML strutturato conforme allo standard ISO 19005-3 (PDF/A-3). Questa doppia natura genera due categorie di errori: gli errori legati al PDF e quelli legati all'XML.
La conformità PDF/A-3 è spesso il primo ostacolo: non tutti i PDF possono essere convertiti in PDF/A-3 senza un'elaborazione specifica. Il software di fatturazione deve generare nativamente PDF/A-3.
Errori lato PDF
I 5 errori PDF più comuni nelle fatture Factur-X:
PDF non conforme a PDF/A-3
Il file PDF non è conforme allo standard PDF/A-3 (ISO 19005-3). Cause frequenti: font non incorporati, uso di JavaScript, trasparenze non appiattite.
XML non allegato correttamente
L'XML Factur-X deve essere allegato come allegato PDF con il nome esatto 'factur-x.xml' e la relazione 'AF' definita nei metadati.
Metadati XMP errati
Il PDF deve contenere metadati XMP specifici che indicano il profilo e la versione di Factur-X.
Versione Factur-X non dichiarata
La versione Factur-X deve essere dichiarata nei metadati XMP. Un'incoerenza tra la versione dichiarata e quella reale dell'XML causa errori di validazione.
PDF danneggiato durante la fusione
La fusione PDF + XML può danneggiare il file se lo strumento utilizzato non supporta correttamente PDF/A-3.
Errori lato XML / CII
Questi errori si verificano nell'XML incorporato, indipendentemente dalla validità del contenitore PDF:
Numero IVA venditore mancante
EN 16931 richiede il numero di identificazione IVA del venditore (SellerTradeParty/SpecifiedTaxRegistration/ID con schemeID='VA'). L'assenza del numero IVA causa il fallimento della regola BR-CO-09 e il rifiuto da parte delle piattaforme delle autorità fiscali.
Discrepanza nell'arrotondamento dell'importo IVA
L'importo fiscale calcolato (taxBasisAmount × taxRate / 100) deve corrispondere al TaxTotalAmount dichiarato entro 0,01€. Gli errori di arrotondamento nei sistemi ERP — specialmente con più righe che utilizzano tariffe diverse — sono la causa più comune di errori della regola EN 16931 (BR-CO-15).
Discrepanza nel totale generale
GrandTotalAmount deve essere uguale a LineTotalAmount − AllowanceTotalAmount + ChargeTotalAmount + TaxTotalAmount. Qualsiasi discrepanza, anche di 0,01€, causa il fallimento della regola BR-CO-16 di EN 16931. Verificare che tutti gli importi intermedi siano sommati correttamente.
Identificatore di profilo errato in GuidelineSpecifiedDocumentContextParameter
Il profilo deve essere dichiarato nell'intestazione XML. Valori corretti comuni: urn:cen.eu:en16931:2017 (EN 16931 COMFORT), urn:factur-x.eu:1p0:minimum, urn:factur-x.eu:1p0:basicwl, ecc. Una discrepanza tra il profilo dichiarato e i dati effettivamente presenti causa errori di validazione.
Importi di riga fattura o prezzo unitario mancanti
EN 16931 richiede come minimo: descrizione dell'articolo, quantità, unità di misura, prezzo unitario e importo di riga per ogni riga fattura. Molte fatture di profilo MINIMUM omettono i dettagli di riga, il che è valido solo per quel livello di profilo — passare al profilo EN 16931 senza aggiungere i dati di dettaglio di riga causa errori di regola.
Come correggere e prevenire questi errori
La prevenzione passa dalla scelta di un software di fatturazione certificato Factur-X. Il software certificato garantisce la generazione di file conformi.
Apri il validatore Factur-XDomande frequenti
Qual è la differenza tra Factur-X e ZUGFeRD?
Factur-X è la versione francese/europea, ZUGFeRD la versione tedesca dello stesso standard ibrido PDF/XML. Entrambi sono tecnicamente identici da ZUGFeRD 2.0 e interoperabili.
Quali profili Factur-X sono disponibili?
I profili Factur-X sono: Minimum, Basic WL (senza righe), Basic (righe semplificate), EN 16931 (conformità totale), Extended (dati aggiuntivi).
Il mio PDF Factur-X viene rifiutato — come diagnostico il problema?
Usa ValidateFin per estrarre l'XML e verificarne la conformità. Per la parte PDF, un validatore PDF/A come VeraPDF (gratuito, open source) permette di diagnosticare le non conformità PDF/A-3.
Factur-X è obbligatorio in Italia?
Per le fatture alle amministrazioni pubbliche (B2G), sì. Per le fatture B2B, la riforma europea della fatturazione elettronica imporrà Factur-X o UBL.
Posso generare Factur-X da Excel o Word?
Non nativamente. È necessario un software dedicato o un add-in in grado di generare PDF/A-3 con XML CII incorporato.
L'IVA nell'XML deve corrispondere a quella del PDF?
Sì, obbligatoriamente. In caso di discrepanza tra il PDF leggibile e l'XML strutturato, l'XML prevale legalmente.
ValidateFin estrae automaticamente l'XML dal PDF?
Sì, ValidateFin estrae automaticamente l'XML CII incorporato nel PDF Factur-X/ZUGFeRD, poi valida la sua conformità EN 16931.
Quale software raccomanda per generare Factur-X?
Non facciamo raccomandazioni commerciali. Per gli sviluppatori esistono librerie open source in Python (factur-x), Java e PHP.
Un file Factur-X può contenere più fatture?
No, secondo la norma Factur-X, ogni file PDF deve contenere solo una fattura.
Quale versione di Factur-X usare per il 2026?
Factur-X 1.0 (basato su CII D16B) con profilo EN 16931 o Extended è raccomandato.