Peppol BIS 3.0 a UBL faktúra: technický sprievodca
Stručný prehľad pojmov a štruktúry dokumentov. Na produkčné validácie použite oficiálne nástroje a váš prístupový bod Peppol.
Úvod pre laikov: Čo je e-faktúra. Konvertor: XML na JSON.
Čo presne znamená „Peppol BIS Billing 3.0“
Peppol (Pan-European Public Procurement OnLine) je sieť a súbor technických špecifikácií na výmenu štandardizovaných obchodných dokumentov medzi organizáciami. V kontexte faktúr sa najčastejšie stretnete s profilom Peppol BIS Billing 3.0, ktorý definuje, ako má vyzerať elektronická faktúra a súvisiace správy v rámci tejto siete. Profil stojí na norme EN 16931 a na formáte UBL 2.1, čo znamená, že základné polia sú medzinárodne zosúladené, zatiaľ čo Peppol pridáva pravidlá pre praktickú interoperabilitu v sieti.
Číslo „3.0“ označuje generáciu billing špecifikácie. Pre implementátora to znamená, že má používať aktuálne XSD schémy, obchodné pravidlá a príklady zverejnené v Peppol dokumentácii, nie staršie verzie z minulého desaťročia. Pre používateľa účtovníctva je dôležité, že softvér musí exportovať presne tie polia, ktoré profil očakáva — inak môže validátor na strane prístupového bodu dokument odmietnuť.
Na Slovensku sa Peppol spomína v súvislosti s európskymi požiadavkami a s prípravou firiem na elektronickú fakturáciu podľa zákona č. 385/2025 Z. z. Samotná sieť nie je „slovenský vynález“, ale nástroj, ktorý uľahčuje cezhraničný obchod a prepojenie s verejnými odberateľmi tam, kde to dáva zmysel.
Kto sú účastníci: prístupový bod, AP a SMP
Prístupový bod (Access Point v angličtine) je technická brána, ktorá pripája váš interný systém k sieti Peppol. Správy medzi účastníkmi neposielate priamo e-mailom, ale cez certifikovanú infraštruktúru, ktorá zabezpečuje spoľahlivosť a identifikáciu. Pre malú firmu to často znamená zmluvu s poskytovateľom AP a nastavenie identifikátora v systéme.
Service Metadata Publisher (SMP) súvisí s publikovaním metadát o tom, ktoré dokumenty dokáže organizácia prijímať a na akých adresách. Pri hľadaní Peppol ID partnera sa používajú mechanizmy DNS a SMP — ide o pokročilú tému, ktorú na efakturator.sk zatiaľ neriešime automatizovaným vyhľadávaním, ale je dobré vedieť, že existuje.
Ak ste dodávateľ softvéru, budete čítať špecifikácie pre AS4 alebo iný transportný profil podľa toho, čo vyžaduje váš AP. Ak ste účtovník, stačí vedieť, že „AP vybaví technické doručenie“ a vy riešite obsah faktúry.
UBL 2.1 ako nosič dát
UBL 2.1 používa XML strom s presne definovanými názvami elementov v menných priestoroch `cbc` (common basic components) a `cac` (common aggregate components). Faktúra typicky obsahuje koreň `Invoice` alebo `CreditNote` s identifikátormi, dátumami, stranami, riadkami, daňami a monetárnymi súčtmi.
Peppol BIS Billing 3.0 vyberá podmnožinu polí z EN 16931 a pridáva obchodné pravidlá — napríklad ktoré kombinácie identifikátorov sú povolené alebo ako sa má správať pri určitých typoch transakcií. Preto nie je každý UBL súbor automaticky „Peppol ready“ — musí spĺňať profil.
Pri čítaní XML v textovom editore hľadajte koreň a namespace deklarácie. Ak vám to príde neprehľadné, použite konvertor XML na JSON na efakturator.sk a potom nájdite vetvu s dodávateľom alebo odberateľom.
EN 16931 a európske jadro e-faktúry
Norma EN 16931 definuje sémantický model e-faktúry — čo znamenajú polia ako číslo faktúry, dátumy, sumy a identifikátory strán. Peppol profil z tohto modelu vychádza a prispôsobuje ho pre sieť. Ak váš systém hovorí, že exportuje EN 16931 compliant faktúru, mal by byť konzistentný s týmto modelom, ale stále treba overiť konkrétny profil (Peppol alebo národný).
Pre IT tím je dôležité čítať „semantic data model“ a mapovanie na UBL elementy. Pre účtovníka je dôležité, že ak chýba pole, ktoré norma považuje za povinné v danej situácii, môže byť faktúra neplatná alebo neprijateľná pre štátny systém.
Slovenská implementácia môže pridať národné pravidlá k európskemu jadru. Preto kombinujte tento technický úvod s oficiálnymi materiálmi Finančnej správy SR a IS EFA.
Typické bloky v UBL faktúre
Hlavička obsahuje `cbc:ID` (číslo faktúry), `cbc:IssueDate`, prípadne `cbc:DueDate` a meny. Dodávateľ je v `cac:AccountingSupplierParty` a odberateľ v `cac:AccountingCustomerParty`. Tieto bloky obsahujú adresné údaje a identifikátory ako IČO v slovenskom kontexte alebo iné schémy identifikácie v zahraničí.
Riadky faktúry sú v `cac:InvoiceLine` s množstvami, jednotkovými cenami a sumami. Dane sú v `cac:TaxTotal` a súhrnné čísla v `cac:LegalMonetaryTotal`. Poznámky môžu byť v `cbc:Note`. Presné názvy sa môžu líšiť podľa toho, či používate qualified names alebo prefixy, ale logika zostáva.
Pri mapovaní do PDF alebo HTML náhľadu berieme tieto bloky a zobrazujeme ich so slovenskými popismi, aby bol výsledok zrozumiteľný pre človeka, ktorý nečíta XML.
Validácia: XSD, Schematron a prax
XSD schéma kontroluje štruktúru XML — či sú elementy na správnych miestach a majú správne typy. Schematron pridáva obchodné pravidlá typu „ak je pole A, musí byť aj pole B“. Peppol poskytuje pravidlá pre validáciu profilu. Na efakturator.sk zatiaľ nespúšťame plný Schematron engine — ide o zjednodušenie nasadenia. Pre produkčné nasadenie použite validátor od vášho AP alebo ERP.
V praxi sa stáva, že XSD prejde, ale Schematron zlyhá kvôli chýbajúcemu identifikátoru alebo nesprávnemu kódu krajiny. Preto je dobré mať testovacie prostredie a sadu vzorových faktúr.
Ak potrebujete len vizuálnu kontrolu, stačí náš prehliadač. Ak potrebujete certifikovanú validáciu, musíte ísť cez nástroje určené na to.
Dobropisy a opravné doklady
V UBL existuje `CreditNote` ako samostatný koreň pre dobropis alebo súvisiace typy dokumentov podľa profilu. Pri implementácii treba rozlišovať, či systém generuje opravu ako nový dokument s odkazom na pôvodnú faktúru, alebo používa iný mechanizmus podľa zákona a zmluvy.
Peppol pravidlá špecifikujú, ako majú byť vyplnené referenčné polia na prepojenie dokladov. Nesprávne prepojenie môže spôsobiť, že odberateľ systémom dobropis nepriradí k pôvodnej pohľadávke.
Pre účtovníka je kľúčové, aby čísla a odkazy sedeli s účtovnou agendou — technológia len zrýchli detekciu nesúladu.
Bezpečnosť a podpisovanie
Peppol infraštruktúra používa overené spojenia medzi prístupovými bodmi. Samotný obsah faktúry môže byť podpísaný alebo chránený podľa národných požiadaviek a zmlúv. Pri práci s našou stránkou si uvedomte rozdiel medzi konverziou v prehliadači a generovaním PDF na serveri — pri PDF ide o krátkodobé spracovanie v pamäti.
Ak váš interný predpis vyžaduje kvalifikovaný elektronický podpis, riešte to v ERP alebo v systéme, ktorý je na to určený. efakturator.sk zatiaľ nepridáva kvalifikovaný podpis k PDF.
Pri odosielaní cez Peppol rieši identitu a autenticitu infraštruktúra AP — preto je dôležité mať správne nastavené certifikáty a oprávnenia.
Integračný checklist pre vývojára
1) Získajte XSD a Schematron pravidlá pre Peppol BIS Billing 3.0. 2) Namapujte interný dátový model na UBL elementy. 3) Pripravte export, ktorý produkuje validné XML v UTF-8. 4) Otestujte na vzorke faktúr z vášho odvetvia (služby, tovar, mix DPH). 5) Napojte sa na AP dodávateľa a overte prijatie v testovacom prostredí.
Ak používate JSON medzikrok, pamätajte, že finálny výstup do Peppol siete je typicky XML podľa profilu. JSON môže byť len interný tvar.
Logovanie chýb z validátora ukladajte bez osobných údajov alebo ich anonymizujte, aby ste spĺňali GDPR pri vývoji.
Slovenský kontext a IS EFA
Informačný systém IS EFA a materiály Finančnej správy SR budú určovať národné podrobnosti prijímania a evidencie e-faktúr. Peppol môže byť súčasťou celkového obrazu, ale nie je automaticky jediný kanál pre každú transakciu. Sledujte oficiálne oznámenia, aby ste neprenášali zastaralé závery z diskusií na sociálnych sieťach.
Pre podnikateľa je dôležité, že technické smerovanie je jednotné smerom k štruktúrovaným faktúram — či už cez Peppol, alebo cez národné rozhranie, záleží od typu obchodu a od odberateľa.
Ak ste poskytovateľ služieb, pripravte dokumentáciu pre zákazníkov v slovenčine s odkazmi na oficiálne zdroje a s praktickými príkladmi exportu.
Časté omyly pri čítaní špecifikácií
Omyl číslo jeden: zamieňať „UBL“ a „Peppol“ ako úplne totožné pojmy. Omyl číslo dva: myslieť si, že PDF je dostatočná náhrada za štruktúrovanú faktúru vo všetkých prípadoch. Omyl číslo tri: podceniť Schematron pravidlá, lebo „XML sa otvorí v prehliadači“.
Omyl štyri: ignorovať kódovanie znakov — diakritika v slovenských menách a adresách musí zostať zachovaná. Omyl päť: predpokladať, že jeden export funguje pre všetkých odberateľov bez úprav — veľkí odberatelia môžu mať doplnkové požiadavky.
Ak si nie ste istí, overte sa u svojho AP poskytovateľa alebo v testovacom prostredí. Praktické testy sú cennejšie než dlhé diskusie bez dát.
Záver: ako ďalej s efakturator.sk
Použite našu stránku na vizuálnu kontrolu UBL súboru a na konverziu medzi XML a JSON pri interných testoch. Na produkčné validácie použite oficiálne nástroje a validátory vášho ekosystému.
Sledujte aktualizácie Peppol BIS Billing špecifikácie — verzie sa menia a je rozumné mať proces, ako aktualizovať mapovania vo vašom ERP.
Veríme, že tento technický úvod skráti čas strávený čítaním cudzích skratiek a pomôže vám rozumne komunikovať s dodávateľom softvéru aj s účtovníkom.