ŠTUDIJA PRIMERA
Medilip (Active Luxe)
Mobilni fulfillment skener s kamero za hitrejše pakiranje.
Povzetek
- Industrija: E-commerce / Cosmetics / Fulfillment
- Naročnik: Medilip d.o.o. (lastnik blagovne znamke Active Luxe)
- Deliverable: Custom mobilna fulfillment web aplikacija (kamera + barcode scanning)
- Vloga: Sistemska zasnova, backend + frontend implementacija, WooCommerce + ERP integracija
- Integracijske točke: WooCommerce REST API (orders), MiniMax API (item master data + invoices), carrier label identifiers
- Status: Produkcijsko orodje za fulfillment ekipo
Kontekst
Active Luxe vodi high-volume e-commerce, kjer sta hitrost fulfillmenta in natančnost pakiranja ključni za izkušnjo kupcev. Pred projektom je ekipa ročno iskala naročila in vizualno preverjala izdelke, kar postane problematično pri večjem katalogu, variantah in podobnih SKU-jih. Potrebovali so sistem, ki deluje v skladišču, na telefonu, kjer je kamera primarni input.
Problem
Napake pri pakiranju in počasno delo so izhajali iz več dejavnikov:
- Identifikacija naročila je bila ročna (iskanje po nalepki/šifri).
- Preverjanje artiklov je temeljilo na pozornosti, ne na validaciji.
- Bundle/composite artikli povečajo skrito kompleksnost.
- Warehouse UI mora biti hiter, minimalen in camera-first.
Želeni tok je bil: najprej potrditev pravilnega naročila, nato validacija vsakega artikla s skenom.
Cilji projekta
- Takojšnja identifikacija naročila s skenom kurir nalepke.
- Prikaz jasnega pick/pack seznama za telefon.
- Validacija pakiranja z EAN skenom (takojšnje opozorilo ob napaki).
- Podpora količinam in prikaz napredka po artiklu.
- Pravilna obravnava bundle/composite artiklov.
- Minimalen trenje v procesu (ena roka, minimalni koraki, jasen feedback).
Omejitve in izzivi
- Mobile kompatibilnost: scanning mora delovati na iOS in Android.
- Več virov label identifikacije: različni meta ključi za tracking.
- ERP mapping: EAN je v item masterju, ne v WooCommerce line-itemu.
- Hitrost: throttling in zaščita pred podvojenimi skeni.
- Nizka potreba po uvajanju novega osebja.
Pregled rešitve
Zasnovali smo mobilno web aplikacijo, ki teče v browserju in uporablja kamero kot primarni input:
- Sken kurir nalepke → najdi WooCommerce naročilo prek meta podatkov.
- Obogatitev line-itemov z ERP (EAN, code, naziv), vključno z razširitvijo composite artiklov.
- Sken EAN → povečanje števca pravilnega artikla.
- Neujemanje → takojšnje opozorilo.
- Ko so vsi artikli potrjeni, se omogoči zaključni “submit”.
Rezultat je determinističen packing proces, kjer pravilnost zagotavlja skeniranje.
Arhitektura in tehnični pristop
Orodje je PHP aplikacija z minimalnim UI in JSON POST endpointi.
Order lookup po labeli
- Label scan sproži WooCommerce lookup preko meta podatkov.
- Podprti so različni ključi: `wgl_labels`, `ParcelNumber`, `_gls_tracking_codes`.
EAN kot vir resnice
- WooCommerce prinese SKU/quantity, EAN pa pride iz ERP item masterja (MiniMax).
- EAN postane deterministična referenca za pravilnost pakiranja.
Composite / bundle razširitev
- Composite artikli se razširijo v realne fizične komponente.
- Količine se prilagodijo glede na naročilo.
Mobilno skeniranje
- BarcodeDetector polyfill zagotovi iOS kompatibilnost.
- zbar-wasm doda podporo za več formatov črtnih kod.
- Throttling in duplikatna zaščita preprečita podvojene skene.
- UI feedback je barvno kodiran (rdeče/rumeno/zeleno).
Zaključek operacije
- Ko so vsi artikli potrjeni, je na voljo en klik “submit”.
- Backend lahko posodobi WooCommerce order v custom fulfillment status.
Tehnološki sklad
- PHP (single-page app + JSON endpointi)
- WooCommerce REST API (Automattic WooCommerce Client)
- MiniMax API (OAuth + item/invoice queries)
- JavaScript (camera scanning + UI state)
- Barcode stack: BarcodeDetector polyfill + zbar-wasm
- UI: Material Design Lite + table UI
Proces implementacije
- Mapiranje warehouse procesa v camera-first flow.
- Implementacija robustnega order lookup-a iz kurir nalepk.
- ERP obogatitev za EAN identifikacijo.
- Composite razširitve za realni packing seznam.
- Skeniranje z throttlingom in UI feedbackom.
- Zaključek procesa z posodobitvijo statusa naročila.
Rezultati in učinek
- Hitrejši fulfillment: manj ročnega iskanja in preverjanja.
- Drastično manj napak pri pakiranju.
- Manj trenja: telefon + kamera, minimalno uvajanje.
- Bolj predvidljive operacije pri bundle artiklih.
Refleksija
Ključ je bil obravnavati packing kot determinističen validation problem: pravilno naročilo, pravilni artikli, pravilne količine. Ko je to rešeno, se napake sistematično odstranijo brez dodatne obremenitve.
Povzetek
Projekt je Medilip/Active Luxe opremil s produkcijskim mobilnim skenerjem, ki poveže WooCommerce in ERP podatke ter s skeniranjem zagotovi hitro in pravilno pakiranje.