Ispravno slanje cijena u nalozima prodaje putem Luceed API-ja

Ovaj članak opisuje kako ispravno slati cijene s porezom putem Luceed API-ja pri kreiranju naloga prodaje prema webshop narudžbama. Cilj je osigurati da iznos naplaćen kupcu odgovara iznosu evidentiranom na nalogu u Luceedu.


Osnovni uvjet je da cijena s porezom mora biti zaokružena na najviše dvije decimale.

Postoje dva načina slanja cijena putem Luceed API-ja:

  1. Odvojeno slanje cijene prije rabata i postotka rabata

  2. Slanje cijene umanjene za rabat, bez posebnog slanja postotka rabata

Ovisno o odabranom načinu, primjenjuje se jedan od dva opisana postupka izračuna.


1. Ako odvojeno šaljete cijenu prije rabata i postotak rabata

Iznos za naplatu kupcu izračunajte na sljedeći način:

ROUND(SUM(količina × cijena s porezom), 2) − ROUND(SUM(količina × iznos rabata), 2)

gdje je:

iznos rabata = cijena s porezom × (postotak rabata / 100)

Napomena: iznos rabata po jedinici ne zaokružuje se prije izračuna ukupnog rabata.

Primjer: 3 komada × 6,45 EUR − 10 % rabata

Vrijednost

Izračun

Rezultat

Ukupan iznos

ROUND(SUM(3 × 6,45), 2)

19,35

Ukupan rabat

ROUND(SUM(3 × 0,645), 2)

1,94

Iznos za naplatu

19,35 − 1,94

17,41


2. Ako šaljete cijenu umanjenu za rabat

Cijenu umanjenu za rabat zaokružite na dvije decimale prije slanja (npr. 5,81, ne 5,805). U tom slučaju ne šaljete postotak rabata jer je rabat već uključen u cijenu.

Iznos za naplatu kupcu tada je:

ROUND(SUM(količina × cijena s porezom umanjena za rabat), 2)

Primjer: 3 komada × 5,81 EUR

Vrijednost

Izračun

Rezultat

Iznos za naplatu

ROUND(SUM(3 × 5,81), 2)

17,43


Ključne napomene

Razlike između metoda i dosljednost primjene

Zbog različitog trenutka zaokruživanja ove dvije metode mogu dati različite ukupne iznose. U navedenom primjeru prva metoda daje iznos od 17,41 EUR, a druga iznos od 17,43 EUR.

Odaberite jednu metodu te je dosljedno primjenjujte pri izračunu iznosa koji naplaćujete kupcu i pri slanju cijena u Luceed API. Na taj će način iznos naplaćen kupcu odgovarati iznosu evidentiranom na nalogu u Luceedu.


Utjecaj količine na izračun (1 komad vs. N komada)

Kod prve metode iznos rabata obračunava se na ukupnu vrijednost stavke prije konačnog zaokruživanja. Zbog toga ukupni iznos za npr. 100 komada ne mora uvijek biti jednak stostrukom iznosu za 1 komad:

  • Kupnja 1 komada: Rabat se zaokružuje na razini 1 komada.

  • Kupnja N komada: Rabat se obračunava na ukupnu vrijednost N komada te se tek tada zaokružuje.


Usporedni prikaz iznosa na nalogu (primjer cijene 19,99 EUR uz 10,00 % rabata):

Količina

Cijena s porezom

Postotak rabata

Iznos - Metoda 1

Iznos - Metoda 2

1 kom

19,99 EUR

10,00 %

17,99 EUR

17,99 EUR

10 kom

19,99 EUR

10,00 %

179,91 EUR

179,90 EUR

100 kom

19,99 EUR

10,00 %

1.799,10 EUR

1.799,00 EUR

Pojašnjenje: Kod 1 komada iznos je u obje metode jednak (17,99 EUR). Već kod 10 komada javlja se razlika od 1 centa (179,91 EUR vs. 179,90 EUR) jer prva metoda obračunava rabat od 10 % na ukupnih 199,90 EUR (rabat iznosi 19,99 EUR), dok druga metoda množi 10 komada s unaprijed zaokruženom cijenom od 17,99 EUR. Obje metode su matematički točne. Ako želite da iznos na nalogu bude uvijek proporcionalan broju komada, preporučuje se primjena druge metode.


:bulb:

Preporuka za prikaz u webshop košarici

Kod prve metode ukupni iznos stavke i ukupni rabat izračunavaju se na razini cijele količine, a ne po jedinici. Zbog toga jedinična cijena nakon primijenjenog rabata može na strani webshopa imati više od dvije decimale (npr. 19,99 EUR × 10 % rabata = 17,991 EUR po komadu).

Ako webshop u košarici prikazuje raščlambu stavke po jedinici, preporučuje se:

  • Prikazivati ukupni iznos stavke i ukupni iznos rabata na razini stavke (ne po komadu).

  • Izbjegavati prikazivanje zaokružene jedinične cijene s rabatom ako bi njezin umnožak s količinom davao prividno drukčiji iznos od prikazanog ukupnog iznosa.

Ova preporuka odnosi se isključivo na prikaz u sučelju webshopa i nema utjecaja na slanje podataka u Luceed API.


Kako odabrati odgovarajuću metodu?

Odaberite prvu metodu ako:

  • Na nalogu i računu želite eksplicitno prikazati postotak i/ili iznos odobrenog rabata.

  • U Luceed ERP-u vodite analitiku i izvještaje o odobrenim rabatima.

  • Webshop raspolaže samo osnovnom cijenom s porezom i postotkom rabata te nema mogućnost preračunavanja neto jedinične cijene.

Odaberite drugu metodu ako:

  • Želite da ukupni iznos na nalogu bude uvijek proporcionalan količini (N × jedinična cijena).

  • Webshop prikazuje raščlambu po komadu u košarici i želite izbjeći vizualna odstupanja u centima.

  • Webshop koristi fiksne akcijske cijene ili popuste u apsolutnom iznosu.


Tehnička ograničenja i usklađenost

Slanje cijena s više od dvije decimale trenutačno nije tehnički onemogućeno, ali može uzrokovati razlike u iznosima na nalogu. Od listopada 2026. slanje cijena s porezom s više od dvije decimale bit će onemogućeno na razini API-ja.

Pravilnim slanjem cijena s porezom prema ovim uputama osigurava se usklađenost iznosa kroz cijeli proces: od web narudžbe, preko naloga prodaje i računa predujma, do konačnog maloprodajnog računa. Time se izbjegavaju razlike između iznosa naplaćenog kupcu i iznosa evidentiranog u Luceedu.