Preskoči na sadržaj

Kolačići

Googleovi kolačići za mjerenje i oglase? Privatnost

Luceed integracija webshopa: Nalog prodaje bez prepisivanja.

Povezujemo webshop po mjeri s Luceed ERP-om preko Luceed API-ja: zalihe i kupci dolaze iz Luceeda, a narudžba s webshopa ulazi u Luceed kao nalog prodaje.

Provjerimo vaš LuceedKako radi ERP integracija

Pisana ponuda s cijenom, rokom i planom rada je besplatna i bez obveze.

  • Prvo pilot bez ijednog upisa u Luceed
  • Narudžba postaje nalog prodaje
  • Konektor po projektu, prema dokumentaciji

Zadnji put provjereno 25. 9. 2026.

Ukratko: Luceed integracija webshopa je konektor koji zalihe, šifrarnike i kupce čita iz Luceed ERP-a preko Luceed API-ja, a narudžbu s webshopa upisuje u Luceed kao nalog prodaje, bez ručnog prepisivanja. Namijenjena je trgovcima kojima Luceed vodi skladište i fakturiranje.
Stanje
Konektor za Luceed još nismo isporučili u produkciji; pišemo ga po projektu prema javnoj dokumentaciji sustava. U produkciji radi naša veza s drugim ERP-om, na nostrimaris.hr: katalog i upis narudžbi kroz API koji taj ERP daje za webshop. Za Luceed zato krećemo pilotom samo za čitanje, a zaštitu od dvostrukog upisa i ponovni pokušaj gradimo u konektoru.
Gdje radi
Luceed API je REST servis (JSON, basic auth) koji isporučuje Luceed. Konektor radi na poslužitelju webshopa i poziva samo metode koje odobri vaš administrator.
Tipičan paket
Scale, 4.170 €: jedna dokumentirana integracija i jedno skladište. Više skladišta, više integracija ili više tržišta kao jedan sustav je Enterprise, od 8.900 €. Nadzor sinkronizacije nakon lansiranja pokriva plan Održavanje Scale (390 € mjesečno).
Prvi korak
Prvi korak je pilot samo za čitanje: konektor čita artikle, cijene i zalihe iz vaše probne baze ili kopije, bez ijednog upisa u ERP. Upis narudžbi uključujemo tek kad potvrdite da podaci odgovaraju.
Podaci i ugovori
Podaci su u EU-u (baza u Frankfurtu). NDA i ugovor o obradi podataka (GDPR čl. 28) potpisujemo na zahtjev. Tehnologija i sigurnost 
Ako FIN STUDIO prestane poslovati
Dobivate izvorni kod s pravom da ga drugi izvođač održava i nadograđuje. Svakodnevno sve vodite sami u administraciji, a podatke izvozite kad želite. Da rad webshopa ne ovisi o nama, račune za hosting i bazu možete od prvog dana voditi na ime svoje tvrtke; to odaberete u ponudi.

PDV se ne obračunava.

Što Tomsoft objavljuje o Luceed API-ju

Sedam činjenica iz službene dokumentacije koje određuju kako se konektor gradi. Uz svaku stoji izvor.

  1. Luceed API je RESTful web servis koji podatke razmjenjuje u JSON formatu, a za autentifikaciju koristi basic authentication s korisničkim imenom i lozinkom.

    Izvor: Tomsoft: Luceed API (pristup i autentifikacija)

  2. Administracija pristupa određuje koje metode i koji podaci unutar njih su dostupni pojedinom korisniku. Pristupne podatke i popis metoda traži se od tvrtke čiji se Luceed koristi.

    Izvor: Tomsoft: Luceed API (pristup i autentifikacija)

  3. Tomsoft navodi da API servisi omogućuju automatski prijenos podataka poput stanja zaliha, narudžbi i klijenata između Luceed ERP-a i internetske trgovine.

    Izvor: Tomsoft: Luceed API Documentation

  4. Metode koje vraćaju popis podataka mogu se čitati po stranicama, parametrima [od_zapisa, broj_zapisa]. Podrška se uvodi postupno, metodu po metodu.

    Izvor: Tomsoft: Dohvat podataka s paginacijom

  5. Parametar timestamp vraća samo zapise izmijenjene ili dodane nakon zadanog vremena. Obrisani zapisi u tom odgovoru ne dolaze, a kad se promijeni struktura poruke, vraća se cijeli šifrarnik.

    Izvor: Tomsoft: Dohvat samo izmijenjenih podataka

  6. Kod naloga prodaje iz webshop narudžbe cijena s porezom smije imati najviše dvije decimale. Od listopada 2026. slanje s više decimala bit će onemogućeno na razini API-ja.

    Izvor: Tomsoft: Ispravno slanje cijena u nalozima prodaje

  7. Metoda naloziprodaje/snimi od lipnja 2026. prima neobavezno polje trosarina_iznos na stavkama, koje se koristi za osnovicu rabata kod trošarinske robe.

    Izvor: Tomsoft: Release notes, lipanj 2026.

