Eine Peppol-Rechnung in Node.js in 5 Minuten validieren
Schritt-für-Schritt-Tutorial: Validieren Sie eine UBL- / Peppol-BIS- / EN-16931-Rechnung in Node.js gegen XSD und Schematron mit dem kostenlosen npm-Paket peppol-validator — ohne Java.
Peppol- und EN-16931-Rechnungen sind striktes XML: Eine Datei, die „gut aussieht", kann dennoch an den Regeln scheitern, die eine Finanzbehörde oder das Peppol-Netzwerk durchsetzt. In diesem Tutorial validieren wir eine in Node.js in rund fünf Minuten — mit dem kostenlosen, quelloffenen Paket peppol-validator, ganz ohne Java oder JVM.
Was Sie brauchen
- Node.js 18 oder neuer.
- Eine Rechnungs-XML-Datei (UBL Invoice oder CreditNote) — nennen wir sie invoice.xml.
- Etwa fünf Minuten.
Schritt 1 — Paket installieren
npm install peppol-validatorSchritt 2 — Struktur prüfen (XSD)
Validieren Sie das XML zuerst gegen das UBL-2.1-Schema. Die OASIS-Schemas sind enthalten, daher ist keine Konfiguration nötig — das Root-Element wird automatisch erkannt.
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); // z. B. "Invoice" true
if (!result.valid) console.error(result.errors);result.valid sagt, ob die Struktur korrekt ist; result.errors listet Probleme mit Zeilennummern. So erkennen Sie fehlerhafte Dokumente sofort.
Schritt 3 — Geschäftsregeln ergänzen (Schematron)
XSD prüft nur die Form. Die eigentlichen EN-16931- und Peppol-Regeln — Summen müssen aufgehen, USt.-Kategorien konsistent, Pflichtfelder vorhanden — stecken im Schematron. Diese Regelsätze sind nicht enthalten (sie gehören OpenPEPPOL und den anderen Stellen), also laden Sie die offizielle .sch einmal herunter und kompilieren sie mit dem mitgelieferten Tool:
# Laden Sie die offizielle Peppol-BIS-Schematron (.sch) von docs.peppol.eu, dann:
npx peppol-validator-compile PEPPOL-EN16931-UBL.sch ./artefacts/PEPPOL-EN16931-UBL.sef.jsonFühren Sie nun XSD und Geschäftsregeln in einem Aufruf aus:
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);
}Schritt 4 — Ergebnis lesen
- report.valid — Gesamtergebnis (XSD und Schematron kombiniert).
- report.xsd.errors — strukturelle Probleme.
- report.schematron.errors — Verstöße gegen Geschäftsregeln, je mit Regel-ID (z. B. BR-CO-10) und verständlicher Meldung.
- report.schematron.warnings — nicht-fatale Hinweise, die Sie evtl. trotzdem beheben möchten.
Das war es
In wenigen Zeilen haben Sie sowohl strukturelle als auch geschäftsregelbasierte Validierung für Peppol BIS, EN 16931 oder XRechnung — überall lauffähig, wo Node läuft, ohne Java. Zeigen Sie auf einen anderen kompilierten Regelsatz, um weitere Profile oder die Beschaffungsdokumente zu validieren.
peppol-validator auf npm holenWo MyInvoice ins Spiel kommt
peppol-validator prüft Dokumente. Wenn Sie sie auch erzeugen müssen — CSV, Excel, UBL, EDIFACT oder Ihre ERP-Daten in eine konforme EN-16931-Rechnung verwandeln — genau das macht MyInvoice: konvertieren, validieren und ein versandfertiges Dokument über eine API zurückgeben.