Aller au contenu
Retour au blog
TutorielPublié le 21 juin 20265 min de lecture

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.json

Exé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 npm

Où 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.