Dokumentacija provjerena 25. rujna 2026. Sučelja se mijenjaju s verzijama, pa prije procjene opsega provjeravamo verziju koju vi koristite.

Što Luceed šalje, što prima

Najveći dio podataka teče prema webshopu. Natrag ide narudžba, i to kao dokument koji Luceed već poznaje.
Artikli i šifrarnici
Luceed → webshop
Metodama koje vaš administrator otvori API korisniku, po stranicama i samo izmjene od zadnjeg uspješnog poziva. Opisi, slike i SEO polja žive u webshopu.
Cijene i rabati
Luceed ↔ webshop
Cijena koju webshop prikaže i naplati vraća se na stavku naloga: s porezom, na dvije decimale, s rabatom poslanim zasebno ili već uračunatim u cijenu.
Zalihe
Luceed → webshop
Stanje zaliha jedan je od podataka koje Tomsoft navodi za razmjenu s webshopom. Tempo osvježavanja i sigurnosnu rezervu određujemo po brzini obrtaja artikla.
Narudžbe
webshop → Luceed
Narudžba ulazi kao nalog prodaje (naloziprodaje/snimi), sa šiframa artikala i kupca koje Luceed prepoznaje.
Kupci i B2B uvjeti
Luceed ↔ webshop
Klijenti su među podacima koje API razmjenjuje. Prije prve sinkronizacije odlučuje se nastaje li B2B partner u webshopu ili u Luceedu.
Dokumenti
nastaju u Luceedu
Nalog prodaje, račun za predujam i konačni maloprodajni račun vode se u Luceedu. Iznos na svakom mora biti jednak onome što je kupac platio na webshopu.

Cent razlike na nalogu

Tomsoft dopušta dvije metode slanja rabata i sam objavljuje primjer u kojem daju različit iznos. Obje su točne; greška nastaje kad webshop naplati po jednoj, a nalog zapiše po drugoj.

  • Što se šalje

    Rabat zasebno
    Cijena s porezom i postotak rabata
    Rabat u cijeni
    Cijena s porezom, već umanjena za rabat

  • Primjer

    Rabat zasebno
    3 kom × 6,45 EUR, rabat 10 %
    Rabat u cijeni
    3 kom × 5,81 EUR

  • Izračun

    Rabat zasebno
    ROUND(3 × 6,45; 2) − ROUND(3 × 0,645; 2)
    Rabat u cijeni
    ROUND(3 × 5,81; 2)

  • Iznos na nalogu

    Rabat zasebno
    17,41 EUR
    Rabat u cijeni
    17,43 EUR

  • Kada

    Rabat zasebno
    Rabat želite vidjeti na nalogu i računu
    Rabat u cijeni
    Iznos mora pratiti količinu (N × cijena)

Za iznos koji uvijek prati količinu Tomsoft preporučuje drugu metodu. Kod prve se rabat računa na ukupnu vrijednost stavke, pa 100 komada ne mora stajati točno stostruko koliko jedan.

Primjer i preporuka: Tomsoft: Ispravno slanje cijena u nalozima prodaje

Standard ili dogovor po projektu

Lijevo je ono što svaki Luceed konektor dobiva. Desno su odluke koje ovise o vašoj instalaciji i procesu.

Standardno u konektoru

  • Ključ artikla dogovoren prije prve sinkronizacije
  • Pohranjen timestamp zadnjeg uspješnog poziva i povremeni puni dohvat zbog obrisanih zapisa
  • Dohvat po stranicama na metodama koje to podržavaju
  • Isto pravilo zaokruživanja u košarici i na nalogu prodaje
  • Zaštita od dvostrukog naloga kad se slanje ponovi
  • Zapis svakog prijenosa i upozorenje kad sinkronizacija izostane

Dogovara se po projektu

  • Metode i podaci koje otvori vaš Luceed administrator
  • Način slanja rabata: zasebno ili uračunat u cijenu
  • Tko otvara B2B partnera: webshop ili Luceed
  • Trošarinska roba i iznos trošarine na stavkama
  • Koji statusi i dokumenti se vraćaju kupcu u korisnički račun
  • Tempo osvježavanja zaliha i sigurnosna rezerva po artiklu

Gdje Luceed integracija zapne

