Hopp til innhold
Tilbake til bloggen
VeiledningPublisert 21. juni 20265 min lesing

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-validator

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

Kjø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å npm

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