Web

XML datoteka

XML format · XML datoteke

Tekstualna datoteka koja podatke sprema u označene, ugniježđene elemente, čitljive ljudima i strojevima. Koristi se za sitemap, feed proizvoda i eRačune.

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 &lt; i &amp;, pa se tvrtka „Kovač & sinovi” u XML-u zapisuje kao Kovač &amp; 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>
DioU 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
Atributsifra="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

XMLCSVJSON
Oblikoznake i ugniježđeni elementitablica, jedan red po zapisuparovi ključ i vrijednost, ugniježđeni objekti
Varijante i podstavkeprirodnoteško, svaka varijanta postaje novi redprirodno
Provjera shemomXSD, vrlo strogane postoji standardnaJSON Schema
Gdje prevladavaeRačuni, sitemap, službeni formatiizvozi iz Excela, jednostavni cjeniciAPI 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.

Spremni za rast vašeg poslovanja?

Dogovorimo kratki razgovor. Pregledat ćemo vašu web stranicu, oglase, SEO i recenzije te vam poslati pisani plan, bez obzira angažirate li nas ili ne.