Naar inhoud springen
Terug naar blog
TutorialGepubliceerd op 21 juni 20265 min leestijd

Valideer een Peppol-factuur in Node.js in 5 minuten

Een stapsgewijze tutorial: valideer een UBL- / Peppol BIS- / EN 16931-factuur in Node.js tegen XSD en Schematron met het gratis npm-pakket peppol-validator — zonder Java.

Peppol- en EN 16931-facturen zijn strikt XML: een bestand dat er "prima uitziet" kan toch falen op de regels die een belastingdienst of het Peppol-netwerk afdwingt. In deze tutorial valideren we er een in Node.js in ongeveer vijf minuten, met het gratis, open-sourcepakket peppol-validator — zonder Java of JVM.

Wat u nodig hebt

  • Node.js 18 of nieuwer.
  • Een factuur-XML-bestand (UBL Invoice of CreditNote) — noem het invoice.xml.
  • Ongeveer vijf minuten.

Stap 1 — Het pakket installeren

npm install peppol-validator

Stap 2 — De structuur controleren (XSD)

Valideer eerst de XML tegen het UBL 2.1-schema. De OASIS-schema's zijn meegeleverd, dus dit vereist geen configuratie — het rootelement wordt automatisch gedetecteerd.

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 vertelt u of de structuur correct is; result.errors somt eventuele problemen op met regelnummers. Dit vangt misvormde documenten meteen op.

Stap 3 — De bedrijfsregels toevoegen (Schematron)

XSD controleert alleen de vorm. De echte EN 16931- en Peppol-regels — totalen moeten kloppen, btw-categorieën moeten consistent zijn, verplichte velden moeten aanwezig zijn — zitten in Schematron. Die regelsets zijn niet meegeleverd (ze behoren toe aan OpenPEPPOL en de andere instanties), dus u downloadt de officiële .sch één keer en compileert die met het meegeleverde hulpprogramma:

# 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

Voer nu XSD en de bedrijfsregels samen uit in één aanroep:

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);
}

Stap 4 — Het resultaat lezen

  • report.valid — totale geslaagd/gefaald (XSD en Schematron gecombineerd).
  • report.xsd.errors — structurele problemen.
  • report.schematron.errors — overtredingen van bedrijfsregels, elk met een regel-ID (bijv. BR-CO-10) en een leesbaar bericht.
  • report.schematron.warnings — niet-fatale problemen die u toch wellicht wilt oplossen.

Dat is het

In een handvol regels hebt u zowel structurele als bedrijfsregelvalidatie voor Peppol BIS, EN 16931 of XRechnung — overal uitvoerbaar waar Node draait, zonder Java. Wijs naar een andere gecompileerde regelset om andere profielen of de inkoopdocumenten te valideren.

Haal peppol-validator op npm

Waar MyInvoice van pas komt

peppol-validator controleert documenten. Als u ze ook moet genereren — CSV, Excel, UBL, EDIFACT of uw ERP-gegevens omzetten in een conforme EN 16931-factuur — is dat precies wat MyInvoice doet: converteren, valideren en een verzendklaar document teruggeven via één API.