Dokumentacija
Format CSV i XML
Stupci, kodiranje, brojevi, naziv datoteke i XSD shema.
Stupci proizvoda
Točno ovim redom (NN 101/2026, Odluka o objavi cjenika, t. III.):
| # | Stupac | Sadržaj |
|---|---|---|
| 1 | Naziv | naziv proizvoda |
| 2 | Šifra | vaša šifra (SKU) |
| 3 | Marka | marka |
| 4 | Jedinica mjere | kg, l, m, m², m³, kom… (ako je primjenjivo) |
| 5 | Cijena za jedinicu mjere | cijena po osnovnoj jedinici (500 g → cijena po kg) |
| 6 | Maloprodajna cijena | cijena koja se naplaćuje (akcijska dok akcija traje) |
| 7 | Posebni oblik prodaje | DA ili NE |
| 8 | Naziv posebnog oblika prodaje | npr. Akcija, Rasprodaja; prazno kad je NE |
| 9 | Sidrena cijena | redovna cijena na referentni datum |
| 10 | Datum sidrene cijene | GGGG-MM-DD (2026-09-10, 2025-05-02 ili dan uvođenja) |
| 11 | Barkod | EAN/GTIN |
| 12 | Dostupnost | dostupno ili nedostupno |
Stupac 10 Sidro dodaje jer isti cjenik može sadržavati sidrene cijene s različitih datuma — bez datuma iznos nema jednoznačno značenje.
Neobvezni stupci (uključuju se u Postavke → Format datoteke, dodaju se na kraj): Neto količina, Kategorija, Redovna maloprodajna cijena, Najniža cijena u zadnjih 30 dana.
Stupci usluga
(t. IV.): Naziv usluge, Šifra, Jedinica, Maloprodajna cijena, Posebni oblik prodaje, Naziv posebnog oblika prodaje, Sidrena cijena, Datum sidrene cijene.
Kodiranje i brojevi
- UTF-8 bez BOM-a (BOM se može uključiti za lakše otvaranje u Excelu),
- RFC 4180: zarez kao razdjelnik, polja s razdjelnikom ili navodnikom u navodnicima, završetak retka
CRLF, - iznosi s dvije decimale i točkom (
12.99), bez tisućica i bez valute (sve je u eurima), - po želji točka-zarez kao razdjelnik i decimalni zarez (za hrvatski Excel).
Primjer:
Naziv,Šifra,Marka,Jedinica mjere,Cijena za jedinicu mjere,Maloprodajna cijena,Posebni oblik prodaje,Naziv posebnog oblika prodaje,Sidrena cijena,Datum sidrene cijene,Barkod,Dostupnost
Kruh bijeli 500 g,KR-500,Pekara Primjer,kg,3.98,1.99,NE,,1.89,2026-09-10,3850000000014,dostupno
"Sir gauda, 400 g",SIR-400,Mljekara,kg,12.48,4.99,DA,Tjedna akcija,5.49,2026-09-10,3850000000021,nedostupno
Redovi su poredani abecedno po nazivu. Isti podaci daju iste bajtove — sadržaj ne ovisi o trenutku objave (vrijeme je u nazivu datoteke), pa je dan bez promjena cijena prepoznatljiv po istom SHA-256 sažetku.
XML
<?xml version="1.0" encoding="UTF-8"?>
<Cjenik xmlns="https://sidro-cjenici.vercel.app/xsd/cjenik-1" verzija="1.0" vrsta="proizvodi" valuta="EUR" propis="NN 101/2026">
<Obveznik><Naziv>Primjer d.o.o.</Naziv><OIB>12345678901</OIB><Web>https://primjer.hr</Web></Obveznik>
<ProdajniObjekt><Oblik>PRODAVAONICA</Oblik><Adresa>Vlaška 68</Adresa><PostanskiBroj>10000</PostanskiBroj><Mjesto>Zagreb</Mjesto><Oznaka>P1</Oznaka></ProdajniObjekt>
<Proizvodi broj="1">
<Proizvod><Naziv>Kruh bijeli 500 g</Naziv><Sifra>KR-500</Sifra><Marka>Pekara Primjer</Marka><JedinicaMjere>kg</JedinicaMjere><CijenaZaJedinicuMjere>3.98</CijenaZaJedinicuMjere><MaloprodajnaCijena>1.99</MaloprodajnaCijena><PosebniOblikProdaje>NE</PosebniOblikProdaje><NazivPosebnogOblikaProdaje/><SidrenaCijena>1.89</SidrenaCijena><DatumSidreneCijene>2026-09-10</DatumSidreneCijene><Barkod>3850000000014</Barkod><Dostupnost>dostupno</Dostupnost></Proizvod>
</Proizvodi>
</Cjenik>
Shema: https://sidro-cjenici.vercel.app/xsd/cjenik-1.xsd. Usluge koriste <Usluge> i <Usluga> s elementom <NazivUsluge>.
Naziv datoteke
Točka VI. traži da naziv sadrži oblik, adresu i oznaku objekta, broj pohrane te datum i vrijeme slanja. Sidrov oblik (stalan za cijeli lanac):
{OBLIK}_{ADRESA}_{OZNAKA}_{BROJ_POHRANE}_{DDMMGGGG}_{HHMM}.csv
PRODAVAONICA_VLASKA_68_10000_ZAGREB_P1_01_01102026_0612.csv
- velika slova bez dijakritike (Č→C, Đ→DJ), razmaci i znakovi →
_, - broj pohrane je redni broj objave tog dana za tu lokaciju (01, 02…),
- vrijeme je zagrebačko vrijeme objave.