Dokumentacija · verzija 2026.1

Format objavljenih cjenika

Pravna osnova NN 101/2026-1213 («Odluka o objavi cjenika proizvoda i usluga kao mjera izravne kontrole cijena», na snazi 1. listopada 2026.). Ovdje je opisano što ovaj servis emitira — stupci, kodiranje, naziv datoteke, adrese i pravila promjene.

Ovo nije službeni format. Odluka propisuje popis polja, pet komponenti naziva datoteke, jedinstvenu strukturu unutar lanca i strojnu dostupnost — ali ne propisuje shemu, XSD, redoslijed stupaca, razdjelnik ni kodiranje. Sve niže navedeno je naša dokumentirana konvencija, objavljena da biste se na nju mogli osloniti. Nije odobrena od nadležnog tijela i tako je ne opisujemo.

Tko mora objaviti i do kada

Ova stranica opisuje datoteke. Prije nje dolazi pitanje koga obveza uopće dotiče, jer NN 101/2026 nosi dvije obveze i ne obvezuju iste ljude.

ObvezaKoga obvezujeOd kada i u kojem rokuIzvor
Objava cjenika u obliku XML ili CSV datoteke, strojno čitljiveTrgovce i pružatelje usluga „koji imaju uspostavljene mrežne stranice”. Ako mrežnih stranica nema, ove obveze nema — i nitko nikoga ne obvezuje da ih otvori.Od 1. listopada 2026. Cjenik usluga objavljuje se ponovno pri svakoj promjeni cijene, najkasnije do 8:00, i ostaje dostupan 30 dana od objave odnosno od svake izmjene.NN 101/2026-1213, t. II i t. V
Isticanje sidrene cijene uz aktualnu cijenuSve trgovce i sve registrirane pružatelje usluga. Ne ovisi o tome ima li netko mrežnu stranicu.Od 1. listopada 2026. Sidrena cijena je cijena primijenjena 10. rujna 2026.NN 101/2026-1212, t. II i t. III

Dvije obveze, dva artefakta, i jedan ne pokriva drugi: objavljena datoteka ne zamjenjuje isticanje sidrene cijene u prodajnom prostoru, a istaknuta sidrena cijena ne zamjenjuje objavu datoteke. Ovaj servis emitira datoteke iz prvog retka; drugi redak je obveza prikaza i nije predmet ove specifikacije.

Adrese

Kanonska adresa cjenika je OIB obveznika. Naziv je trajni 301 alias i nikada druga kanonska adresa — QR kod završi na laminiranom papiru koji nadživi promjenu naziva.

AdresaSadržajTip
https://staging.cjenik.iddqd.hr/c/12345678903Stranica cjenika (HTML, bez JavaScripta)text/html
https://staging.cjenik.iddqd.hr/c/12345678903/prices.csvVažeći cjeniktext/csv
https://staging.cjenik.iddqd.hr/c/12345678903/prices.xmlVažeći cjenikapplication/xml
https://staging.cjenik.iddqd.hr/c/12345678903/archive.jsonPopis svih objava s poveznicama na svakuapplication/json
https://staging.cjenik.iddqd.hr/c/12345678903/archive/{id}/prices.csvArhivirana objava — nepromjenjivatext/csv
https://staging.cjenik.iddqd.hr/sitemap.xmlSvi objavljeni obveznici, u OIB oblikuapplication/xml

Odluka, t. II, traži da objava ostane dostupna 30 dana od objave odnosno od svake izmjene. Arhiva se ovdje ne briše nakon 30 dana — čuvamo svaku objavu.

Zajednička pravila

KodiranjeUTF-8, bez BOM-a. XML deklarira encoding="UTF-8"; HTTP odgovor nosi charset=utf-8.
Razdjelnik (CSV)Točka-zarez ;. Odluka ga ne propisuje; zarez u hrvatskom Excelu otvara datoteku kao jedan stupac.
Prijelom retka (CSV)CRLF (\r\n), uključujući iza zadnjeg retka.
Navodnici (CSV)Ćelija koja sadrži ;, " ili prijelom retka omotana je dvostrukim navodnicima; navodnik u sadržaju udvostručen je (RFC 4180).
Zaglavlje (CSV)Prvi redak je uvijek zaglavlje s nazivima stupaca. Broj stupaca je fiksan — neispunjeno polje je prazna ćelija, nikada izostavljena.
CijeneDecimalna točka, uvijek dvije decimale, bez razdjelnika tisućica i bez oznake valute: 25.00, 1200.00. Valuta je EUR. (Na stranici i na ispisu prikazuje se hrvatski — 25,00 € — u datoteci nikada.)
Da/neDA / NE, velikim slovima.
Dostupnostdostupno / nedostupno, malim slovima. Riječi su iz same Odluke, t. III.
DatumiISO 8601 s izričitim pomakom zone, uvijek Europe/Zagreb: 2026-10-01T09:45:00+02:00. Nikada oblik s Z: rok iz t. II Odluke («8:00 sati ujutro») je hrvatsko lokalno vrijeme, pa se vrijeme objave mora moći usporediti s njim bez preračunavanja. Ljeti je pomak +02:00, zimi +01:00.
Prazna vrijednostPrazna ćelija odnosno prazan element. Ne pišemo null, - ni 0 — nula je cijena, a ne izostanak cijene.

