Przejdź do treści
Powrót do bloga
Open sourceOpublikowano 21 czerwca 20265 min czytania

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 npm

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