Udostępniliśmy peppol-validator jako open source — darmowy npm do walidacji faktur UBL i Peppol
peppol-validator to darmowy pakiet npm na licencji MIT, który waliduje dokumenty UBL 2.1 / Peppol BIS / EN 16931 względem XSD i Schematron — bez Javy, z własnymi zestawami reguł.
Właśnie opublikowaliśmy nasz pierwszy pakiet open source: peppol-validator, małą bibliotekę npm, która waliduje dokumenty UBL 2.1 i Peppol BIS — faktury, noty kredytowe, zamówienia, awiza wysyłki, katalogi, application response — zarówno względem struktury XSD, jak i reguł biznesowych Schematron. Jest na licencji MIT i darmowa w użyciu.
Dlaczego udostępnić walidator jako open source
Dokument nie jest „prawidłowy" tylko dlatego, że to poprawnie sformułowany XML. Musi przejść rygorystyczne kontrole strukturalne (XSD) i reguł biznesowych (Schematron) dla EN 16931, Peppol BIS lub XRechnung — a poprawne zestawienie tego potoku jest żmudne. Walidacja jest jednak towarem powszechnym: sprawdza dokumenty, nie generuje ich. Dlatego wydzieliliśmy tę warstwę z naszej platformy i wydaliśmy ją osobno.
Co potrafi
Walidacja XSD działa od razu — schematy OASIS UBL 2.1 są dołączone, korzeń dokumentu jest wykrywany automatycznie (Invoice, CreditNote, Order, Catalogue, ApplicationResponse i więcej) i wybierany jest pasujący schemat. Schematron działa na SaxonJS, więc nie ma Javy ani JVM do zainstalowania.
- Walidacja XSD od razu gotowa (dołączone schematy OASIS UBL 2.1).
- Walidacja Schematron przez SaxonJS — czysty JavaScript, bez JVM.
- Automatycznie wykrywa typ dokumentu; jedno API dla faktur i całej rodziny dokumentów zakupowych.
- Wzmocnione parsowanie: encje zewnętrzne, ładowanie DTD i dostęp sieciowy wyłączone; rozmiar wejścia ograniczony.
Przynieś własne zestawy reguł
Świadomy wybór projektowy: zestawy reguł Schematron Peppol, EN 16931 i XRechnung nie są rozpowszechniane wewnątrz pakietu — należą do odpowiednich organów. Zamiast tego peppol-validator zawiera kompilator, który lokalnie zamienia pobrane oficjalne pliki .sch w wykonywalne artefakty SEF, dzięki czemu zawsze pozostajesz w granicach warunków zaakceptowanych przy pobieraniu. Dostarczane są tylko XSD OASIS UBL oraz szkielet ISO Schematron na licencji MIT.
Pierwsze kroki
Zainstaluj go poleceniem „npm install peppol-validator". Wywołaj validateXsd(xml), aby uzyskać natychmiastową kontrolę strukturalną, lub validate(xml, { sef }), aby uruchomić XSD oraz skompilowany zestaw reguł Schematron w jednym wywołaniu. Otrzymasz czytelny raport z identyfikatorami i komunikatami reguł, które zawiodły.
Zobacz peppol-validator na npmJak ma się to do MyInvoice
peppol-validator to otwarta warstwa walidacji MyInvoice. Walidator sprawdza dokumenty; platforma MyInvoice idzie dalej — konwertuje dane, które już posiadasz (CSV, Excel, UBL, EDIFACT lub starszy XML), na zgodny dokument EN 16931 w potrzebnym profilu, waliduje go w ten sam sposób i łączy się z Twoim ERP. Jeśli musisz tylko sprawdzać pliki, wystarczy pakiet npm; jeśli musisz generować zgodne faktury, właśnie do tego służy MyInvoice.