Peppol BIS Billing 3.0 vs UBL 2.1 — vysvetlenie pre netechnikov

Krátka odpoveď

• UBL 2.1 opisuje XML syntax a štruktúru viacerých obchodných dokumentov vrátane faktúry a dobropisu.
• Peppol BIS Billing 3.0 vyberá z tejto širokej syntaxe konkrétny fakturačný profil a pridáva pravidlá potrebné na interoperabilitu.
• EN 16931 definuje európsky sémantický model faktúry: aký význam majú obchodné údaje bez ohľadu na konkrétnu syntax.
• Slovenská technická dokumentácia dopĺňa pravidlá a mapovania potrebné pre slovenský režim eFaktúry.

Zjednodušene: UBL je jazyk zápisu, EN 16931 je význam údajov a Peppol BIS Billing je konkrétny návod, ako tieto údaje zapísať a kontrolovať pri Peppol fakturácii.

Prečo nestačí povedať „podporujeme UBL“

UBL povoľuje veľa dokumentov, polí a kombinácií. Dva súbory môžu byť technicky platné podľa XML schémy UBL, no jeden z nich nemusí spĺňať európske obchodné pravidlá ani Peppol profil.

Pre praktickú kompatibilitu treba preukázať celý reťazec:

1. XML je správne vytvorené podľa použitej syntaxe.
2. Údaje spĺňajú EN 16931.
3. Dokument spĺňa aktuálne pravidlá Peppol BIS Billing.
4. Dokument prejde aktuálnymi slovenskými validačnými pravidlami.
5. Obe strany podporujú rovnaký identifikátor dokumentu, procesu a adresovanie.

Preto sa dodávateľa softvéru nepýtajte iba na „UBL export“. Pýtajte si presný profil, verziu pravidiel a výsledok testu proti aktuálnemu validátoru.

Čo je UBL 2.1

Universal Business Language je otvorený štandard OASIS pre štruktúrované obchodné dokumenty. Obsahuje napríklad dokumenty Invoice, CreditNote, Order a DespatchAdvice. XML schéma určuje, ktoré elementy a dátové typy možno v dokumente použiť.

Zjednodušený fragment UBL faktúry môže vyzerať takto:

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
  <cbc:ID>2026-001</cbc:ID>
  <cbc:IssueDate>2026-08-20</cbc:IssueDate>
  <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
</Invoice>

Takýto krátky fragment nie je hotovou faktúrou a nemá slúžiť ako produkčná šablóna. Iba ukazuje syntax.

Čo pridáva Peppol BIS Billing 3.0

Peppol BIS Billing určuje najmä:

• povinné, voliteľné a zakázané použitie polí,
• obchodné pravidlá pre sumy, dane, meny, identifikátory a referencie,
• presné identifikátory dokumentu a procesu,
• mapovanie medzi obchodnými termínmi EN 16931 a UBL,
• validačné artefakty, ktoré dopĺňajú základnú XML schému.

Validácia preto nekončí pri XSD. Obchodné pravidlá sa typicky kontrolujú pomocou Schematronu. Dokument môže byť syntakticky platné XML a napriek tomu skončiť fatálnou chybou obchodného pravidla.

Aktuálna verzia k 20. augustu 2026

Oficiálna dokumentácia OpenPeppol uvádza vydanie Peppol BIS Billing 3.0.21, publikované 20. mája 2026 a povinné od 17. augusta 2026. Aktualizácia zahŕňa nové validačné artefakty a pravidlá; integračný tím preto nemá natvrdo predpokladať, že starý validačný balík zostáva aktuálny.

„Peppol BIS Billing 3.0“ je rodina priebežne aktualizovaných pravidiel, nie jednorazová nemenná verzia. V dokumentácii a testoch evidujte aj konkrétne vydanie validačných artefaktov.

Kde je slovenská vrstva

Finančná správa zverejňuje slovenskú technickú dokumentáciu, transpozíciu Peppol BIS a testovacie zdroje. Tie treba čítať spolu s medzinárodným profilom. Slovenské identifikátory, daňové mapovania alebo lokálne obmedzenia nemožno spoľahlivo odvodiť iba zo všeobecnej UBL schémy.

Aktuálne FAQ Finančnej správy opisuje štruktúrovanú eFaktúru v syntaxi UBL alebo UN/CEFACT CII. Pri konkrétnom slovenskom Peppol toku však implementujte iba kombináciu syntaxe, dokumentového profilu a pravidiel, ktorú podporuje aktuálna slovenská technická dokumentácia a váš poskytovateľ.

Formát dokumentu nie je transport

Častá chyba je zamieňať obsah a doručenie:

Peppol BIS Billing nie je REST API a UBL nie je doručovacia sieť. API, autentizáciu, webhooky a stavový model určuje konkrétny poskytovateľ.

Čo má overiť účtovník

Účtovník nemusí ručne čítať XML. Potrebuje však vedieť:

• či systém zachová pôvodný dokument,
• ako zobrazí chýbajúce alebo nesprávne údaje,
• ako sa vytvára faktúra k prijatej platbe a opravný doklad,
• ako sa preukáže referencia na pôvodný doklad,
• či sa sumy a DPH po importe zhodujú s pôvodným XML.

Čo má overiť vývojár

• presné hodnoty CustomizationID a ProfileID pre podporovaný tok,
• XSD a všetky relevantné Schematron pravidlá,
• verziu slovenských validačných artefaktov,
• povolené schémy identifikátorov strán,
• zaokrúhľovanie, súčty, daňové kategórie a meny,
• faktúru, dobropis a ďalšie podporované typy dokladov,
• výsledok v oficiálnom testbede a v testovacom prostredí poskytovateľa.

Nevytvárajte vlastný profil len preto, že ho UBL schéma dovolí. Každá odchýlka musí mať oporu v podporovanej špecifikácii.

Praktické zhrnutie

Kde testovať

Použite oficiálny OpenPeppol Testbed a testovacie prostredie vybraného poskytovateľa. Testujte syntetické doklady; platný výsledok jedného príkladu nie je náhradou za celý testovací balík faktúr, opráv, príloh a chybových stavov.

Pokračujte cez európsku normu EN 16931, slovenskú transpozíciu Peppol BIS a zdroje pre vývojárov.