Validateur de facture XML

Présentation

La bibliothèque expose une classe Validator. Sa méthode assertValidXml contrôle un XML de facture électronique : elle lève une exception si la structure XML est incorrecte, et une autre si le XML est valide mais non conforme à l’XSD. La méthode getAllExceptions renvoie au contraire la liste de toutes les erreurs détectées, vide si tout est correct.

Elle permet aussi de valider les messages de notification, avec la constante XSD_MESSAGGI_LATEST. Les XSD utilisés viennent du site de l’Agenzia delle Entrate. Le README avertit que le paquet ne fonctionne que pour les standards italiens, et que la validation des e-mails y est volontairement plus permissive : elle revient à l’utilisateur.

Points forts

• assertValidXml distingue deux erreurs : structure XML incorrecte (InvalidXmlStructureException) et XML non conforme à l’XSD (InvalidXsdStructureComplianceException).
• getAllExceptions renvoie un tableau de toutes les exceptions détectées, vide si le document est valide.
• Validation des notifications possible avec Validator::XSD_MESSAGGI_LATEST.
• XSD tirés du site de l’Agenzia delle Entrate, jugé plus à jour que l’autre site de référence cité (fatturapa.gov.it).
• Expression régulière d’e-mail de l’XSD remplacée par une version plus permissive, avec le diff documenté dans le README.

Pour qui

Pour les développeurs PHP qui produisent ou reçoivent des factures électroniques italiennes en XML et veulent les contrôler avant envoi ou traitement.

Installation

Installation avec Composer, puis instanciation de la classe Validator et appel de assertValidXml ou de getAllExceptions avec le contenu XML.

composer require slam/php-validatore-fattura-elettronica

Lire le README sur GitHub

Points d’attention

• Le README avertit que le paquet ne fonctionne que pour les standards italiens.
• La validation des e-mails est volontairement permissive et revient à l’utilisateur : le XSD d’origine a été modifié sur ce point.
• Le composer.json du dépôt exige PHP ~8.4 ou ~8.5 avec les extensions dom et libxml ; le README ne le précise pas.

Utilisable par un agent ?

Aucun SKILL.md, AGENTS.md, CLAUDE.md, règle Cursor ni serveur MCP trouvé à la racine ou dans le README. C’est une bibliothèque PHP à appeler depuis du code.