We hebben peppol-validator open source gemaakt — een gratis npm om UBL- en Peppol-facturen te valideren
peppol-validator is een gratis, MIT-gelicentieerd npm-pakket dat UBL 2.1 / Peppol BIS / EN 16931-documenten valideert tegen XSD en Schematron — zonder Java, met uw eigen regelsets.
We hebben net ons eerste open-sourcepakket gepubliceerd: peppol-validator, een kleine npm-bibliotheek die UBL 2.1- en Peppol BIS-documenten — facturen, creditnota's, orders, verzendberichten, catalogi, application responses — valideert tegen zowel de XSD-structuur als de Schematron-bedrijfsregels. Het is MIT-gelicentieerd en gratis te gebruiken.
Waarom de validator open source maken
Een document is niet "geldig" louter omdat het welgevormde XML is. Het moet strikte structurele (XSD) en bedrijfsregel- (Schematron) controles doorstaan voor EN 16931, Peppol BIS of XRechnung — en die pijplijn correct opzetten is priegelig. Validatie is echter een commodity: het controleert documenten, het genereert ze niet. Daarom hebben we die laag uit ons platform gehaald en apart uitgebracht.
Wat het doet
XSD-validatie werkt meteen — de OASIS UBL 2.1-schema's zijn meegeleverd, de documentroot wordt automatisch gedetecteerd (Invoice, CreditNote, Order, Catalogue, ApplicationResponse en meer) en het bijbehorende schema wordt geselecteerd. Schematron draait op SaxonJS, dus er is geen Java of JVM te installeren.
- XSD-validatie direct bruikbaar (meegeleverde OASIS UBL 2.1-schema's).
- Schematron-validatie via SaxonJS — pure JavaScript, geen JVM.
- Detecteert automatisch het documenttype; één API voor facturen en de hele inkoopfamilie.
- Gehard parsen: externe entiteiten, DTD-laden en netwerktoegang uitgeschakeld; invoergrootte begrensd.
Breng uw eigen regelsets mee
Een bewuste ontwerpkeuze: de Schematron-regelsets van Peppol, EN 16931 en XRechnung worden niet binnen het pakket meegeleverd — ze behoren toe aan hun respectieve instanties. In plaats daarvan bevat peppol-validator een compiler die de officiële .sch-bestanden die u downloadt lokaal omzet in uitvoerbare SEF-artefacten, zodat u altijd binnen de voorwaarden blijft die u bij het downloaden hebt geaccepteerd. Alleen de OASIS UBL XSD en het MIT-gelicentieerde ISO Schematron-skelet worden meegeleverd.
Aan de slag
Installeer het met "npm install peppol-validator". Roep validateXsd(xml) aan voor een directe structurele controle, of validate(xml, { sef }) om XSD plus een gecompileerde Schematron-regelset in één aanroep uit te voeren. U krijgt een duidelijk rapport terug met de falende regel-ID's en berichten.
Bekijk peppol-validator op npmHoe het zich verhoudt tot MyInvoice
peppol-validator is de open validatielaag van MyInvoice. De validator controleert documenten; het MyInvoice-platform gaat verder — het zet de gegevens die u al hebt (CSV, Excel, UBL, EDIFACT of verouderde XML) om in een conform EN 16931-document in het profiel dat u nodig hebt, valideert het op dezelfde manier en koppelt aan uw ERP. Als u alleen bestanden hoeft te controleren, volstaat het npm-pakket; als u conforme facturen moet genereren, is MyInvoice daarvoor bedoeld.