Nous avons publié peppol-validator en open source — un npm gratuit pour valider les factures UBL et Peppol
peppol-validator est un paquet npm gratuit sous licence MIT qui valide les documents UBL 2.1 / Peppol BIS / EN 16931 par rapport au XSD et au Schematron — sans Java, avec vos propres jeux de règles.
Nous venons de publier notre premier paquet open source : peppol-validator, une petite bibliothèque npm qui valide les documents UBL 2.1 et Peppol BIS — factures, notes de crédit, commandes, avis d'expédition, catalogues, réponses applicatives — à la fois par rapport à la structure XSD et aux règles de gestion Schematron. Elle est sous licence MIT et libre d'utilisation.
Pourquoi mettre le validateur en open source
Un document n'est pas « valide » simplement parce que c'est du XML bien formé. Il doit passer des contrôles structurels (XSD) et de règles de gestion (Schematron) stricts pour EN 16931, Peppol BIS ou XRechnung — et assembler correctement ce pipeline est délicat. La validation, en revanche, est une commodité : elle vérifie des documents, elle n'en génère pas. Nous avons donc extrait cette couche de notre plateforme et l'avons publiée à part.
Ce qu'il fait
La validation XSD fonctionne d'emblée — les schémas OASIS UBL 2.1 sont inclus, la racine du document est détectée automatiquement (Invoice, CreditNote, Order, Catalogue, ApplicationResponse et plus) et le schéma correspondant est sélectionné. Le Schematron s'exécute sur SaxonJS, il n'y a donc ni Java ni JVM à installer.
- Validation XSD prête à l'emploi (schémas OASIS UBL 2.1 inclus).
- Validation Schematron via SaxonJS — JavaScript pur, pas de JVM.
- Détection automatique du type de document ; une seule API pour les factures et toute la famille des documents d'approvisionnement.
- Analyse renforcée : entités externes, chargement de DTD et accès réseau désactivés ; taille d'entrée plafonnée.
Apportez vos propres jeux de règles
Un choix de conception délibéré : les jeux de règles Schematron Peppol, EN 16931 et XRechnung ne sont pas redistribués dans le paquet — ils appartiennent à leurs organismes respectifs. À la place, peppol-validator inclut un compilateur qui transforme localement les fichiers .sch officiels que vous téléchargez en artefacts SEF exécutables, afin que vous restiez toujours dans les conditions acceptées lors du téléchargement. Seuls le XSD OASIS UBL et le squelette ISO Schematron sous licence MIT sont livrés.
Premiers pas
Installez-le avec « npm install peppol-validator ». Appelez validateXsd(xml) pour un contrôle structurel instantané, ou validate(xml, { sef }) pour exécuter le XSD plus un jeu de règles Schematron compilé en un seul appel. Vous recevez un rapport clair avec les identifiants des règles en échec et les messages.
Voir peppol-validator sur npmComment il se rattache à MyInvoice
peppol-validator est la couche de validation ouverte de MyInvoice. Le validateur vérifie les documents ; la plateforme MyInvoice va plus loin — elle convertit les données que vous possédez déjà (CSV, Excel, UBL, EDIFACT ou XML hérité) en un document EN 16931 conforme dans le profil dont vous avez besoin, le valide de la même façon et se connecte à votre ERP. Si vous devez seulement vérifier des fichiers, le paquet npm suffit ; si vous devez générer des factures conformes, c'est à cela que sert MyInvoice.