Polja — proizvodi

Jedanaest polja, redoslijedom kojim ih navodi t. III Odluke. Naziv stupca u CSV-u i naziv elementa u XML-u su isti. Stupac Primjer je vrijednost iz retka ispod — ista funkcija koja piše objavljenu datoteku.

#Stupac / elementPolje iz OdlukeObveznoOblikPrimjer
1nazivnazivdatekstŠampon za kosu 250 ml
2sifrašifradatekstS-250
3markamarkadatekstMarka
4jedinica_mjerejedinica mjere
Decision says "ako je primjenjivo". kom, sat, kg, l, m2 …
ako je primjenjivotekstml
5cijena_za_jedinicu_mjerecijena za jedinicu mjere
Decision says "ako je primjenjivo"; ZZP čl. 7(3) drops it when identical to the retail price.
ako je primjenjivodecimal0.04
6maloprodajna_cijenamaloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodajedadecimal9.90
7posebni_oblik_prodajemaloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodajedaDA/NENE
8naziv_posebnog_oblika_prodajenaziv posebnog oblika prodaje
Mandatory whenever posebni_oblik_prodaje is DA; empty otherwise. ZZP čl. 19(2) names akcijska prodaja, rasprodaja, sezonsko sniženje, prodaja robe s greškom, prodaja robe kojoj brzo istječe rok uporabe — čl. 19(3) permits others, so this is an open vocabulary.
ako je primjenjivotekstprazno
9sidrena_cijenasidrena cijena
Cijena primjenjiva na dan sidrenja (10.09.2026. za većinu obveznika; 02.05.2025. preživljava samo za kategorije iz NN 75/2025). Prazno za artikl uveden nakon tog dana — cijena koja nije postojala ne izmišlja se.
ako je primjenjivodecimal9.50
10barkodbarkod robedatekst3850102030405
11dostupnostdostupno/nedostupnodadostupnostdostupno

Popis iz 2026. nije popis iz 2025. NN 75/2025 tražio je i neto količina i kategorija proizvoda — oba su ispala. Novi su sidrena cijena i oznaka dostupnosti. Predložak prenesen s trgovačkog lanca iz 2025. nosi krive stupce.

Primjer — 11 stupaca
naziv;sifra;marka;jedinica_mjere;cijena_za_jedinicu_mjere;maloprodajna_cijena;posebni_oblik_prodaje;naziv_posebnog_oblika_prodaje;sidrena_cijena;barkod;dostupnost
Šampon za kosu 250 ml;S-250;Marka;ml;0.04;9.90;NE;;9.50;3850102030405;dostupno

Polja — usluge

Pet polja, prema t. IV. Usluge nemaju oznaku dostupnosti: Odluka je za usluge ne traži, pa je ne izmišljamo.

#Stupac / elementPolje iz OdlukeObveznoOblikPrimjer
1naziv_uslugenaziv uslugedatekstFarbanje kose
2maloprodajna_cijenamaloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodajedadecimal30.00
3posebni_oblik_prodajemaloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodajedaDA/NEDA
4naziv_posebnog_oblika_prodajenaziv posebnog oblika prodaje
Mandatory whenever posebni_oblik_prodaje is DA; empty otherwise.
ako je primjenjivotekstSezonsko sniženje
5sidrena_cijenasidrena cijena
Cijena primjenjiva na dan sidrenja (10.09.2026. za većinu obveznika; 02.05.2025. preživljava samo za kategorije iz NN 75/2025). Prazno za artikl uveden nakon tog dana — cijena koja nije postojala ne izmišlja se.
ako je primjenjivodecimal35.00
Primjer — 5 stupaca
naziv_usluge;maloprodajna_cijena;posebni_oblik_prodaje;naziv_posebnog_oblika_prodaje;sidrena_cijena
Šišanje žensko;25.00;NE;;
Farbanje kose;30.00;DA;Sezonsko sniženje;35.00

XML

Korijen je <cjenik>, s <zaglavlje> i <stavke>. Svaka stavka je <proizvod> odnosno <usluga>, a elementi unutar nje imaju ista imena kao stupci gore.

