Integrare easybox Sameday în checkout-ul Shopify: cum pui harta de lockere

Vrei ca la finalul comenzii clientul să deschidă o hartă, să caute cel mai apropiat easybox Sameday și să-l aleagă cu un click. Pe WooCommerce e aproape banal. Pe Shopify, lucrurile sunt altfel: pagina de checkout e mult mai închisă, iar dacă încerci pur și simplu să injectezi un cod de hartă în ea, te lovești de un perete.

Vestea bună e că se poate — dar depinde de planul tău Shopify și, mai ales, de locul unde pui harta. În acest ghid îți arăt cele trei variante reale, cum funcționează harta de lockere de la Sameday și, partea pe care mulți o uită, cum faci ca lockerul ales de client să ajungă efectiv pe AWB. Fără promisiuni de „plug and play perfect”.

De ce checkout-ul Shopify nu se comportă ca WooCommerce

Aici e miezul problemei. Vechiul fișier checkout.liquid, în care puteai băga orice cod, a fost scos din uz. Pe planurile standard Shopify, pagina nativă de checkout e practic blindată: nu injectezi liber JavaScript sau o hartă în ea.

Singura cale de a pune componente reale chiar în pagina de checkout sunt Checkout UI Extensions — și acelea sunt disponibile doar pe Shopify Plus. Paginile Thank You și Order Status acceptă extensii pe toate planurile, dar acolo e deja prea târziu: clientul a plătit, nu mai alege metoda de livrare.

Concluzia practică: pentru majoritatea magazinelor care nu sunt pe Plus, harta de lockere NU stă în pagina nativă de checkout. Stă înainte de ea sau printr-o aplicație dedicată.

Cele trei locuri reale unde poți pune harta

Există trei abordări care chiar funcționează în producție:

• Pe pagina de coș sau de produs (cea mai folosită): un widget cu hartă unde clientul alege easybox-ul înainte să intre în checkout. Merge pe orice plan Shopify.
• În pagina de checkout, dar numai pe Shopify Plus: o Checkout UI Extension care afișează un buton „Alege easybox” și deschide harta într-un modal.
• Printr-o aplicație din App Store care adaugă easybox ca punct de ridicare (pickup point), folosind mecanismul nativ Shopify de pickup points.

Pentru un magazin care nu e pe Plus, recomandarea onestă e varianta cu coșul: clientul alege lockerul, iar tu blochezi avansul spre checkout până când selecția e făcută. E cea mai robustă și cea mai ieftină de întreținut.

Cum arată harta Sameday și de unde vin lockerele

Sameday pune la dispoziție atât un widget/plugin de lockere cu hartă interactivă, cât și API-ul lor (același folosit pentru generarea AWB). Ai două drumuri: folosești widgetul lor gata făcut, sau construiești harta ta.

Dacă mergi custom, pașii sunt:

• Autentificare prin token: obții credențialele de API din contul de curierat și ceri un token.
• Ceri lista de lockere easybox de la endpointul de geolocație. Fiecare locker vine cu id, nume, adresă, oraș și coordonate.
• Pui punctele pe o hartă (Leaflet sau Google Maps) sau lași widgetul Sameday să facă asta.

Două detalii importante: asigură-te că iei și lockerele next-gen (cele noi), și pune la cache lista — se schimbă rar, deci nu are sens s-o ceri la fiecare încărcare de pagină.

Partea pe care mulți o uită: să duci lockerul la AWB

Harta e doar jumătate din treabă. Dacă lockerul ales de client nu ajunge la curier, ai făcut un widget frumos și inutil.

Mecanismul pe Shopify:

• Când clientul alege lockerul, salvezi id-ul, numele și adresa lui.
• Pe pagina de coș le stochezi ca atribute de coș, prin apelul /cart/update.js (de exemplu easybox_id, easybox_name), sau ca line item property.
• Așa apar pe comandă și le vezi în admin, la fiecare order.
• La expediere, generarea AWB Sameday trimite codul lockerului ca punct de livrare, pe serviciul easybox.

Conectorii de curierat pentru România — Innoship, EasySales, ShippyPro și altele — citesc automat acest atribut și fac AWB-ul. Fără acest pas, lockerul ales rămâne doar text pe comandă și nu spune nimic curierului.

Aplicație gata făcută vs soluție custom

Nu există un singur răspuns corect — depinde de magazin.

• Aplicație din App Store: pornești repede, plătești un abonament lunar, dar ai mai puțin control asupra designului hărții și te legi de un furnizor.
• Soluție custom (widget + API): control total, integrată perfect în brandingul tău, dar cere dezvoltare și mentenanță (token, actualizări de API, sincronizarea lockerelor).

Pentru multe magazine, combinația câștigătoare e simplă: o aplicație de curierat românească (Innoship sau EasySales) pentru AWB, plus un widget de lockere pe pagina de coș. Fii sceptic la orice promisiune de „se instalează în cinci minute și merge perfect” — testează întotdeauna cu comenzi reale înainte de a-l lăsa pe clienți.

La MPO Web Studio facem exact acest tip de integrare, remote, pentru magazine din toată țara. Îți putem pregăti un demo gratuit chiar pe fluxul tău, ca să vezi harta funcționând înainte să decizi ceva. Un mesaj pe WhatsApp și stabilim.