Dohvat baznih cijena i cjenika proizvoda i usluga

Ova uputa daje pregled mogućnosti Luceed API-ja za dohvat baznih cijena i cjenika proizvoda i usluga. Namijenjena je programerima, webmasterima i integratorima kao orijentacijska stranica za razumijevanje scenarija korištenja, načina rada i povezanosti s postavkama u Luceed ERP-u. Detaljni popis ruta, parametara, polja i primjera poziva nalazi se u kompletnoj Luceed API dokumentaciji.

Za što koristiti ovu uputu

  • Integraciju baznih cijena u webshop ili drugi digitalni kanal

  • Automatizirani dohvat cjenika po poslovnicama

  • Provjeru pristupnih prava za dohvat API podataka

Važno

Ova stranica nije zamjena za kompletnu API specifikaciju. Ovdje su sažeti scenariji i operativna pravila za bazne cijene i cjenike, dok se detaljne rute, parametri, formati odgovora i primjeri poziva nalaze u službenoj dokumentaciji.

👉 Luceed API dokumentacija: https://docs.tomsoft.hr/luceedapi/luceed-api


Pregled API-ja i uloga u kontekstu novih propisa

U novom regulatornom okviru od 17. studenog 2026. poslovni subjekti mogu imati obvezu:

  • prikazivati bazne cijene uz redovne maloprodajne cijene na prodajnim i digitalnim kanalima

  • javno objavljivati važeće cjenike proizvoda i usluga po poslovnicama u formatu pogodnom za automatsku obradu

Luceed API pokriva dva glavna tehnička scenarija:

  1. Dohvat podataka o artiklima za prikaz baznih cijena na webshopu, mobilnim aplikacijama ili drugim digitalnim sučeljima.

  2. Dohvat cjenika po poslovnicama za javnu web objavu, sinkronizaciju s vanjskim sustavima i automatiziranu distribuciju datoteka.

Usklađenje naziva i unazadna kompatibilnost

Naziv „sidrena cijena” u API-ju je usklađen s novim službenim nazivom „bazna cijena”, uz zadržavanje postojećih polja i ruta kako bi dosadašnje integracije nastavile raditi bez prekida.

Stari naziv

Novi naziv

isticanje_sidrene_cijene

isticanje_bazne_cijene

sidrena_mpc

bazna_mpc

sidrena_mpc_od_datuma

bazna_mpc_od_datuma

/sidrenecijene/...

/baznecijene/...

Napomena o kompatibilnosti: Stari nazivi vraćaju iste podatke i zadržani su za postojeće integracije. Nove integracije trebaju odmah koristiti bazna_* polja i rute /baznecijene/..., a postojeće integracije preporučuje se s vremenom prebaciti na nove nazive jer su stari nazivi označeni kao zastarjeli (deprecated).

API je namijenjen tehničkim implementacijama. Sam API ne određuje koji se artikli ili poslovnice trebaju objaviti; on vraća podatke prema postavkama definiranima u Luceed ERP-u.

Prikaz baznih cijena artikala na webshopu

Za prikaz baznih cijena na webshopu potrebno je u postojećem dohvatnom modelu artikala obraditi polja koja označavaju primjenjuje li se bazna cijena i koja je njezina vrijednost te od kojeg datuma vrijedi.

Relevantna polja artikala

Polje

Namjena

Preporuka za obradu

isticanje_bazne_cijene

Označava treba li za artikl isticati baznu cijenu.

Koristiti kao primarni logički indikator za prikaz oznake i pripadnih elemenata na webshopu.

bazna_mpc

Sadrži baznu maloprodajnu cijenu artikla.

Prikazivati uz redovnu cijenu kada je artikl uključen u obvezu.

bazna_mpc_od_datuma

Datum od kojeg bazna cijena vrijedi kao referentna vrijednost.

Obvezno prikazati uz baznu cijenu kao pripadajući datum od kojeg bazna cijena vrijedi.

Preporučena logika prikaza na webshopu
  1. Provjeriti vrijednost polja isticanje_bazne_cijene.

  2. Ako artikl nije uključen u obvezu, ne prikazivati elemente vezane uz baznu cijenu.

  3. Ako je artikl uključen u obvezu, uz redovnu maloprodajnu cijenu prikazati baznu cijenu iz polja bazna_mpc.

  4. Uz baznu cijenu obvezno prikazati pripadajući datum iz polja bazna_mpc_od_datuma.

  5. Za nove integracije koristiti polja bazna_*; postojeće integracije koje koriste sidrena_* polja planirati postupno prebaciti na nove nazive.

Automatizirani dohvat cjenika po poslovnicama

Za javnu web objavu cjenika Luceed API podržava dohvat poslovnica i dohvat cjenika po pojedinoj poslovnici. Ovaj model je prikladan za korisnike koji žele vlastitu automatizaciju objave na web poslužitelju, portalu ili integracijskoj platformi.

