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

Wir haben peppol-validator als Open Source veröffentlicht — ein kostenloses npm zur Validierung von UBL- & Peppol-Rechnungen

peppol-validator ist ein kostenloses, MIT-lizenziertes npm-Paket, das UBL 2.1 / Peppol BIS / EN 16931 Dokumente gegen XSD und Schematron validiert — ohne Java, mit eigenen Regelsätzen.

Wir haben unser erstes Open-Source-Paket veröffentlicht: peppol-validator, eine kleine npm-Bibliothek, die UBL 2.1 und Peppol BIS Dokumente — Rechnungen, Gutschriften, Bestellungen, Lieferavise, Kataloge, Application Responses — sowohl gegen die XSD-Struktur als auch gegen die Schematron-Geschäftsregeln validiert. Sie ist MIT-lizenziert und kostenlos nutzbar.

Warum den Validator als Open Source

Ein Dokument ist nicht „valide", nur weil es wohlgeformtes XML ist. Es muss strenge strukturelle (XSD) und geschäftsregelbasierte (Schematron) Prüfungen für EN 16931, Peppol BIS oder XRechnung bestehen — und diese Pipeline korrekt aufzusetzen ist fummelig. Validierung ist jedoch Commodity: Sie prüft Dokumente, sie erzeugt sie nicht. Also haben wir diese Schicht aus unserer Plattform herausgelöst und eigenständig veröffentlicht.

Was es kann

Die XSD-Validierung funktioniert sofort — die OASIS UBL 2.1 Schemas sind enthalten, das Dokument-Root wird automatisch erkannt (Invoice, CreditNote, Order, Catalogue, ApplicationResponse und mehr) und das passende Schema gewählt. Schematron läuft über SaxonJS, also kein Java oder JVM nötig.

  • XSD-Validierung sofort einsatzbereit (enthaltene OASIS UBL 2.1 Schemas).
  • Schematron-Validierung über SaxonJS — reines JavaScript, keine JVM.
  • Erkennt den Dokumenttyp automatisch; eine API für Rechnungen und die gesamte Beschaffungsfamilie.
  • Gehärtetes Parsing: externe Entitäten, DTD-Laden und Netzwerkzugriff deaktiviert; Eingabegröße begrenzt.

Eigene Regelsätze mitbringen

Eine bewusste Designentscheidung: Die Peppol-, EN-16931- und XRechnung-Schematron-Regelsätze werden nicht im Paket mitverteilt — sie gehören ihren jeweiligen Stellen. Stattdessen liefert peppol-validator einen Compiler, der die offiziellen .sch-Dateien, die Sie herunterladen, lokal in lauffähige SEF-Artefakte umwandelt, sodass Sie stets innerhalb der akzeptierten Bedingungen bleiben. Nur das OASIS UBL XSD und das MIT-lizenzierte ISO-Schematron-Skelett werden mitgeliefert.

Erste Schritte

Installieren Sie es mit „npm install peppol-validator". Rufen Sie validateXsd(xml) für eine sofortige Strukturprüfung auf, oder validate(xml, { sef }), um XSD plus einen kompilierten Schematron-Regelsatz in einem Aufruf auszuführen. Sie erhalten einen klaren Bericht mit den fehlgeschlagenen Regel-IDs und Meldungen.

peppol-validator auf npm ansehen

Wie es mit MyInvoice zusammenhängt

peppol-validator ist die offene Validierungsschicht von MyInvoice. Der Validator prüft Dokumente; die MyInvoice-Plattform geht weiter — sie wandelt die Daten, die Sie bereits haben (CSV, Excel, UBL, EDIFACT oder Alt-XML), in ein konformes EN-16931-Dokument im gewünschten Profil um, validiert es auf dieselbe Weise und bindet Ihr ERP an. Wenn Sie nur Dateien prüfen müssen, reicht das npm-Paket; wenn Sie konforme Rechnungen erzeugen müssen, ist dafür MyInvoice da.