Vi åpen kildekode-publiserte peppol-validator — en gratis npm for å validere UBL- og Peppol-fakturaer
peppol-validator er en gratis, MIT-lisensiert npm-pakke som validerer UBL 2.1 / Peppol BIS / EN 16931-dokumenter mot XSD og Schematron — uten Java, ta med dine egne regelsett.
Vi har nettopp publisert vår første åpen kildekode-pakke: peppol-validator, et lite npm-bibliotek som validerer UBL 2.1- og Peppol BIS-dokumenter — fakturaer, kreditnotaer, ordrer, pakksedler, kataloger, application responses — både mot XSD-strukturen og Schematron-forretningsreglene. Den er MIT-lisensiert og gratis å bruke.
Hvorfor åpen kildekode på validatoren
Et dokument er ikke "gyldig" bare fordi det er velformet XML. Det må bestå strenge strukturelle (XSD) og forretningsregel- (Schematron) kontroller for EN 16931, Peppol BIS eller XRechnung — og å koble den rørledningen sammen riktig er fiklete. Validering er imidlertid en handelsvare: den sjekker dokumenter, den genererer dem ikke. Så vi trakk det laget ut av plattformen vår og slapp det for seg selv.
Hva den gjør
XSD-validering fungerer rett ut av boksen — OASIS UBL 2.1-skjemaene er inkludert, dokumentroten oppdages automatisk (Invoice, CreditNote, Order, Catalogue, ApplicationResponse og mer) og det matchende skjemaet velges. Schematron kjører på SaxonJS, så det er ingen Java eller JVM å installere.
- XSD-validering rett ut av boksen (inkluderte OASIS UBL 2.1-skjemaer).
- Schematron-validering via SaxonJS — ren JavaScript, ingen JVM.
- Oppdager dokumenttypen automatisk; ett API for fakturaer og hele anskaffelsesfamilien.
- Herdet parsing: eksterne entiteter, DTD-lasting og nettverkstilgang er deaktivert; inndatastørrelse er begrenset.
Ta med dine egne regelsett
Et bevisst designvalg: Schematron-regelsettene for Peppol, EN 16931 og XRechnung distribueres ikke inne i pakken — de tilhører sine respektive organer. I stedet inkluderer peppol-validator en kompilator som lokalt gjør de offisielle .sch-filene du laster ned om til kjørbare SEF-artefakter, slik at du alltid holder deg innenfor vilkårene du aksepterte da du lastet dem ned. Bare OASIS UBL XSD og det MIT-lisensierte ISO Schematron-skjelettet leveres.
Kom i gang
Installer den med "npm install peppol-validator". Kall validateXsd(xml) for en umiddelbar strukturell sjekk, eller validate(xml, { sef }) for å kjøre XSD pluss et kompilert Schematron-regelsett i ett kall. Du får tilbake en tydelig rapport med ID-ene og meldingene for reglene som feiler.
Se peppol-validator på npmHvordan den forholder seg til MyInvoice
peppol-validator er det åpne valideringslaget til MyInvoice. Validatoren sjekker dokumenter; MyInvoice-plattformen går lenger — den konverterer dataene du allerede har (CSV, Excel, UBL, EDIFACT eller eldre XML) til et samsvarende EN 16931-dokument i profilen du trenger, validerer det på samme måte og kobler til ERP-systemet ditt. Hvis du bare trenger å sjekke filer, er npm-pakken nok; hvis du trenger å generere samsvarende fakturaer, er det det MyInvoice er til for.