Objava cjenika na webshopu: XML i CSV, svaki dan

Što propis traži

Odluka o objavi cjenika, objavljena u NN 101/2026 dana 11.9.2026., uvodi obvezu objave cjenika na mrežnoj stranici trgovca. Primjenjuje se od 1. listopada 2026. i vrijedi za one koji mrežnu stranicu imaju, što webshop po definiciji ima.

• Oblik: XML ili CSV, dakle pogodan za automatsku obradu. PDF i slika ne prolaze jer ih stroj ne može pročitati bez pogađanja.
• Osvježavanje: svaki dan, do 8:00 ujutro.
• Dostupnost: objavljeni cjenik ostaje dostupan 30 dana.
• Sadržaj: naziv i cijena artikla, sidrena cijena i podaci o posebnim oblicima prodaje, dakle o sniženjima.

Kazne su iste kao za sidrenu cijenu, jer dolaze iz istog zakona: 3.000 do 30.000 € trgovcu i 1.000 do 4.000 € odgovornoj osobi.

Kako to izgleda kad radi

Svaki dan, odmah nakon snimanja cijena, cijeli se katalog izveze u odabrane formate i objavi na stalnoj adresi. Dnevna datoteka ostaje kao arhiva, a uz nju stoji i datoteka bez datuma koja uvijek pokazuje najnoviji cjenik.

Time onaj tko cjenik povlači strojno ne mora pogađati kako se datoteka danas zove: može ciljati stalnu adresu i uvijek dobiti aktualno stanje, ili proći kroz arhivu ako mu treba određeni dan.

Početak adrese je postavka. Ako trgovina već ima stranicu na /cjenik/, promijenite ga i stranica ostaje netaknuta; dodatak sam provjerava postoji li takva stranica i prijavi sudar prije nego se dogodi.

https://vasa-trgovina.hr/cjenik/              ← popis i poveznice
https://vasa-trgovina.hr/cjenik/cjenik.csv    ← uvijek najnoviji
https://vasa-trgovina.hr/cjenik/cjenik.xml
https://vasa-trgovina.hr/cjenik/cjenik.json
https://vasa-trgovina.hr/cjenik/cjenik-2026-09-21.csv
https://vasa-trgovina.hr/cjenik/index.json    ← popis svih dana

Naziv datoteke je propisan, sintaksa nije

Ovo se najčešće previdi. Točka VI. Odluke traži da naziv datoteke sadrži oblik prodajnog objekta, adresu, oznaku objekta, broj pohrane te datum i vrijeme objave. Datoteka nazvana cjenik.csv taj uvjet ne ispunjava.

Ono što Odluka ne propisuje jest kojim se redom i kojim razdjelnikom ti elementi spajaju, niti postoji XSD shema ili propisan redoslijed stupaca. Zato dodatak donosi jednu odluku i dokumentira je, umjesto da pogađa:

Podaci o objektu su postavka. Za webshop bez fizičke poslovnice zadano je internet trgovina, a adresa se uzima iz WooCommerce postavki trgovine.

Pojam broj pohrane Odluka ne definira. Ovdje se tumači kao redni broj objave, koji raste sa svakim izvozom i nikad se ne ponavlja. To tumačenje piše i u uputama, da trgovac zna što brani ako ga netko pita.

Uz propisanu datoteku ostaje i cjenik.csv bez vremenske oznake. Odluka je ne traži, ali bez nje onaj tko cjenik povlači automatski mora svaki dan pogađati novi naziv.

INTERNET-TRGOVINA_LUKORANSKA-17-ZAGREB_1_42_21092026_0315.csv

oblik_adresa_oznaka_brojPohrane_ddmmgggg_hhmm

Tri formata, isti sadržaj

CSV je razdvojen točkom-zarezom, jer je to zapis koji daju hrvatski ERP-ovi i Excel s hrvatskim regionalnim postavkama. Brojevi u njemu imaju decimalnu točku i nemaju razdjelnik tisuća: hrvatski zarez uz točku-zarez kao razdjelnik polja glavni je izvor pogrešnog čitanja.

XML nosi jedan element po artiklu i zaglavlje s nazivom trgovine, datumom i valutom. JSON ima isto to, plus broj artikala na kraju, pa se nepotpuna datoteka odmah prepozna.

Formati se biraju u postavkama. Isključite li sve, ostaje CSV, jer uključen cjenik bez ijednog formata ne bi proizveo ništa, a trgovac bi mislio da objavljuje.

Arhiva i popis u JSON-u

Uz cjenike stoji index.json, koji nabraja sve dostupne dane i adrese po formatima, uz naziv trgovine, datum zadnjeg izvoza, broj artikala i popis stupaca. To je ulazna točka za bilo koga tko cjenik povlači automatski.

Koliko se dana čuva je postavka; zadano devedeset, a ispod 30 se ne može jer toliko propis traži. Stariji dnevni cjenici se brišu, a najnoviji uvijek ostaje.

{
  "trgovac": "Vaša trgovina",
  "azurirano": "2026-09-21 03:22:14",
  "dan": "2026-09-21",
  "artikala": 4318,
  "stupci": ["sifra", "naziv", "barkod", "…"],
  "najnoviji": { "csv": "…/cjenik.csv", "xml": "…", "json": "…" },
  "arhiva": [ { "dan": "2026-09-21", "formati": { … } } ]
}

Zašto se poslužuje kroz PHP

Datoteka u mapi uploads javna je i na Apacheu i na nginxu, a pravilo u .htaccess vrijedi samo na Apacheu. Zato cjenik ne stoji na izravnoj adresi nego prolazi kroz WordPress, gdje se poštuje postavka o javnosti bez obzira na posluživač.

Time su i zaglavlja pod kontrolom: točan tip sadržaja, naziv datoteke i zabrana pogađanja tipa. Preglednik koji otvori CSV ne dobije stranicu, a alat koji ga povlači ne mora nagađati kodiranje.

Postavkom se cjenik može sakriti od javnosti. Tada adresu vide samo prijavljeni administratori trgovine, što je korisno dok se izvoz provjerava prije nego ga date dobavljaču.

Veliki katalozi

Izvoz ide u serijama, kao i snimanje cijena. Piše se u privremenu datoteku i preimenuje tek kad je cijeli katalog unutra, pa tko god cjenik dohvati usred izvoza dobije jučerašnji, cijeli, umjesto današnjeg polovičnog.

To je razlika koja se ne vidi dok ne zatreba: polovičan cjenik ne izgleda pokvareno, samo ima manje artikala, i nitko to ne primijeti dok netko ne pita zašto mu artikl nedostaje.

Prilagodba sadržaja

Redak prolazi kroz filter prije zapisivanja, pa se vrijednosti mogu promijeniti ili dopuniti iz teme ili vlastitog dodatka, bez diranja izvornog koda.

add_filter( 'klikoteka_cjenik_red', function ( $red, $product ) {
	$red['kategorija'] = strtoupper( $red['kategorija'] );
	return $red;
}, 10, 2 );

Stupci izvoza (prvih jedanaest je točka III. Odluke)