Valider en Peppol-faktura i Node.js på 5 minutter
En trinnvis veiledning: valider en UBL- / Peppol BIS- / EN 16931-faktura i Node.js mot XSD og Schematron med den gratis npm-pakken peppol-validator — uten Java.
Peppol- og EN 16931-fakturaer er strengt XML: en fil som "ser fin ut" kan likevel feile reglene en skattemyndighet eller Peppol-nettverket håndhever. I denne veiledningen validerer vi én i Node.js på rundt fem minutter, med den gratis, åpen kildekode-pakken peppol-validator — helt uten Java eller JVM.
Hva du trenger
- Node.js 18 eller nyere.
- En faktura-XML-fil (UBL Invoice eller CreditNote) — la oss kalle den invoice.xml.
- Omtrent fem minutter.
Trinn 1 — Installer pakken
npm install peppol-validatorTrinn 2 — Sjekk strukturen (XSD)
Først validerer du XML-en mot UBL 2.1-skjemaet. OASIS-skjemaene er inkludert, så dette krever ingen konfigurasjon — rotelementet oppdages automatisk.
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 forteller deg om strukturen er korrekt; result.errors lister opp eventuelle problemer med linjenumre. Dette fanger opp feilformede dokumenter umiddelbart.
Trinn 3 — Legg til forretningsreglene (Schematron)
XSD sjekker bare formen. De egentlige EN 16931- og Peppol-reglene — totaler må stemme, MVA-kategorier må være konsistente, obligatoriske felt må være til stede — bor i Schematron. Disse regelsettene er ikke inkludert (de tilhører OpenPEPPOL og de andre organene), så du laster ned den offisielle .sch én gang og kompilerer den med det medfølgende verktøyet:
# 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.jsonKjør nå XSD og forretningsreglene sammen i ett enkelt kall:
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);
}Trinn 4 — Les resultatet
- report.valid — samlet bestått/ikke bestått (XSD og Schematron kombinert).
- report.xsd.errors — strukturelle problemer.
- report.schematron.errors — brudd på forretningsregler, hver med en regel-ID (f.eks. BR-CO-10) og en lesbar melding.
- report.schematron.warnings — ikke-fatale problemer du likevel kan ønske å rette.
Det er alt
På en håndfull linjer har du både strukturell og forretningsregelvalidering for Peppol BIS, EN 16931 eller XRechnung — kjørbart overalt der Node kjører, uten Java. Pek på et annet kompilert regelsett for å validere andre profiler eller anskaffelsesdokumentene.
Hent peppol-validator på npmHvor MyInvoice passer inn
peppol-validator sjekker dokumenter. Hvis du også må generere dem — gjøre CSV, Excel, UBL, EDIFACT eller ERP-dataene dine om til en samsvarende EN 16931-faktura — er det nettopp det MyInvoice gjør: konvertere, validere og returnere et sendeklart dokument gjennom ett API.