eSLOG 2.0 XML: struktura, XSD in validacija e-računa
Na kratko: eSLOG 2.0 XML je strukturiran zapis e-računa, ki omogoča, da podatke z računa neposredno bere in preverja programska oprema. V XML-u so ločeno zapisani podatki o izdajatelju in prejemniku, dokumentu, postavkah, davkih, zneskih in plačilu. Pri tehnični kontroli je pomembna tudi XSD shema, ki določa pričakovano strukturo XML dokumenta. V tem vodiču se zato ne ukvarjamo ponovno predvsem z zakonodajo 2028, ampak gremo korak globlje: v strukturo eSLOG 2.0, validacijo in najpogostejše razloge, zaradi katerih strukturiran račun ni pravilno obdelan.
Če eSLOG 2.0 račun odprete v navadnem urejevalniku besedila, ne boste videli klasičnega računa, ampak XML zapis. To ni napaka. Namen strukturiranega e-računa je prav v tem, da posamezni podatki niso samo vizualno prikazani, temveč imajo določeno mesto in pomen, ki ga lahko razume tudi drug informacijski sistem.
Če vas zanima predvsem kdo bo moral uporabljati e-račune in kaj se spremeni 1. januarja 2028, smo to podrobno obdelali v ločenem vodiču o prehodu na e-račune. Tukaj se osredotočamo na drugo vprašanje: kaj je dejansko znotraj eSLOG 2.0 XML datoteke in kako sistem preveri, ali je tehnično pravilno sestavljena.
Kazalo
- Kaj je eSLOG 2.0 XML?
- Kaj vsebuje strukturiran eSLOG račun?
- Kako si predstavljati XML zapis v praksi?
- Kaj je XSD shema in čemu služi?
- Kako poteka tehnična validacija e-računa?
- Zakaj je lahko eSLOG XML zavrnjen?
- eSLOG XML in PDF nista ista stvar
- eSLOG, UBL in pot izmenjave: kaj je razlika?
- Kaj to pomeni pri UJP e-računu?
- Kako eSLOG 2.0 obravnava Račun123?
- Uradni viri
- Pogosta vprašanja
Kaj je eSLOG 2.0 XML?
eSLOG 2.0 je slovenski standard za strukturirane elektronske poslovne dokumente. Center za ePoslovanje Slovenije (EPOS) med dokumenti eSLOG 2.0 navaja račun, naročilo, potrditev naročila, dobavnico, prevzemnico, opomin, IOP in povratnico IOP.
Pri računu je bistveno, da so podatki zapisani v XML strukturi. Program zato ne potrebuje slike računa in mu ni treba ugibati, kje na dokumentu je številka računa, davčna stopnja ali znesek. Podatek dobi v strukturirani obliki, ki jo lahko programsko obdela.
Podatek
Na računu nastane poslovni podatek: številka, datum, postavka, DDV, znesek ali plačilo.
XML struktura
Podatek dobi določeno mesto in pomen v strukturiranem elektronskem dokumentu.
Strojna obdelava
Prejemni sistem lahko podatke preveri, uvozi in uporabi brez ponovnega prepisovanja.
Kaj vsebuje strukturiran eSLOG račun?
eSLOG račun ni eno samo polje z besedilom računa. Podatki so razdeljeni v logične skupine. Za podjetnika je pomembneje razumeti katere vrste podatkov se prenašajo kot pa poznati posamezne XML oznake na pamet.
| Skupina podatkov | Primeri | Kaj omogoča sistemu |
|---|---|---|
| Izdajatelj in prejemnik | naziv, naslov, identifikacijski in davčni podatki | Prepozna poslovna partnerja dokumenta. |
| Podatki dokumenta | številka, datum izdaje, valuta, roki | Enolično identificira in časovno umesti račun. |
| Postavke | opis, količina, cena, popust | Omogoča obdelavo posameznih vrstic računa. |
| Davčna obravnava | davčna stopnja, osnova, DDV in drugi podatki glede na primer | Prenese davčno strukturo dokumenta. |
| Zneski | osnova, DDV, popusti, končni znesek | Omogoča kontrolo in knjiženje vrednosti. |
| Plačilni podatki | IBAN, referenca, rok plačila | Podatke lahko uporabi nadaljnji finančni proces. |
Pomembno: strukturiran zapis ne pomeni, da sistem sam potrdi poslovno ali davčno pravilnost vsebine. XML je lahko tehnično pravilno sestavljen, izvorni poslovni podatek pa je kljub temu napačen. Tehnična validacija in vsebinska pravilnost računa sta dve različni stvari.
Kako si predstavljati XML zapis v praksi?
Poenostavljeno si lahko strukturiran račun predstavljamo kot dokument, kjer ima vsak pomemben podatek svojo oznako. Spodnji primer je didaktična ponazoritev in ne dejanski eSLOG 2.0 zapis:
<racun>
<stevilka>2026-00125</stevilka>
<datum>2026-10-07</datum>
<prejemnik>Primer d.o.o.</prejemnik>
<postavka>
<opis>Storitev</opis>
<kolicina>1</kolicina>
<cena>100.00</cena>
</postavka>
<znesekDDV>22.00</znesekDDV>
<zaPlacilo>122.00</zaPlacilo>
</racun>Pravi eSLOG dokument je bistveno natančneje definiran in uporablja strukturo ter elemente iz uradne dokumentacije. Namen primera je samo pokazati razliko med vizualnim računom in podatkovnim dokumentom: program ne bere položaja besedila na strani, temveč strukturirane elemente.
Kaj je XSD shema in čemu služi?
XSD (XML Schema Definition) je shema, s katero je mogoče preverjati strukturo XML dokumenta. EPOS ob dokumentaciji eSLOG objavlja tudi XSD sheme, UJP pa za svoje elektronske strukture objavlja ustrezne sheme in tehnično dokumentacijo.
Poenostavljeno: XSD je kot tehnično pravilo, ki programu pove, kateri elementi so pričakovani, v kakšni strukturi in kakšen tip podatka je dovoljen. Če XML odstopa od pričakovane sheme, ga lahko sistem zavrne še preden pride do nadaljnje poslovne obdelave.
XML
Vsebuje konkretne podatke posameznega računa.
XSD
Opisuje pričakovano strukturo in tipe podatkov XML dokumenta.
Validacija
Preveri, ali dokument ustreza pravilom, ki jih mora prejemni sistem razumeti.
Kako poteka tehnična validacija e-računa?
Pri strukturiranem e-računu ni dovolj, da je dokument videti pravilen. Ker ga obdeluje programska oprema, mora biti pravilno sestavljen tudi v ozadju. V praksi je smiselno ločiti več ravni kontrole:
- XML mora biti tehnično veljaven. Dokument mora biti pravilno oblikovan XML.
- Struktura mora ustrezati pričakovani shemi. Pri tem se uporablja XSD oziroma druga pravila konkretnega standarda.
- Obvezni in povezani podatki morajo biti smiselno izpolnjeni. Sistem lahko poleg same sheme uporablja dodatna poslovna oziroma implementacijska pravila.
- Dokument mora ustrezati zahtevam poti izmenjave. UJP oziroma druga e-pot ima svojo tehnično dokumentacijo, ovojnice, identifikatorje in statuse.
Za podjetnika je bistveno: XSD in XML pravil praviloma ne bi smel preverjati ročno. Poslovni program mora tehnični del čim bolj skriti v ozadje, uporabniku pa jasno pokazati, če manjka podatek ali če dokumenta ni mogoče pravilno pripraviti oziroma poslati.
Zakaj je lahko eSLOG XML zavrnjen?
Ko strukturiran dokument ni uspešno obdelan, izraz »XML ne dela« ne pove veliko. Napaka je lahko na različnih ravneh. Za odpravljanje težav je zato pomembno najprej ugotoviti, ali je težava v strukturi, podatkih ali sami poti izmenjave.
| Vrsta težave | Kaj pomeni | Kaj preveriti |
|---|---|---|
| Neveljaven XML | Dokument ni pravilno oblikovan XML. | Generiranje datoteke in tehnično napako. |
| Neskladnost s shemo | Element, vrstni red ali tip podatka ne ustreza pričakovani strukturi. | XSD validacijo in uporabljeno verzijo standarda. |
| Manjkajoč ali neustrezen podatek | Struktura obstaja, vendar za konkretni proces manjka zahtevan podatek. | Partnerja, davčne podatke, reference, identifikatorje in zahteve prejemnika. |
| Napaka e-poti | Dokument je lahko pravilen, težava pa nastane pri pošiljanju ali usmerjanju. | Ovojnico, naslovnika, pravice, status in odgovor sistema. |
| Vsebinska napaka | Tehnično pravilen dokument vsebuje napačen poslovni podatek. | Izvorne podatke računa; XSD tega sam ne more potrditi. |
eSLOG XML in PDF nista ista stvar
XML je strukturiran podatkovni dokument, PDF pa je predvsem vizualna predstavitev za človeka. Pri UJP je lahko PDF dodan kot priloga oziroma vizualizacija e-računa, vendar to ne spremeni vloge strukturiranega dokumenta.
To razlikovanje je pomembno tudi pri avtomatizaciji. Pri strukturiranem e-računu lahko sistem podatke bere neposredno iz strukture. Pri navadnem PDF-ju brez uporabne strukture je za avtomatsko zajemanje podatkov praviloma potrebna dodatna obdelava, na primer OCR oziroma AI prepoznava.
Ne mešajte pojmov: PDF lahko uporabniku pokaže popolnoma pravilen račun, vendar iz tega še ne sledi, da gre za strukturiran eSLOG dokument. Nasprotno pa XML ni namenjen temu, da bi ga podjetnik vsak dan ročno odpiral in bral.
eSLOG, UBL in pot izmenjave: kaj je razlika?
Pri e-računih se pogosto v istem stavku pojavijo eSLOG, UBL, UJP in PEPPOL, čeprav ne pomenijo iste stvari. Najbolj uporabna ločnica je med formatom oziroma strukturo dokumenta in potjo, po kateri dokument potuje.
| Pojem | Kaj predstavlja |
|---|---|
| eSLOG 2.0 | Slovenski standard oziroma strukturiran zapis elektronskih poslovnih dokumentov. |
| UBL 2.1 | Drug strukturiran standard za elektronske poslovne dokumente. |
| UJP | Sistem in vstopna oziroma izstopna točka za izmenjavo e-računov s proračunskimi uporabniki. |
| PEPPOL | Infrastruktura oziroma okvir za standardizirano elektronsko izmenjavo dokumentov; ni sinonim za eSLOG format. |
Ta razlika je pomembna zato, ker lahko isti poslovni problem vključuje izbiro ustrezne strukture dokumenta in izbiro ustrezne elektronske poti. To sta povezani, vendar ločeni tehnični vprašanji.
Kaj to pomeni pri UJP e-računu?
UJP v aktualni tehnični dokumentaciji za e-račune navaja strukturirane račune v standardih e-SLOG 2.0, UBL 2.1 in CEFACT 100.D16B. E-račun se v sistem pošilja skupaj z ustrezno ovojnico, dodatne priloge pa so lahko tudi druge datoteke, na primer PDF za vizualizacijo.
Če izdajate račune javnemu sektorju: Račun123 podpira UJP e-račune v eSLOG 2.0. Uporabniku zato ni treba ročno sestavljati XML datoteke ali XSD sheme; račun pripravi iz poslovnih podatkov v aplikaciji, tehnični del pa prevzame sistem.
Več o samem postopku poslovanja s proračunskimi uporabniki je bolje obravnavati ločeno, zato ga tukaj namenoma ne ponavljamo. Za to je namenjena stran UJP e-računi za javni sektor.
Kako eSLOG 2.0 obravnava Račun123?
Račun123 že danes podpira eSLOG 2.0, UJP e-račune in XML eSLOG 2.0 izvoze za računovodstvo. Na aktualnem ceniku je podpora za e-račune eSLOG 2.0 + UJP vključena od paketa Osnovni dalje.
| Funkcionalnost | Aktualni status |
|---|---|
| eSLOG 2.0 | Na voljo danes |
| UJP e-računi | Na voljo danes |
| XML eSLOG 2.0 izvoz | Na voljo danes |
| Celovita B2B izmenjava | V pripravi – cilj konec 2026 oziroma najpozneje Q1 2027 |
| UBL / PEPPOL | V pripravi za 2027 |
Iz prakse: uporabnik ne bi smel poznati imen XML elementov ali ročno preverjati XSD sheme, da lahko izda e-račun. Tehnični standard je pomemben predvsem zato, da se sistemi med seboj razumejo. Za podjetnika pa je prava vrednost v tem, da podatke vnese enkrat, program pa iz njih pripravi ustrezen dokument za prejemnika, računovodstvo in elektronsko izmenjavo.
— Gašper Parte, ustanovitelj in idejni vodja aplikacije Račun123
Uradni viri
- EPOS – eSLOG in uradna dokumentacija standarda
- UJP – strukture in šifranti za elektronsko izmenjavo datotek
- GOV.SI – izmenjava e-računov s proračunskimi uporabniki
Prispevek je splošne informativne narave. Pri tehnični implementaciji vedno uporabljajte aktualno dokumentacijo konkretnega standarda in uporabljene poti izmenjave.
Pogosta vprašanja
Kaj je eSLOG 2.0 XML?
eSLOG 2.0 XML je strukturiran elektronski zapis poslovnega dokumenta. Pri e-računu so podatki zapisani tako, da jih lahko informacijski sistem strojno prebere in obdela brez prepisovanja iz vizualnega računa.
Kaj vsebuje eSLOG 2.0 račun?
Strukturiran račun vsebuje podatke o izdajatelju in prejemniku, dokumentu, postavkah, davčni obravnavi, zneskih in plačilu. Natančna struktura je določena v uradni dokumentaciji standarda.
Kaj je XSD pri eSLOG 2.0?
XSD je XML shema, s katero je mogoče preverjati, ali struktura XML dokumenta ustreza pričakovanim pravilom. EPOS ob dokumentaciji eSLOG objavlja tudi XSD sheme.
Ali XSD validacija pomeni, da je račun vsebinsko pravilen?
Ne. XSD preverja predvsem strukturo XML dokumenta in tipe podatkov. Tehnično veljaven XML lahko še vedno vsebuje napačen poslovni ali davčni podatek.
Zakaj je lahko eSLOG XML zavrnjen?
Razlog je lahko neveljaven XML, neskladnost s pričakovano shemo, manjkajoč ali neustrezen podatek, zahteva prejemnega sistema ali napaka pri elektronski poti oziroma usmerjanju dokumenta.
Ali je eSLOG XML isto kot PDF račun?
Ne. XML je strukturiran podatkovni dokument, PDF pa je predvsem vizualna predstavitev za človeka. Pri UJP e-računu je PDF lahko dodan kot priloga oziroma vizualizacija.
Ali sta eSLOG in UBL ista standarda?
Ne. Gre za različna strukturirana standarda. UJP pri e-računih trenutno navaja e-SLOG 2.0, UBL 2.1 in CEFACT 100.D16B.
Ali mora uporabnik Račun123 sam ustvarjati eSLOG XML?
Ne. Račun123 že podpira eSLOG 2.0 in UJP e-račune. Uporabnik račun pripravi iz poslovnih podatkov v aplikaciji, strukturiran dokument pa pripravi sistem.