Element zaglavljaZnačenje
naziv_obveznikaPravni naziv trgovca odnosno pružatelja usluge.
oibOIB obveznika — 11 znamenki, ISO 7064 MOD 11,10.
oblik_prodajnog_objektaNN t. VI, komponenta 1 naziva datoteke.
adresa_prodajnog_objektaNN t. VI, komponenta 2.
oznaka_prodajnog_objektaNN t. VI, komponenta 3.
broj_pohraneNN t. VI, komponenta 4. Raste po prodajnom objektu, bez preskakanja.
vremenska_oznakaNN t. VI, komponenta 5. ISO 8601 s izričitim pomakom, u zoni Europe/Zagreb — npr. 2026-10-01T09:45:00+02:00. Nikada „Z”: rok iz t. II Odluke («8:00 sati ujutro») je hrvatsko lokalno vrijeme, pa se vrijeme objave mora moći usporediti s njim bez preračunavanja. Ljeti je pomak +02:00, zimi +01:00.
vrsta_cjenika`proizvodi` ili `usluge` — određuje koji skup polja slijedi.
broj_stavkiBroj elemenata u <stavke>.
kanonski_urlTrajna adresa ovog cjenika, u OIB obliku (ADR-009). Odatle vode CSV, XML, arhiva i QR kod.

kanonski_url postoji zato da potrošač datoteke koji ima samo XML može natrag do stranice, arhive i CSV-a. OIB je identifikator, ne adresa, i ne postoji registar koji jedno pretvara u drugo.

Primjer — usluge
<?xml version="1.0" encoding="UTF-8"?>
<cjenik>
  <zaglavlje>
    <naziv_obveznika>FRIZERSKI SALON ANA, obrt za usluge</naziv_obveznika>
    <oib>12345678903</oib>
    <oblik_prodajnog_objekta>POSLOVNICA</oblik_prodajnog_objekta>
    <adresa_prodajnog_objekta>Ilica 5 Zagreb</adresa_prodajnog_objekta>
    <oznaka_prodajnog_objekta>PJ1</oznaka_prodajnog_objekta>
    <broj_pohrane>42</broj_pohrane>
    <vremenska_oznaka>2026-10-01T09:45:00+02:00</vremenska_oznaka>
    <vrsta_cjenika>usluge</vrsta_cjenika>
    <broj_stavki>2</broj_stavki>
    <kanonski_url>https://staging.cjenik.iddqd.hr/c/12345678903</kanonski_url>
  </zaglavlje>
  <stavke>
    <usluga>
      <naziv_usluge>Šišanje žensko</naziv_usluge>
      <maloprodajna_cijena>25.00</maloprodajna_cijena>
      <posebni_oblik_prodaje>NE</posebni_oblik_prodaje>
      <naziv_posebnog_oblika_prodaje></naziv_posebnog_oblika_prodaje>
      <sidrena_cijena></sidrena_cijena>
    </usluga>
    <usluga>
      <naziv_usluge>Farbanje kose</naziv_usluge>
      <maloprodajna_cijena>30.00</maloprodajna_cijena>
      <posebni_oblik_prodaje>DA</posebni_oblik_prodaje>
      <naziv_posebnog_oblika_prodaje>Sezonsko sniženje</naziv_posebnog_oblika_prodaje>
      <sidrena_cijena>35.00</sidrena_cijena>
    </usluga>
  </stavke>
</cjenik>
Primjer — proizvodi
<?xml version="1.0" encoding="UTF-8"?>
<cjenik>
  <zaglavlje>
    <naziv_obveznika>FRIZERSKI SALON ANA, obrt za usluge</naziv_obveznika>
    <oib>12345678903</oib>
    <oblik_prodajnog_objekta>POSLOVNICA</oblik_prodajnog_objekta>
    <adresa_prodajnog_objekta>Ilica 5 Zagreb</adresa_prodajnog_objekta>
    <oznaka_prodajnog_objekta>PJ1</oznaka_prodajnog_objekta>
    <broj_pohrane>42</broj_pohrane>
    <vremenska_oznaka>2026-10-01T09:45:00+02:00</vremenska_oznaka>
    <vrsta_cjenika>proizvodi</vrsta_cjenika>
    <broj_stavki>1</broj_stavki>
    <kanonski_url>https://staging.cjenik.iddqd.hr/c/12345678903</kanonski_url>
  </zaglavlje>
  <stavke>
    <proizvod>
      <naziv>Šampon za kosu 250 ml</naziv>
      <sifra>S-250</sifra>
      <marka>Marka</marka>
      <jedinica_mjere>ml</jedinica_mjere>
      <cijena_za_jedinicu_mjere>0.04</cijena_za_jedinicu_mjere>
      <maloprodajna_cijena>9.90</maloprodajna_cijena>
      <posebni_oblik_prodaje>NE</posebni_oblik_prodaje>
      <naziv_posebnog_oblika_prodaje></naziv_posebnog_oblika_prodaje>
      <sidrena_cijena>9.50</sidrena_cijena>
      <barkod>3850102030405</barkod>
      <dostupnost>dostupno</dostupnost>
    </proizvod>
  </stavke>