Sve četiri proizlaze iz ponašanja koje Tomsoft dokumentira, pa se rješavaju dogovorom na početku projekta.

  • Obrisani artikl ne stigne

    Dohvat preko parametra timestamp vraća izmijenjene i nove zapise, ne i obrisane. Webshop to sazna tek iz povremenog punog dohvata. Tomsoft preporučuje deaktivaciju umjesto brisanja, pa to dogovaramo s vašim timom na početku.

  • Cijeli šifrarnik odjednom

    Kad se promijeni struktura poruke, timestamp dohvat vrati cijeli šifrarnik. Konektor ga prima po stranicama i ne tumači ga kao tisuće stvarnih izmjena artikala.

  • Metoda nije otvorena

    API korisnik vidi samo metode i podatke koje mu dodijeli administracija pristupa. Popis tražimo prije procjene opsega, jer bez njega nije jasno koji je tok podataka uopće moguć.

  • Cent razlike na nalogu

    Dvije dopuštene metode slanja rabata daju različite iznose već kod nekoliko komada. Ako košarica računa jednom, a nalog drugom metodom, razlika se vidi na svakom računu.

Ako vaš webshop radi na platformi za koju postoji gotov dodatak povezan s Luceedom i on pokriva vaš proces, to je brži i manji projekt od konektora po mjeri. Konektor po mjeri ima smisla kad webshop mora pratiti vaše B2B cijene, rabate i dokumente točno onako kako ih vodi Luceed, kao kod B2B webshopa.

Pitanja o Luceed integraciji

Što treba dobiti od Luceed administratora?

API korisnika s korisničkim imenom i lozinkom, jer Luceed API koristi basic authentication, i popis metoda koje mu administracija pristupa otvori. API korisnik vidi samo dodijeljene metode i podatke, pa popis tražimo prije procjene opsega: bez njega nije jasno koji je tok podataka uopće moguć.

Kako narudžba s webshopa ulazi u Luceed?

Kao nalog prodaje, metodom naloziprodaje/snimi, sa šiframa artikala i kupca koje Luceed prepoznaje. Nalog prodaje, račun za predujam i konačni maloprodajni račun vode se u Luceedu, a iznos na svakom mora biti jednak onome što je kupac platio na webshopu.

Zašto se iznos na Luceed nalogu može razlikovati za cent?

Tomsoft dopušta dvije metode slanja rabata: cijenu s porezom i postotak rabata, ili cijenu već umanjenu za rabat. U Tomsoftovom primjeru, 3 komada po 6,45 EUR uz rabat 10 %, prva metoda daje 17,41 EUR, a druga 17,43 EUR. Košarica i nalog zato računaju istom metodom, a cijena s porezom na nalogu ima najviše dvije decimale.

S čim počinje Luceed projekt?

S pilotom samo za čitanje. Konektor za Luceed još nismo isporučili u produkciji; pišemo ga po projektu prema Tomsoftovoj dokumentaciji, a u produkciji radi naša veza s drugim ERP-om, na nostrimaris.hr. Konektor zato prvo čita šifrarnike, kupce i zalihe iz probne baze ili kopije, bez ijednog upisa u Luceed. Upis naloga prodaje uključujemo tek kad potvrdite da podaci odgovaraju.

Tomsoftova dokumentacija

Sve tvrdnje o Luceed API-ju na ovoj stranici dolaze iz službene dokumentacije proizvođača.
  1. Tomsoft: Luceed API Documentation
  2. Tomsoft: Luceed API (pristup i autentifikacija)
  3. Tomsoft: Dohvat podataka s paginacijom
  4. Tomsoft: Dohvat samo izmijenjenih podataka
  5. Tomsoft: Ispravno slanje cijena u nalozima prodaje
  6. Tomsoft: Release notes, lipanj 2026.

Sve poveznice otvorene i provjerene 25. rujna 2026.

Povezano

ERP integracija webshopaSmjerovi sinkronizacije, API ili datoteke i što u praksi puca, za bilo koji ERP.B2B webshopCjenici i rabati po kupcu, plaćanje na račun i narudžbe koje ulaze ravno u ERP.Cijena izrade webshopaPaketi, što ulazi u opseg integracije i što plaćate mjesečno.Pantheon webshop integracijaPAWS · Ident · Order · Stock · DBObjectsMinimax webshop integracijaMinimax API · OAuth2 · dnevni limitSAP Business One webshop integracijaService Layer · OData v4

Pošaljite popis Luceed metoda koje imate

Ako znate koje metode vam Luceed administrator može otvoriti, pošaljite popis uz opis kako danas idu narudžbe. Iz toga slijedi opseg konektora i fiksna cijena za dogovoreni opseg.

Provjerimo vaš Luceed

Odgovor unutar 24 sata radnim danom. Bez obveze. Ako integracija nije isplativa, reći ćemo vam to.