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-validatorStap 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.jsonVoer 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 npmWaar 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.