Validatori ZUGFeRD: cosa testare prima di inviare una fattura ibrida
Riferimenti ufficiali
Usa queste fonti per verificare date, formati e modifiche ufficiali delle regole.
Wiki tecnica correlata
Esplora la documentazione approfondita per sviluppatori e le linee guida normative corrispondenti a questo articolo.
Struttura PDF/A-3 ibrida di ZUGFeRD, XML incorporato, profili e validazione prima dell’invio.
Revisione PDF/XML ibrida, validazione non aggiornata e idoneità del PDF sorgente.
Capisci quando un PDF ibrido ZUGFeRD o Factur-X può essere accettato come file PDF/A-3 pronto per l’archiviazione.
Questa guida è per i team che generano ZUGFeRD o Factur-X e si chiedono se “il PDF si apre” significhi davvero che la fattura è pronta per essere inviata.
Non basta. Una fattura ibrida realmente utilizzabile richiede più di un PDF leggibile: l’XML incorporato deve corrispondere al profilo giusto, i dati obbligatori devono esserci, i totali devono quadrare e anche il contenitore PDF deve soddisfare le aspettative archivistiche del formato.
Cosa dovrebbe controllare davvero un validator
- L’XML incorporato è presente e può essere letto correttamente dal contenitore PDF.
- I dati fattura sono conformi a EN 16931 e al profilo ZUGFeRD o Factur-X selezionato.
- Totali, ripartizioni IVA, unità e date sono coerenti tra loro.
- Il file PDF soddisfa i vincoli PDF/A-3 attesi per un workflow di fattura ibrida.
Usa più di un tipo di validazione
Un flusso solido combina di solito almeno due livelli. Prima valida le regole business e l’XML. Poi controlla il contenitore PDF/A-3 e il packaging del file incorporato. Se il canale del destinatario applica controlli propri, consideralo come terzo gate e non come unico test.
Per questo i team combinano spesso un validator di fattura consapevole di ZUGFeRD con un validator PDF/A come veraPDF per il contenitore documentale.
Workflow di validazione consigliato
- Genera la fattura ZUGFeRD o Factur-X da dati sorgente già rivisti.
- Esegui una validazione a regole contro il profilo target e le aspettative EN 16931.
- Esegui il controllo PDF/A-3 sul documento finale, non su un PDF bozza senza XML incorporato.
- Apri il documento in un viewer capace di mostrare il contenuto strutturato e confronta i campi chiave con la fattura sorgente.
- Solo dopo invia via e-mail, portale o PEPPOL in base al processo del destinatario.
Errori comuni e cosa significano di solito
- Il PDF si apre normalmente, ma l’XML manca, è danneggiato o non è allegato come previsto.
- L’XML è leggibile tecnicamente, ma campi obbligatori o identificativi di profilo sono errati.
- Totali riga, imponibili e importi IVA non si riconciliano dopo estrazione o mapping.
- Il documento sembra corretto a un revisore umano ma fallisce il controllo PDF/A-3 perché il contenitore ibrido è incompleto o non conforme.
Fonti ufficiali e primarie
Pronto a convertire le fatture?
Converti le fatture PDF in XRechnung, ZUGFeRD e altri formati. Abbonamenti da 10 €/mese con fatturazione annuale (imposte escluse), con una prova di 3 giorni sul primo abbonamento. Oppure senza abbonamento: 5 € per conversione (imposte escluse).