Valider une facture Peppol dans Node.js en 5 minutes
Un tutoriel pas à pas : validez une facture UBL / Peppol BIS / EN 16931 dans Node.js par rapport au XSD et au Schematron à l'aide du paquet npm gratuit peppol-validator — sans Java.
Les factures Peppol et EN 16931 sont du XML strict : un fichier qui « semble correct » peut quand même échouer aux règles qu'une administration fiscale ou le réseau Peppol applique. Dans ce tutoriel, nous en validons une dans Node.js en environ cinq minutes, à l'aide du paquet open source gratuit peppol-validator — sans Java ni JVM.
Ce dont vous avez besoin
- Node.js 18 ou plus récent.
- Un fichier XML de facture (UBL Invoice ou CreditNote) — appelons-le invoice.xml.
- Environ cinq minutes.
Étape 1 — Installer le paquet
npm install peppol-validatorÉtape 2 — Vérifier la structure (XSD)
D'abord, validez le XML par rapport au schéma UBL 2.1. Les schémas OASIS sont inclus, cela ne demande donc aucune configuration — l'élément racine est détecté automatiquement.
import { readFileSync } from 'node:fs';
import { validateXsd } from 'peppol-validator';
const xml = readFileSync('./invoice.xml', 'utf-8');
const result = validateXsd(xml);
console.log(result.root, result.valid); // e.g. "Invoice" true
if (!result.valid) console.error(result.errors);result.valid vous indique si la structure est correcte ; result.errors liste les éventuels problèmes avec les numéros de ligne. Cela détecte instantanément les documents mal formés.
Étape 3 — Ajouter les règles de gestion (Schematron)
Le XSD ne vérifie que la forme. Les véritables règles EN 16931 et Peppol — les totaux doivent concorder, les catégories de TVA doivent être cohérentes, les champs obligatoires doivent être présents — vivent dans le Schematron. Ces jeux de règles ne sont pas inclus (ils appartiennent à OpenPEPPOL et aux autres organismes), vous téléchargez donc le .sch officiel une fois et le compilez avec l'outil fourni :
# Download the official Peppol BIS Schematron (.sch) from docs.peppol.eu, then:
npx peppol-validator-compile PEPPOL-EN16931-UBL.sch ./artefacts/PEPPOL-EN16931-UBL.sef.jsonExécutez maintenant le XSD et les règles de gestion ensemble en un seul appel :
import { readFileSync } from 'node:fs';
import { validate, resolveSef } from 'peppol-validator';
const xml = readFileSync('./invoice.xml', 'utf-8');
const sef = resolveSef('peppol-bis-3', './artefacts');
const report = await validate(xml, { sef });
console.log('valid:', report.valid);
for (const e of report.schematron?.errors ?? []) {
console.log(e.id + ': ' + e.message);
}Étape 4 — Lire le résultat
- report.valid — réussite/échec global (XSD et Schematron combinés).
- report.xsd.errors — problèmes structurels.
- report.schematron.errors — échecs de règles de gestion, chacun avec un identifiant de règle (par ex. BR-CO-10) et un message lisible.
- report.schematron.warnings — problèmes non bloquants que vous pourriez quand même vouloir corriger.
C'est tout
En quelques lignes, vous disposez d'une validation à la fois structurelle et des règles de gestion pour Peppol BIS, EN 16931 ou XRechnung — exécutable partout où Node tourne, sans Java. Pointez vers un autre jeu de règles compilé pour valider d'autres profils ou les documents d'approvisionnement.
Obtenir peppol-validator sur npmOù intervient MyInvoice
peppol-validator vérifie les documents. Si vous devez aussi les générer — transformer du CSV, de l'Excel, de l'UBL, de l'EDIFACT ou vos données ERP en une facture EN 16931 conforme — c'est exactement ce que fait MyInvoice : convertir, valider et renvoyer un document prêt à l'envoi via une seule API.