Preskočiť na obsah
Späť na blog
Open sourcePublikované 21. júna 20265 min čítania

Zverejnili sme peppol-validator ako open source — bezplatný npm na validáciu faktúr UBL a Peppol

peppol-validator je bezplatný npm balík s licenciou MIT, ktorý validuje dokumenty UBL 2.1 / Peppol BIS / EN 16931 voči XSD a Schematronu — bez Javy, s vlastnými súbormi pravidiel.

Práve sme zverejnili náš prvý open source balík: peppol-validator, malú npm knižnicu, ktorá validuje dokumenty UBL 2.1 a Peppol BIS — faktúry, dobropisy, objednávky, dodacie avíza, katalógy, application response — voči štruktúre XSD aj voči obchodným pravidlám Schematron. Je s licenciou MIT a zadarmo na použitie.

Prečo dať validátor ako open source

Dokument nie je „platný" len preto, že je to dobre formované XML. Musí prejsť prísnymi štruktúrnymi (XSD) a obchodno-pravidlovými (Schematron) kontrolami pre EN 16931, Peppol BIS alebo XRechnung — a správne zostaviť tento reťazec je zložité. Validácia je však bežný tovar: kontroluje dokumenty, negeneruje ich. Preto sme túto vrstvu vyňali z našej platformy a vydali ju samostatne.

Čo dokáže

Validácia XSD funguje hneď — schémy OASIS UBL 2.1 sú súčasťou, koreň dokumentu sa zisťuje automaticky (Invoice, CreditNote, Order, Catalogue, ApplicationResponse a ďalšie) a vyberie sa zodpovedajúca schéma. Schematron beží na SaxonJS, takže netreba inštalovať žiadnu Javu ani JVM.

  • Validácia XSD ihneď použiteľná (priložené schémy OASIS UBL 2.1).
  • Validácia Schematron cez SaxonJS — čistý JavaScript, žiadne JVM.
  • Automaticky zisťuje typ dokumentu; jedno API pre faktúry aj celú rodinu obstarávacích dokumentov.
  • Spevnené parsovanie: externé entity, načítanie DTD a sieťový prístup sú vypnuté; veľkosť vstupu je obmedzená.

Prineste si vlastné súbory pravidiel

Zámerné dizajnové rozhodnutie: súbory pravidiel Schematron pre Peppol, EN 16931 a XRechnung sa v balíku nedistribuujú — patria príslušným orgánom. Namiesto toho peppol-validator obsahuje kompilátor, ktorý oficiálne súbory .sch, ktoré si stiahnete, lokálne premení na spustiteľné artefakty SEF, takže vždy zostávate v rámci podmienok, ktoré ste pri sťahovaní prijali. Dodávané sú len OASIS UBL XSD a kostra ISO Schematron s licenciou MIT.

Začíname

Nainštalujte ho príkazom „npm install peppol-validator". Zavolajte validateXsd(xml) pre okamžitú štruktúrnu kontrolu alebo validate(xml, { sef }), aby ste spustili XSD plus skompilovaný súbor pravidiel Schematron v jednom volaní. Dostanete prehľadnú správu s ID a hláseniami pravidiel, ktoré zlyhali.

Pozrite peppol-validator na npm

Ako súvisí s MyInvoice

peppol-validator je otvorená validačná vrstva MyInvoice. Validátor kontroluje dokumenty; platforma MyInvoice ide ďalej — konvertuje údaje, ktoré už máte (CSV, Excel, UBL, EDIFACT alebo staršie XML), na súladný dokument EN 16931 v profile, ktorý potrebujete, validuje ho rovnakým spôsobom a pripája sa k vášmu ERP. Ak potrebujete len kontrolovať súbory, npm balík stačí; ak potrebujete generovať súladné faktúry, na to slúži práve MyInvoice.