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.
| Obveza | Koga obvezuje | Od kada i u kojem roku | Izvor |
|---|---|---|---|
| Objava cjenika u obliku XML ili CSV datoteke, strojno čitljive | Trgovce 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 cijenu | Sve 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.
| Adresa | Sadržaj | Tip |
|---|---|---|
| https://staging.cjenik.iddqd.hr/c/12345678903 | Stranica cjenika (HTML, bez JavaScripta) | text/html |
| https://staging.cjenik.iddqd.hr/c/12345678903/prices.csv | Važeći cjenik | text/csv |
| https://staging.cjenik.iddqd.hr/c/12345678903/prices.xml | Važeći cjenik | application/xml |
| https://staging.cjenik.iddqd.hr/c/12345678903/archive.json | Popis svih objava s poveznicama na svaku | application/json |
| https://staging.cjenik.iddqd.hr/c/12345678903/archive/{id}/prices.csv | Arhivirana objava — nepromjenjiva | text/csv |
| https://staging.cjenik.iddqd.hr/sitemap.xml | Svi objavljeni obveznici, u OIB obliku | application/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
| Kodiranje | UTF-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. |
| Cijene | Decimalna 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/ne | DA / NE, velikim slovima. |
| Dostupnost | dostupno / nedostupno, malim slovima. Riječi su iz same Odluke, t. III. |
| Datumi | ISO 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 vrijednost | Prazna ć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 / element | Polje iz Odluke | Obvezno | Oblik | Primjer |
|---|---|---|---|---|---|
| 1 | naziv | naziv | da | tekst | Šampon za kosu 250 ml |
| 2 | sifra | šifra | da | tekst | S-250 |
| 3 | marka | marka | da | tekst | Marka |
| 4 | jedinica_mjere | jedinica mjere Decision says "ako je primjenjivo". kom, sat, kg, l, m2 … | ako je primjenjivo | tekst | ml |
| 5 | cijena_za_jedinicu_mjere | cijena za jedinicu mjere Decision says "ako je primjenjivo"; ZZP čl. 7(3) drops it when identical to the retail price. | ako je primjenjivo | decimal | 0.04 |
| 6 | maloprodajna_cijena | maloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodaje | da | decimal | 9.90 |
| 7 | posebni_oblik_prodaje | maloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodaje | da | DA/NE | NE |
| 8 | naziv_posebnog_oblika_prodaje | naziv 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 primjenjivo | tekst | prazno |
| 9 | sidrena_cijena | sidrena 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 primjenjivo | decimal | 9.50 |
| 10 | barkod | barkod robe | da | tekst | 3850102030405 |
| 11 | dostupnost | dostupno/nedostupno | da | dostupnost | dostupno |
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.
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 / element | Polje iz Odluke | Obvezno | Oblik | Primjer |
|---|---|---|---|---|---|
| 1 | naziv_usluge | naziv usluge | da | tekst | Farbanje kose |
| 2 | maloprodajna_cijena | maloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodaje | da | decimal | 30.00 |
| 3 | posebni_oblik_prodaje | maloprodajna cijena, s informacijom je li primijenjena tijekom posebnog oblika prodaje | da | DA/NE | DA |
| 4 | naziv_posebnog_oblika_prodaje | naziv posebnog oblika prodaje Mandatory whenever posebni_oblik_prodaje is DA; empty otherwise. | ako je primjenjivo | tekst | Sezonsko sniženje |
| 5 | sidrena_cijena | sidrena 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 primjenjivo | decimal | 35.00 |
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 zaglavlja | Značenje |
|---|---|
| naziv_obveznika | Pravni naziv trgovca odnosno pružatelja usluge. |
| oib | OIB obveznika — 11 znamenki, ISO 7064 MOD 11,10. |
| oblik_prodajnog_objekta | NN t. VI, komponenta 1 naziva datoteke. |
| adresa_prodajnog_objekta | NN t. VI, komponenta 2. |
| oznaka_prodajnog_objekta | NN t. VI, komponenta 3. |
| broj_pohrane | NN t. VI, komponenta 4. Raste po prodajnom objektu, bez preskakanja. |
| vremenska_oznaka | NN 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_stavki | Broj elemenata u <stavke>. |
| kanonski_url | Trajna 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.
<?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>
<?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:
POSLOVNICA_Ilica-5-Zagreb_PJ1_00042_20261001T094500+0200.csv POSLOVNICA_Ilica-5-Zagreb_PJ1_00042_20261001T094500+0200.xml
| # | Komponenta | Primjer |
|---|---|---|
| 1 | oblik prodajnog objekta | POSLOVNICA |
| 2 | adresa prodajnog objekta | Ilica 5 Zagreb |
| 3 | oznaka prodajnog objekta | PJ1 |
| 4 | broj pohrane (5 znamenki, raste po objektu) | 42 |
| 5 | vremenska oznaka — datum, vrijeme i pomak zone | GGGGMMDDThhmmss±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.