XML datoteka je tekstualna datoteka u kojoj su podaci zapisani unutar oznaka koje ih opisuju, primjerice <cijena>19.90</cijena>. Elementi se mogu ugnježđivati, pa jedan <proizvod> sadrži naziv, cijenu i zalihu. XML (Extensible Markup Language) je preporuka W3C-a od veljače 1998. i danas nosi sitemape, feedove proizvoda, eRačune i, od studenoga 2026., cjenike na hrvatskim web stranicama.
Kako je XML datoteka građena
XML nema unaprijed zadane oznake. Onaj tko definira format sam odlučuje hoće li element zvati <proizvod>, <artikl> ili <item>. Zato je XML „proširiv”: isti jezik služi i za popis stranica i za račun s pedeset polja.
Svaka datoteka ima nekoliko istih dijelova:
- prolog u prvom retku,
<?xml version="1.0" encoding="UTF-8"?>, koji kaže verziju i kodiranje znakova - jedan korijenski element koji obuhvaća sve ostalo
- elemente s početnom i završnom oznakom,
<naziv>i</naziv>, između kojih stoji vrijednost - atribute unutar početne oznake, primjerice
valuta="EUR", za kratke dodatne podatke - prostore imena (namespace), poput
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9", koji govore čiji je to rječnik oznaka
Pravila su stroga. Svaka otvorena oznaka mora se zatvoriti, oznake se ne smiju preklapati, a <Cijena> i <cijena> su dva različita elementa. Znakovi < i & ne smiju stajati sami u tekstu. Pišu se kao < i &, pa se tvrtka „Kovač & sinovi” u XML-u zapisuje kao Kovač & sinovi. Datoteka koja poštuje ta pravila zove se ispravno oblikovana (well-formed). Ako ih prekrši na jednom mjestu, program je odbije cijelu.
Primjer: jedan proizvod u XML-u
Recimo da webshop izvozi proizvod za usporednik cijena. Pojednostavljeno, zapis izgleda ovako:
<?xml version="1.0" encoding="UTF-8"?>
<katalog trgovina="primjer.hr">
<proizvod sifra="KV-2041">
<naziv>Keramička vaza, bijela, 30 cm</naziv>
<cijena valuta="EUR">24.90</cijena>
<zaliha>12</zaliha>
<varijante>
<varijanta boja="bijela" />
<varijanta boja="siva" />
</varijante>
</proizvod>
</katalog>
| Dio | U primjeru | Što znači |
|---|---|---|
| Prolog | <?xml version="1.0" encoding="UTF-8"?> | XML 1.0, kodiranje UTF-8, pa č, ć, š, ž i đ ostaju ispravni |
| Korijenski element | <katalog> | sve ostalo je unutar njega |
| Atribut | sifra="KV-2041" | kratak podatak uz element |
| Ugniježđeni elementi | <varijante> unutar <proizvod> | jedan proizvod ima više varijanti |
| Prazni element | <varijanta boja="siva" /> | nosi samo atribut, bez vrijednosti |
Trgovina, šifra i cijena su izmišljeni. Važno je uočiti decimalnu točku u 24.90: strojevi očekuju nju, a ne hrvatski decimalni zarez.
Shema: kada je XML i valjan
Ispravno oblikovana datoteka nije nužno i valjana. Valjanost znači da datoteka odgovara shemi, obično XSD datoteci, koja propisuje koji elementi postoje, kojim redom dolaze, koji su obavezni i kakve vrijednosti primaju. Kod sitemapa shema kaže da <loc> mora biti adresa. Kod eRačuna shema i dodatna pravila provjeravaju desetke polja, od OIB-a do zbroja PDV-a.
Zato XML za službene namjene gotovo nikad ne pišete ručno. Program ga generira, a validator provjeri prije slanja. Porezna uprava objavljuje vlastiti validator eRačuna i povremeno ga ažurira.
Gdje ćete ga sresti
Sitemap je XML datoteka s popisom adresa koje tražilica treba poznavati, obično na /sitemap.xml. Google propisuje kodiranje UTF-8 i ograničenje od 50.000 adresa ili 50 MB po datoteci, a veće stranice sitemap dijele na više datoteka i jedan indeks. Polja <priority> i <changefreq> Google zanemaruje, a <lastmod> uzima u obzir samo ako je dosljedno točan.
RSS feed bloga ili podcasta također je XML, kao i dio feedova proizvoda za Google Merchant Center. Mnogi webshopovi feed za Merchant Center šalju kao XML jer podnosi varijante, više slika i oznake na jednom proizvodu.
eRačun je XML
Od 1. siječnja 2026. obveznici PDV-a u Hrvatskoj međusobno razmjenjuju eRačune: XML zapise prema europskoj normi EN 16931. FINA u tehničkoj specifikaciji navodi dvije dopuštene sintakse, UBL i CII, i sheme za UBL 2.1. Hrvatska prilagodba upisuje se u polje CustomizationID:
<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:mfin.gov.hr:cius-2025:1.0#conformant#urn:mfin.gov.hr:ext-2025:1.0</cbc:CustomizationID>
Ta jedna linija kaže primatelju da račun slijedi europsku normu, hrvatsku specifikaciju osnovne uporabe i njezina proširenja. Kad u poruci dobijete XML eRačuna, otvorite ga programom za knjigovodstvo ili preglednikom eRačuna, jer sirovi kod nije namijenjen čitanju.
Cjenik na web stranici
Odluka o objavi cjenika proizvoda i usluga (NN 101/2026) traži od trgovaca i pružatelja usluga koji imaju web stranicu da na njoj objave cjenik u strojno čitljivoj datoteci, CSV ili XML. Vlada je početak primjene odgodila na 17. studenoga 2026., a referentni datum za cijene ostaje 10. rujna 2026. Ministarstvo gospodarstva najavilo je pravilnike koji će detaljnije urediti sadržaj i način objave, pa provjerite njihovu konačnu verziju. Što cjenik mora sadržavati i kako ga složiti, opisano je u vodiču Cjenik u CSV ili XML formatu na web stranici, a uz istu obvezu ide i sidrena cijena.
XML, CSV i JSON
| XML | CSV | JSON | |
|---|---|---|---|
| Oblik | oznake i ugniježđeni elementi | tablica, jedan red po zapisu | parovi ključ i vrijednost, ugniježđeni objekti |
| Varijante i podstavke | prirodno | teško, svaka varijanta postaje novi red | prirodno |
| Provjera shemom | XSD, vrlo stroga | ne postoji standardna | JSON Schema |
| Gdje prevladava | eRačuni, sitemap, službeni formati | izvozi iz Excela, jednostavni cjenici | API servisi, web aplikacije |
CSV datoteka je kraća i otvara se u Excelu jednim klikom. XML je opširniji, ali nosi strukturu i može se strogo provjeriti, zato ga biraju sustavi kojima je točnost važnija od veličine. JSON je mlađi rođak koji su preuzeli moderni API-ji.
Česta zabuna je i XML naspram HTML-a. Oba koriste oznake u šiljastim zagradama, ali HTML ima propisan skup oznaka za prikaz stranice, dok XML samo opisuje podatke i ne kaže ništa o izgledu.
Kako otvoriti i urediti XML datoteku
Za čitanje je dovoljan preglednik: Chrome, Firefox ili Edge prikazuju XML kao stablo elemenata. Za uređivanje koristite uređivač koda poput Visual Studio Codea ili Notepad++, koji označuju oznake bojom i upozore na nezatvoren element. Excel može uvesti XML kao tablicu (Podaci, Dohvati podatke, Iz datoteke), ali pri ponovnom spremanju lako izgubi ugniježđenu strukturu.
Ako preglednik umjesto stabla javi grešku, pročitajte broj retka u poruci. Najčešće nedostaje završna oznaka ili je u tekstu ostao sam znak &.
Česte greške
Prva je kodiranje. Datoteka spremljena u Windows-1250 umjesto UTF-8 pretvara slova č i ž u nečitljive znakove, a prolog i dalje tvrdi da je UTF-8. Druga je ručno uređivanje generiranog XML-a: popravak jednog iznosa na eRačunu u uređivaču teksta ruši zbrojeve i potpis, pa validator račun odbije. Treća je decimalni zarez ili oznaka valute u brojčanom polju, 24,90 € umjesto 24.90.
Četvrta je zastarjela datoteka. Sitemap koji se ne osvježava ili feed proizvoda koji se generira jednom tjedno šalju tražilicama i usporednicima stare podatke. Kod izrade webshopa te se datoteke zato generiraju automatski iz baze proizvoda, svaki put kad se nešto promijeni.
Česta pitanja
Kako otvoriti XML datoteku eRačuna?
Preglednik će prikazati sirovi kod, što je korisno samo za provjeru pojedinog polja. Za čitljiv prikaz koristite knjigovodstveni program, aplikaciju informacijskog posrednika ili besplatni MIKROeRAČUN Porezne uprave, koji XML prikazuju kao uobičajen račun.
Je li XML programski jezik?
Nije. XML je jezik za označavanje podataka i ništa ne izvršava. Program koji ga čita odlučuje što će s podacima učiniti, baš kao što tablica u Excelu sama ne računa ništa dok netko ne napiše formulu.
Može li Excel spremiti tablicu kao XML?
Može, preko kartice za razvojne programere (Developer) i XML mapiranja, ali taj postupak traži shemu i rijetko je praktičan za male tvrtke. Za cjenik je jednostavnije spremiti CSV u kodiranju UTF-8 ili izvoz prepustiti webshopu.
Koja je razlika između XML-a i HTML-a?
HTML opisuje kako stranica izgleda i što je na njoj naslov, odlomak ili poveznica, s unaprijed zadanim oznakama. XML opisuje same podatke, oznake izmišlja autor formata, a prikaz prepušta programu koji ga čita.
Povezani pojmovi
Sitemap
XML datoteka koja tražilicama popisuje sve važne stranice web sjedišta. Pomaže Googleu brže i potpunije indeksirati sadržaj.
Google Merchant Center
Googleova platforma u koju webshop šalje feed proizvoda. Podaci iz nje pokreću Shopping oglase i besplatne prikaze proizvoda u pretrazi.
eRačun
Račun u strukturiranom elektroničkom formatu (EN 16931) koji se razmjenjuje kroz ovlaštenog posrednika. Od 2026. obvezan za B2B u Hrvatskoj.
Sidrena cijena
Redovna cijena proizvoda ili usluge na referentni dan, koja se od 17. studenoga 2026. obvezno ističe uz aktualnu cijenu. U propisu se zove dodatna cijena.
API
Application Programming Interface: dogovoreni način na koji dva programa razmjenjuju podatke, na primjer webshop i knjigovodstvo ili web obrazac i CRM.
HTML
HyperText Markup Language: jezik kojim je napisana struktura web stranice. Označava što je naslov, odlomak, slika ili poveznica, ne izgled.
