EN DE AT SL HR NL FR

STUDIJA SLUČAJA

Medilip (Active Luxe)

Mobilni fulfillment skener s kamerom za brže pakiranje.

Sažetak

  • Industrija: E-commerce / Cosmetics / Fulfillment
  • Klijent: Medilip d.o.o. (lastnik blagovne znamke Active Luxe)
  • Deliverable: Custom mobilna fulfillment web aplikacija (kamera + barcode scanning)
  • Uloga: Sistemski dizajn, backend + frontend implementacija, WooCommerce + ERP integracija
  • Integracijske točke: WooCommerce REST API (orders), MiniMax API (item master data + invoices), carrier label identifiers
  • Status: Produkcijski alat za fulfillment ekipu

Kontekst

Active Luxe vodi high-volume e-commerce, gdje su brzina fulfillmenta i točnost pakiranja ključni za iskustvo kupaca. Prije projekta ekipa je ručno tražila narudžbe i vizualno provjeravala proizvode, što postaje problematično kod većeg kataloga, varijanti i sličnih SKU-ova. Trebali su sustav koji radi u skladištu, na telefonu, gdje je kamera primarni input.

Problem

Greške pri pakiranju i spor rad proizlazili su iz više čimbenika:

  • Identifikacija narudžbe je bila ročna (pretraživanje po nalepki/šifri).
  • Provjera artikala temeljila se na pažnji, a ne na validaciji.
  • Bundle/composite artikli povećavaju skrivenu kompleksnost.
  • Warehouse UI mora biti brz, minimalan i camera-first.

Željeni tok bio je: najprije potvrda ispravne narudžbe, zatim validacija svakog artikla skeniranjem.

Ciljevi projekta

  • Odmah identifikacija narudžbe skenom kurirske naljepnice.
  • Prikaz jasnog pick/pack popisa na telefonu.
  • Validacija pakiranja EAN skeniranjem (trenutno upozorenje kod greške).
  • Podrška količinama i prikaz napretka po artiklu.
  • Pravilna obrada bundle/composite artikala.
  • Minimalno trenje u procesu (jedna ruka, minimalni koraci, jasan feedback).

Ograničenja i izazovi

  • Mobile kompatibilnost: skeniranje mora raditi na iOS-u i Androidu.
  • Više izvora identifikacije naljepnica: različiti meta ključevi za tracking.
  • ERP mapping: EAN je u item masterju, ne u WooCommerce line-itemu.
  • Brzina: throttling i zaštita od duplih skenova.
  • Niska potreba za obukom novog osoblja.

Pregled rješenja

Dizajnirali smo mobilnu web aplikaciju koja radi u pregledniku i koristi kameru kao primarni input:

  • Sken kurirske naljepnice → pronalazak WooCommerce narudžbe preko meta podataka.
  • Obogaćivanje line-itemova iz ERP-a (EAN, šifra, naziv), uključujući proširenje composite artikala.
  • Sken EAN-a → povećanje brojača za ispravan artikl.
  • Neusklađenost → trenutno upozorenje.
  • Kad su svi artikli potvrđeni, omogućuje se završni “submit”.

Rezultat je deterministički packing proces u kojem skeniranje osigurava ispravnost.

Arhitektura i tehnički pristup

Alat je PHP aplikacija s minimalnim UI-jem i JSON POST endpointima.

Order lookup po labeli

  • Sken naljepnice pokreće WooCommerce lookup preko meta podataka.
  • Podržani su različiti ključevi: `wgl_labels`, `ParcelNumber`, `_gls_tracking_codes`.

EAN kao izvor istine

  • WooCommerce donosi SKU/količinu, a EAN dolazi iz ERP item masterja (MiniMax).
  • EAN postane deterministična referenca za pravilnost pakiranja.

Composite / bundle proširenje

  • Composite artikli se proširuju u stvarne fizičke komponente.
  • Količine se prilagođavaju ovisno o narudžbi.

Mobilno skeniranje

  • BarcodeDetector polyfill osigurava iOS kompatibilnost.
  • zbar-wasm dodaje podršku za više formata barkodova.
  • Throttling i zaštita od duplikata sprječavaju dvostruke skenove.
  • UI feedback je kodiran bojama (crveno/žuto/zeleno).

Zaključek operacije

  • Kad su svi artikli potvrđeni, dostupan je jedan klik “submit”.
  • Backend može ažurirati WooCommerce narudžbu u custom fulfillment status.

Tehnološki stack

  • 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

  1. Mapiranje warehouse procesa u camera-first flow.
  2. Implementacija robusnog order lookup-a iz kurirskih naljepnica.
  3. ERP obogatitev za EAN identifikacijo.
  4. Composite proširenja za stvarni packing popis.
  5. Skeniranje s throttlingom i UI feedbackom.
  6. Zaključetak procesa ažuriranjem statusa narudžbe.

Rezultati i učinak

  • Brži fulfillment: manje ručnog traženja i provjere.
  • Drastično manje napak pri pakiranju.
  • Manje trenja: telefon + kamera, minimalno uvođenje.
  • Predvidljivije operacije pri bundle artiklima.

Refleksija

Ključ je bio tretirati pakiranje kao deterministički validation problem: ispravna narudžba, ispravni artikli i ispravne količine. Kad je to riješeno, pogreške se sustavno uklanjaju bez dodatnog opterećenja.

Sažetak

Projekt je Medilip/Active Luxe opremio produkcijskim mobilnim skenerom koji povezuje WooCommerce i ERP podatke te skeniranjem osigurava brzo i ispravno pakiranje.

RAZGOVOR O SLIČNOM PROJEKTU