Mogu li spojiti web shop izravno s Arges ERP-om bez duplog unosa?

Mnogi hrvatski trgovci već rade u Arges ERP-u. Umjesto da artikle, cijene i zalihe unose dva puta (jednom u ERP i opet u web shopu), WebShopHR se spaja na prvi Arges SDK i preuzima promjene direktno.

Uvoz artikala i usluga putem prvog SDK-a

WebShopHR koristi službeni arges_erp_go_sdk za sinkronizaciju. Za svaki tenant (dućan) koji postavi Arges API token, sustav preuzima popis artikala i usluga iz Argesa te ih mapira u vlastiti katalog kao artikle i usluge.

SDK funkcionira server-to-server preko HTTPS-a, a WebShopHR u tom odnosu ponaša se kao klijent ERP-a. Bez Arges tokena sync se uopće ne pokreće, pa se prazna konfiguracija ne može prevesti u neočekivano prazan katalog.

Stabilne URL adrese i očuvanje trgovčevog sadržaja

Svaki artikl u dućanu dobiva stabilan URL temeljen na slugu koji se gradi iz naziva i Arges ID-a. Prilikom svakog sljedećeg synca sustav ažurira naziv i cijenu, ali slug ostaje netaknut. To znači da se promjene u Argesu ne lome na postojećim linkovima, pretraživačkim indeksima i kupčevim bookmarkovima. Opise, slike i kategorije koje trgovac doda unutar WebShopHR-a ostaju netaknute. Sync ne pregazuje trgovčev vlastiti sadržaj.

Decimalne zalihe i filtriranje neispravnih zapisa

Arges ERP dopušta da zalihe budu iskazane u decimalama, primjerice za artikle koji se prodaju po težini ili dužini. WebShopHR te podatke čuva u numeričkom tipu s tri decimale, pa se ista preciznost prenosi i u katalog i u zalihe po skladištima.

Tijekom uvoza preskaču se artikli s negativnom cijenom, koji u ERP-u obično predstavljaju kreditne ili storno zapise, a ne prodajne artikle. Time se u katalog dućana ne uvlače računovodstveni korektivni retci.

Idempotentno ažuriranje bez uništavanja pri ponovnom uvozu

Sync radi po načelu upserta po paru (tenant, tip, arges_id). Prvi uvoz kreira artikl, a svaki sljedeći ažurira samo ono što se stvarno promijenilo. Ako se vrijednosti poklapaju, baza ne vidi lažnu promjenu i cijeli dućan se ne hladi bez razloga. Cijene se uvijek pretvaraju iz eura u cente matematičkim zaokruživanjem, nikad odsijecanjem, pa nema off-by-one razlika na blagajni.

Lokacije skladišta i stanja po prostoru

Arges poslovni prostori preuzimaju se kao WebShopHR lokacije, a stanja artikl×prostor pretvaraju se u zalihe po lokaciji. Kada se u ERP-u označi jedna od lokacija kao web lokacija, njezino se stanje preslikava u glavni prodajni stock artikla, ali samo za artikle bez varijanti. Varijante tu postavku ne prate: njihova prodajna zaliha ostaje zbroj stanja sa svih poslovnih prostora, bez obzira koja je lokacija web lokacija (vidi Varijante). S druge strane, ručno uneseni stock u WebShopHR-u ostaje netaknut ako artikl nema web lokaciju, pa trgovac uvijek zadržava zadnju riječ.

Rukovanje iznimkama i fail-closed ponašanje

Ako Arges povezivanje nije ispravno konfigurirano, sync se odmah zaustavlja s jasnom porukom o grešci i ne nastavlja rad u nepouzdanom stanju. To sprječava situaciju u kojoj bi se neispravno ažurirale cijene ili zalihe, što bi moglo uzrokovati prodaju artikla kojeg nema na skladištu. Fail-closed ponašanje važi i za fiskalizaciju: bez ispravnog Arges tokena i naplatnog uređaja sustav ne šalje račune u prazno.

Ručni okidač, bez automatskog rasporeda

Sync se pokreće isključivo ručno: trgovac ga pokreće iz CMS-a jednim klikom na gumb, a razvojni i operativni tim može koristiti i devsync CLI alat za pojedinačni tenant bez ulaska u CMS. Ne postoji periodički raspored koji bi sync sam okidao u pozadini. Dok netko ne klikne (ili ne pokrene devsync), promjene u Argesu čekaju.

Mock ERP za testiranje i razvoj

U testnom i razvojnom okruženju sustav nudi mock implementaciju Arges sučelja (mockarges). Razvojni tim može testirati sinkronizaciju, fiskalizaciju i storno bez pristupa pravom ERP-u, a mock poštuje istu paginaciju i stranicu kao i stvarni Arges. To omogućuje sigurno razvijanje i održavanje konektora bez rizika od oštećenja produkcijskih podataka.

Standalone-first pristup i obrnuti freemium

Iako Arges integracija štedi vrijeme, dućan u potpunosti funkcionira i bez nje. Artikli, kategorije, cijene i zalihe mogu se unositi izravno u CMS.

Freemium model trgovcima omogućuje da prvo pokrenu dućan i tek kasnije aktiviraju napredne ERP poveznike prema potrebi. Kad se Arges spoji, Free paket automatski dobiva neograničen broj artikala i 0 % provizije, pa se WebShopHR ponaša kao prodajni kanal ERP-a, a ne kao dodatni trošak.

Spajanjem s Arges ERP-om artikli, usluge i zalihe unose se na jednom mjestu, a u dućan se pouzdano preuzimaju bez dvostrukog posla i bez gubitka povijesti.

Više o temi: Sigurnost i infrastruktura.