</cjenik>

Naziv datoteke

T. VI Odluke: «Nazivi datoteka uključuju oblik prodajnog objekta, adresu prodajnog objekta, oznaku prodajnog objekta, broj pohrane te vremensku oznaku koja uključuje datum i vrijeme slanja datoteke.» Pet komponenti; redoslijed i razdjelnik nisu propisani. Naša konvencija — komponente redoslijedom kojim ih Odluka navodi, spojene podvlakom:

Primjer
POSLOVNICA_Ilica-5-Zagreb_PJ1_00042_20261001T094500+0200.csv
POSLOVNICA_Ilica-5-Zagreb_PJ1_00042_20261001T094500+0200.xml
#KomponentaPrimjer
1oblik prodajnog objektaPOSLOVNICA
2adresa prodajnog objektaIlica 5 Zagreb
3oznaka prodajnog objektaPJ1
4broj pohrane (5 znamenki, raste po objektu)42
5vremenska oznaka — datum, vrijeme i pomak zoneGGGGMMDDThhmmss±hhmm

Dijakritički znakovi se preslikavaju na ASCII, razmaci na crticu, a podvlaka se u komponenti ne pojavljuje — inače podjela na pet dijelova ne bi bila jednoznačna. Datoteke lanca prodajnih objekata imaju jedinstvenu strukturu za sve objekte (t. VI): isti stupci, jedna datoteka po objektu.

Peta komponenta sadrži znak + (odnosno −) kao predznak pomaka zone. To je ispravan znak u putanji URL-a (RFC 3986, sub-delim) i u zaglavlju Content-Disposition (RFC 6266), i dopušten je na svim datotečnim sustavima. Ako naziv stavljate u upitni dio URL-a (?…), kodirajte ga kao %2B — ondje se + tumači kao razmak. Pomak ne izostavljamo: pri prelasku na zimsko računanje vremena ista se lokalna minuta pojavi dvaput, pa je pomak jedino što razlikuje dvije objave.

Strojni pristup

T. VII Odluke i ZIMKC čl. 12(10) traže da prikupljanje podataka softverskim alatima bude omogućeno u stvarnom vremenu. Zato:

  • bez CAPTCHA-e, bez prijave, bez ograničenja broja zahtjeva;
  • bez JavaScripta — sve javne stranice i datoteke su potpune u prvom odgovoru;
  • access-control-allow-origin: * na svakoj strojno čitljivoj datoteci;
  • robots.txt dopušta cijelo javno stablo i navodi sitemap.xml;
  • ETag je sadržajni otisak objave, pa uvjetni GET s If-None-Match vraća 304 dok se cijene ne promijene. Anketirajte koliko god često želite;
  • arhivirana objava je nepromjenjiva i poslužena s cache-control: immutable; važeći cjenik s max-age=300.

Verzioniranje i promjene

Ova specifikacija je verzionirana — trenutno 2026.1 — i obećanje koje uz nju ide je kratko:

  • Dodavanje je moguće bez najave. Novi element u XML-u, nova vrijednost u otvorenom rječniku (nazivi posebnih oblika prodaje po ZZP čl. 19(3)), nova datoteka. Postojeća imena zadržavaju značenje i mjesto. Potrošač datoteke mora zanemariti element koji ne prepoznaje, a ne pasti na njemu.
  • CSV stupac se nikada ne umeće, samo dodaje na kraj — čitači broje ćelije.
  • Uklanjanje ili preimenovanje najavljuje se na ovoj stranici prije nego se dogodi, s datumom, i nikada u istom izdanju u kojem se izvodi.
  • Zakon se mijenja neovisno o nama. Pravilnik po ZZP čl. 7(12), koji tek treba biti objavljen, može propisati format proizvodnih cjenika — kad se to dogodi, mijenjamo ovu specifikaciju i najavljujemo je ovdje.

Strojno čitljiv oblik iste specifikacije: /docs/format.json.

Našli ste grešku?

Neispravno polje u objavljenoj datoteci je pitanje usklađenosti, ne kozmetike — javite nam ga. Ako gradite agregator i treba vam polje kojeg ovdje nema, recite koje i zašto; popis polja proširujemo dodavanjem, što po pravilima gore ništa ne ruši.