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:
-
Dohvat podataka o artiklima za prikaz baznih cijena na webshopu, mobilnim aplikacijama ili drugim digitalnim sučeljima.
-
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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
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 |
|---|---|---|
|
|
Označava treba li za artikl isticati baznu cijenu. |
Koristiti kao primarni logički indikator za prikaz oznake i pripadnih elemenata na webshopu. |
|
|
Sadrži baznu maloprodajnu cijenu artikla. |
Prikazivati uz redovnu cijenu kada je artikl uključen u obvezu. |
|
|
Datum od kojeg bazna cijena vrijedi kao referentna vrijednost. |
Obvezno prikazati uz baznu cijenu kao pripadajući datum od kojeg bazna cijena vrijedi. |
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 |
|---|---|---|
|
|
Vraća popis poslovnica dostupnih za izvoz cjenika. |
Popis je ograničen na poslovnice označene u ERP formi za izvoz. |
|
|
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
base64enkodirani 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
-
U Luceed ERP-u korisnik označi poslovnice u formi Izvoz cjenika proizvoda i usluga.
-
Integracijski servis poziva rutu
/datasnap/rest/baznecijene/poslovnejedinice. -
Za svaku vraćenu poslovnicu poziva se ruta
/datasnap/rest/baznecijene/cjeniciuz odgovarajuće parametre iz kompletne API dokumentacije. -
Preuzeti CSV ili XML sadržaj, odnosno ZIP paket, sprema se i objavljuje na ciljnoj web lokaciji.
-
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
mpcautomatski su dodana read-only prava za stara poljasidrena_mpc,sidrena_mpc_od_datumaiisticanje_sidrene_cijene. -
Novim usklađenjem API-ja ista prava vrijede i za nova polja
bazna_mpc,bazna_mpc_od_datumaiisticanje_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 |
Za nove integracije koristiti |
|
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 |
U API administraciji provjeriti prava za dohvat artikala i cjenika; za nove integracije koristiti |