Validatore di fattura XML

Presentazione

La libreria espone una classe Validator. Il metodo assertValidXml controlla l’XML di una fattura elettronica: lancia un’eccezione se la struttura XML è errata e un’altra se l’XML è valido ma non aderente all’XSD. Il metodo getAllExceptions restituisce invece l’elenco di tutti gli errori rilevati, vuoto se è tutto corretto.

Permette anche di validare i messaggi di notifica, con la costante XSD_MESSAGGI_LATEST. Gli XSD usati provengono dal sito dell’Agenzia delle Entrate. Il README avverte che il pacchetto funziona solo per gli standard italiani e che la validazione delle e-mail è volutamente più permissiva: spetta all’utente.

Punti di forza

• assertValidXml distingue due errori: struttura XML errata (InvalidXmlStructureException) e XML non aderente all’XSD (InvalidXsdStructureComplianceException).
• getAllExceptions restituisce un array di tutte le eccezioni rilevate, vuoto se il documento è valido.
• Validazione delle notifiche possibile con Validator::XSD_MESSAGGI_LATEST.
• XSD presi dal sito dell’Agenzia delle Entrate, ritenuto più aggiornato dell’altro sito di riferimento citato (fatturapa.gov.it).
• Espressione regolare per le e-mail dell’XSD sostituita con una più permissiva, con il diff documentato nel README.

Per chi

Per gli sviluppatori PHP che producono o ricevono fatture elettroniche italiane in XML e vogliono controllarle prima dell’invio o dell’elaborazione.

Installazione

Installazione con Composer, poi istanza della classe Validator e chiamata a assertValidXml o a getAllExceptions con il contenuto XML.

composer require slam/php-validatore-fattura-elettronica

Leggete il README su GitHub

Punti di attenzione

• Il README avverte che il pacchetto funziona solo per gli standard italiani.
• La validazione delle e-mail è volutamente permissiva e spetta all’utente: l’XSD originale è stato modificato su questo punto.
• Il composer.json del repository richiede PHP ~8.4 o ~8.5 con le estensioni dom e libxml; il README non lo indica.

Utilizzabile da un agente?

Nessun SKILL.md, AGENTS.md, CLAUDE.md, regola Cursor o server MCP trovato nella radice o nel README. È una libreria PHP da richiamare dal codice.