Preskočiť na obsah
Späť na blog
NávodPublikované 21. júna 20265 min čítania

Validujte faktúru Peppol v Node.js za 5 minút

Návod krok za krokom: validujte faktúru UBL / Peppol BIS / EN 16931 v Node.js voči XSD a Schematronu pomocou bezplatného npm balíka peppol-validator — bez Javy.

Faktúry Peppol a EN 16931 sú prísne XML: súbor, ktorý „vyzerá v poriadku", môže aj tak zlyhať na pravidlách, ktoré vynucuje daňový úrad alebo sieť Peppol. V tomto návode jednu validujeme v Node.js za približne päť minút pomocou bezplatného, open source balíka peppol-validator — úplne bez Javy alebo JVM.

Čo potrebujete

  • Node.js 18 alebo novší.
  • Súbor XML faktúry (UBL Invoice alebo CreditNote) — nazvime ho invoice.xml.
  • Približne päť minút.

Krok 1 — Nainštalujte balík

npm install peppol-validator

Krok 2 — Skontrolujte štruktúru (XSD)

Najprv validujte XML voči schéme UBL 2.1. Schémy OASIS sú súčasťou, takže to nevyžaduje žiadnu konfiguráciu — koreňový prvok sa zistí automaticky.

import { readFileSync } from 'node:fs';
import { validateXsd } from 'peppol-validator';

const xml = readFileSync('./invoice.xml', 'utf-8');
const result = validateXsd(xml);

console.log(result.root, result.valid);   // e.g. "Invoice" true
if (!result.valid) console.error(result.errors);

result.valid vám povie, či je štruktúra správna; result.errors uvádza prípadné problémy s číslami riadkov. Tým sa chybné dokumenty zachytia okamžite.

Krok 3 — Pridajte obchodné pravidlá (Schematron)

XSD kontroluje len formu. Skutočné pravidlá EN 16931 a Peppol — súčty musia sedieť, kategórie DPH musia byť konzistentné, povinné polia musia byť prítomné — sídlia v Schematrone. Tieto súbory pravidiel nie sú súčasťou (patria OpenPEPPOL a ostatným orgánom), takže si raz stiahnete oficiálny .sch a skompilujete ho priloženým nástrojom:

# Download the official Peppol BIS Schematron (.sch) from docs.peppol.eu, then:
npx peppol-validator-compile PEPPOL-EN16931-UBL.sch ./artefacts/PEPPOL-EN16931-UBL.sef.json

Teraz spustite XSD a obchodné pravidlá spoločne v jednom volaní:

import { readFileSync } from 'node:fs';
import { validate, resolveSef } from 'peppol-validator';

const xml = readFileSync('./invoice.xml', 'utf-8');
const sef = resolveSef('peppol-bis-3', './artefacts');

const report = await validate(xml, { sef });

console.log('valid:', report.valid);
for (const e of report.schematron?.errors ?? []) {
  console.log(e.id + ': ' + e.message);
}

Krok 4 — Prečítajte výsledok

  • report.valid — celkový výsledok prešlo/neprešlo (XSD a Schematron spolu).
  • report.xsd.errors — štruktúrne problémy.
  • report.schematron.errors — porušenia obchodných pravidiel, každé s ID pravidla (napr. BR-CO-10) a čitateľnou správou.
  • report.schematron.warnings — nefatálne problémy, ktoré možno aj tak budete chcieť opraviť.

A to je všetko

V niekoľkých riadkoch máte štruktúrnu aj obchodno-pravidlovú validáciu pre Peppol BIS, EN 16931 alebo XRechnung — spustiteľnú všade, kde beží Node, bez Javy. Ukážte na iný skompilovaný súbor pravidiel, aby ste validovali ďalšie profily alebo obstarávacie dokumenty.

Získajte peppol-validator na npm

Kde sa hodí MyInvoice

peppol-validator kontroluje dokumenty. Ak ich potrebujete aj generovať — premeniť CSV, Excel, UBL, EDIFACT alebo údaje z vášho ERP na súladnú faktúru EN 16931 — presne to robí MyInvoice: konvertuje, validuje a vráti dokument pripravený na odoslanie cez jedno API.