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.
Pipeline interattiva
Come viene validata una fattura ibrida
Fai clic su una fase per vedere cosa controlla, oppure digita l’ID di una regola per trovare la fase che la segnala.
Fase 1 · Cosa controlla
Contenitore PDF/A-3
- Il PDF rispetta PDF/A-3, verificato con un validatore PDF/A come veraPDF.
- L’XML della fattura è incorporato, per ZUGFeRD 2.1+ e Factur-X come factur-x.xml, con relazione del file e metadati XMP.
- Le fasi successive controllano questo XML incorporato.
Codici di esempio
I validatori PDF/A citano clausole della norma PDF/A, non codici BR.
Correzione tipica
Controlla il PDF finale con l’XML incorporato, non una bozza.
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
Domande frequenti
Aprire il PDF basta a dimostrare la conformità ZUGFeRD?
No. Un PDF leggibile dimostra solo che il livello visuale esiste. Non dimostra che l’XML incorporato sia presente, valido o coerente con il profilo scelto.
Perché usare sia un validator fattura sia un validator PDF/A?
Perché controllano cose diverse. Il primo si concentra su regole e semantica della fattura, il secondo sulle aspettative di archiviazione e packaging del contenitore PDF.
La validazione elimina la necessità di revisione umana?
No. La validazione è essenziale, ma la revisione umana resta necessaria per problemi di qualità sorgente, errori di scelta profilo e questioni business che i controlli automatici non interpretano completamente.
Verifica la tua fattura elettronica
Carica il file ZUGFeRD o Factur-X, come PDF ibrido o come XML, e scopri quali regole non sono rispettate prima dell’invio. Il validatore è gratuito e funziona senza account.