API vraća samo one poslovnice koje su u Luceed ERP formi Izvoz cjenika proizvoda i usluga označene za izvoz. Ako poslovnica nije uključena u toj formi, neće biti dostupna za ovaj API scenarij.

Rute

Ruta

Svrha

Napomena

/datasnap/rest/baznecijene/poslovnejedinice

Vraća popis poslovnica dostupnih za izvoz cjenika.

Popis je ograničen na poslovnice označene u ERP formi za izvoz.

/datasnap/rest/baznecijene/cjenici

Vraća cjenik za jednu poslovnicu u odabranom formatu.

Parametri, primjer poziva i struktura odgovora opisani su u kompletnoj API dokumentaciji.

Podržani izlazni formati i distribucija

  • CSV ili XML mogu se odabrati kao izlazni format cjenika, ovisno o tome želi li se jednostavnija datoteka za objavu i obradu ili strukturirani format za integracijski sustav.

  • ZIP kompresija dostupna je kao opcija kada se želi preuzeti komprimirana datoteka cjenika za pojedinu poslovnicu.

  • Sadržaj datoteke vraća se kroz API odgovor kao base64 enkodirani sadržaj, zajedno s nazivom datoteke i pripadajućim MIME tipom.

Praktično, integrator najčešće prvo dohvaća raspoložive poslovnice, zatim za svaku odobrenu poslovnicu preuzima cjenik u željenom formatu i po potrebi s uključenom kompresijom. Točni query parametri, dozvoljene vrijednosti i primjeri odgovora nalaze se u kompletnoj API dokumentaciji.

Preporučeni operativni tijek

  1. U Luceed ERP-u korisnik označi poslovnice u formi Izvoz cjenika proizvoda i usluga.

  2. Integracijski servis poziva rutu /datasnap/rest/baznecijene/poslovnejedinice.

  3. Za svaku vraćenu poslovnicu poziva se ruta /datasnap/rest/baznecijene/cjenici uz odgovarajuće parametre iz kompletne API dokumentacije.

  4. Preuzeti CSV ili XML sadržaj, odnosno ZIP paket, sprema se i objavljuje na ciljnoj web lokaciji.

  5. Proces se pokreće periodički prema internim pravilima ažuriranja cjenika.

Napomena: Dohvat cjenika trenutno je podržan isključivo za današnji datum.

Napomena za objavu: Ako se cjenik javno objavljuje na vlastitoj infrastrukturi, odgovornost za raspored sinkronizacije, dostupnost datoteka, verzioniranje i javni URL ostaje na strani implementatora odnosno korisnika.

Prava pristupa

Prava za dohvat podataka dodjeljuju se kroz formu Administracija prava - Luceed API. Postojećim API korisnicima prava za dohvat podataka o sidrenim cijenama ranije su automatski dodijeljena za grupe radnika koje već imaju omogućen dohvat artikala i maloprodajne cijene (mpc).

Kako prava vrijede za bazna i sidrena polja

  • Za postojeće grupe radnika koje su ranije imale pravo dohvata polja mpc automatski su dodana read-only prava za stara polja sidrena_mpc, sidrena_mpc_od_datuma i isticanje_sidrene_cijene.

  • Novim usklađenjem API-ja ista prava vrijede i za nova polja bazna_mpc, bazna_mpc_od_datuma i isticanje_bazne_cijene, bez potrebe za dodatnom ručnom rekonfiguracijom prava.

  • U formi Administracija prava - Luceed API korisnicima se prikazuje nova terminologija baznih cijena, dok se postojeća interna prava i dalje koriste za oba skupa polja radi unazadne kompatibilnosti.

Povezane korisničke i krovne upute

Za poslovni kontekst, aktivaciju i korisnički postupak koristite povezanu dokumentaciju:

Kada koristiti API model, a kada korisnički izvoz

  • API model koristite kada postoji vlastiti webshop, portal, integracijski servis ili potreba za automatizacijom.

  • Ručni izvoz koristite kada korisnik želi preuzeti gotove datoteke i samostalno ih objaviti bez dodatne integracije.

  • Store Explorer koristite kada je cilj najjednostavnija objava bez razvoja vlastitog web rješenja za cjenik.

Sažetak za implementatore

Područje

Što treba napraviti

Ključna provjera

Prikaz baznih cijena

Obraditi polja isticanje_bazne_cijene, bazna_mpc i bazna_mpc_od_datuma.

Za nove integracije koristiti bazna_* polja, a postojeće integracije planirati prebaciti sa sidrena_* naziva.

Dohvat cjenika

Koristiti rute za poslovnice i cjenik te obraditi CSV, XML ili ZIP izlaz.

Potvrditi da su poslovnice označene u formi Izvoz cjenika proizvoda i usluga.

Prava pristupa

Za postojeće korisnike koji su imali pravo dohvata mpc ranije su automatski dodana prava za sidrena_* polja, a ista prava sada vrijede i za bazna_* polja.

U API administraciji provjeriti prava za dohvat artikala i cjenika; za nove integracije koristiti bazna_* polja i /baznecijene/... rute.