Zum Inhalt springen
Zurück zum Blog
TutorialVeröffentlicht 21. Juni 20265 Min. Lesezeit

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

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

Fü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 holen

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