Dokumentacija sheme i javnih adresa

Odluka propisuje podatke koje cjenik mora sadržavati, ali ne daje službeni XSD. Shema opisana ovdje je vlastita shema ovog sustava i nije državno propisan XML. Polja su posloženа tako da pokrivaju propisane podatke, a dodatna tehnička polja mogu se dodati bez uklanjanja obveznih.

Javne adrese

/api/public/cjenici/{poslovnicaId}/aktualni.xml
/api/public/cjenici/{poslovnicaId}/aktualni.csv
/api/public/cjenici/{poslovnicaId}/arhiva.json
/api/public/cjenici/{poslovnicaId}/izdanje/{datotekaId}

Adrese rade bez prijave, dopuštaju GET i HEAD, vraćaju zaglavlje x-sadrzaj-hash sa SHA-256 sažetkom i ne blokiraju automatizirano dohvaćanje. Aktualna datoteka nije predmemorirana; arhivska izdanja su nepromjenjiva.

XML shema (verzija 1.0)

<?xml version="1.0" encoding="UTF-8"?>
<cjenik verzija="1.0" vrsta="proizvod">
  <zaglavlje>
    <trgovac>Primjer d.o.o.</trgovac>
    <oib>12345678901</oib>
    <prodajni_objekt>
      <naziv>Web trgovina</naziv>
      <oblik>internet trgovina</oblik>
      <adresa>Ilica 1, Zagreb</adresa>
      <oznaka>WEB-01</oznaka>
    </prodajni_objekt>
    <broj_pohrane>7</broj_pohrane>
    <vrijeme_objave>2026-10-01T06:12:00+02:00</vrijeme_objave>
    <vremenska_zona>Europe/Zagreb</vremenska_zona>
    <valuta>EUR</valuta>
    <broj_stavki>128</broj_stavki>
  </zaglavlje>
  <stavke>
    <stavka>
      <naziv>Primjer proizvoda</naziv>
      <maloprodajna_cijena>9.99</maloprodajna_cijena>
      <sidrena_cijena>11.49</sidrena_cijena>
      <datum_sidrene_cijene>2026-09-10</datum_sidrene_cijene>
      <poseban_oblik_prodaje>ne</poseban_oblik_prodaje>
      <naziv_posebnog_oblika_prodaje></naziv_posebnog_oblika_prodaje>
      <sifra>SKU-001</sifra>
      <marka>Marka</marka>
      <barkod>3850000000000</barkod>
      <jedinica_mjere>kom</jedinica_mjere>
      <cijena_za_jedinicu_mjere>9.99</cijena_za_jedinicu_mjere>
      <dostupnost>dostupno</dostupnost>
    </stavka>
  </stavke>
</cjenik>

Za usluge se izostavljaju polja specifična za proizvode (šifra, marka, barkod, jedinica mjere, cijena za jedinicu mjere, dostupnost).

CSV zaglavlja

proizvodi: naziv;sifra;marka;jedinica_mjere;cijena_za_jedinicu_mjere;maloprodajna_cijena;poseban_oblik_prodaje;naziv_posebnog_oblika_prodaje;sidrena_cijena;datum_sidrene_cijene;barkod;dostupnost

usluge: naziv;maloprodajna_cijena;poseban_oblik_prodaje;naziv_posebnog_oblika_prodaje;sidrena_cijena;datum_sidrene_cijene

Razdjelnik je točka-zarez, kodiranje UTF-8 s BOM-om, decimalni razdjelnik je točka, valuta EUR. Vrijednosti koje počinju znakovima =, +, - ili @ dobivaju prefiks apostrofa radi zaštite od formula u Excelu.

Naziv arhivske datoteke

oblik_adresa_oznaka_brojPohrane_vrijeme.xml

Znakovi se normaliziraju za URL, a puni metapodaci ostaju u zaglavlju same datoteke. Broj pohrane raste bez ponavljanja po prodajnom objektu.

Regulatorni okvir

Sustav je izrađen prema odlukama objavljenima u NN 101/2026 (dokumenti 1213 i 1212). Tumačenje obveze i točnost podataka za pojedinog klijenta potvrđuje odgovorna osoba klijenta; sustav ne pretpostavlja da je svaka stranica obveznik.