Sidrocjenici

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.