Integrare Sameday — AWB automat, easybox si tracking direct pe site

Pentru un magazin WooCommerce sau Shopify standard, integrarea Sameday costa intre 400€ si 800€ implementare one-off, fara fee lunar de la noi (Sameday isi factureaza separat coletele). Pretul depinde de: numarul de servicii folosite (doar AWB vs AWB + easybox + retur self-service + ramburs), daca ai deja cont Sameday activat sau il setam noi (semnare contract, parametrii pickup-points), cate template-uri de etichete vrei (PDF A4, PDF 100x150, ZPL pentru imprimante termice Zebra), si daca vrei dashboard custom de tracking sau folosesti panel-ul Sameday. Pentru stack-uri custom (Next.js, Astro, PHP propriu) cresc cu 200-400€ deoarece nu avem plugin gata facut si scriem clientul API de la zero.

Tipic 5-10 zile lucratoare pentru un magazin standard. Ziua 1-2: primim acces la contul Sameday (X-AUTH-TOKEN, lista pickup-points, servicii contractate cu ei), mapam tipurile tale de produse pe servicii Sameday (Standard, Curier Rapid, Easybox). Ziua 3-5: implementare client API in n8n sau cod custom, formular checkout cu selectie easybox prin /api/lockers, generare AWB la confirmare comanda. Ziua 6-7: testing cu comenzi reale (3-5 colete trimise efectiv ca sa validam etichete + tracking). Ziua 8-10: tracking webhook, retur self-service, dashboard. Daca nu ai cont Sameday activ inca, adauga 5-7 zile pentru semnare contract cu ei.

Workflow tipic: 1) Client finalizeaza comanda pe site cu metoda livrare Sameday (curier la adresa sau easybox). 2) Daca alege easybox, ii afisam lista locker-uri din /api/lockers filtrate pe judet/oras, salveaza lockerID in comanda. 3) Cand confirmati comanda in admin (sau automat la plata), un POST la api.sameday.ro/api/awb cu Authorization X-AUTH-TOKEN + payload (greutate, dimensiuni, ramburs, lockerID daca easybox). 4) Primim awbNumber + URL eticheta PDF/ZPL. 5) Salvam in CRM/magazin, trimitem email tracking clientului. 6) Webhook periodic pe GET /api/awb/{awbNumber}/status actualizeaza status (preluat, in tranzit, livrat, returnat). 7) Mail automat la fiecare schimbare status. 8) Retur initiat self-service din contul clientului = alt POST la /api/awb.

Mergem pe orice stack care poate face request HTTP. 1) WooCommerce: plugin oficial Sameday Romania exista (configuram cu credentialele tale, customizam template etichete, adaugam easybox in checkout). 2) Shopify: nu exista app oficiala Sameday in App Store, folosim middleware n8n care asculta webhook Shopify order/create si genereaza AWB; checkout easybox via app custom Shopify scrisa de noi. 3) PrestaShop: modul comunitar Sameday disponibil, il configuram. 4) Magento 2: extensie partiala, completam manual. 5) Next.js, Astro, custom PHP: scriem client API in TypeScript/PHP cu axios sau fetch direct la endpoint-urile api.sameday.ro, zero dependinte. Recomandare: stack custom = mai mult control + mai putin overhead plugin.

La checkout, dupa ce clientul introduce adresa, daca a ales livrare easybox, facem un GET /api/lockers cu filtru county si city (sau coordonate GPS). API-ul returneaza lista locker-uri active cu nume (ex: Easybox Mega Image Aviatorilor), adresa fizica, program (24/7 sau cu program), distance daca trimitem geo. Afisam pe o harta Google Maps sau Leaflet cu marker-e (recomandat) si lista alaturata cu cautare. Clientul da click pe locker dorit, salvam lockerID + locker_name in comanda. La generare AWB trimitem awbPayload cu service: easybox + lockerID. Important: cache-uim lista lockers 24h (nu se schimba des) ca sa nu spammam API-ul Sameday cu requests la fiecare checkout.

Erori frecvente: 1) X-AUTH-TOKEN expirat sau invalid — Sameday roteste tokenuri la cerere, monitoring cu alerta in Slack/email cand vine 401. 2) Pickup point inactiv — Sameday dezactiveaza pickup-points fara avizare, validam zilnic ca pickup-ul tau e still active. 3) Greutate/dimensiuni invalide (sub minim 0.1kg sau peste maxim contract) — validam in frontend inainte sa trimitem. 4) LockerID inexistent (locker scos din uz intre add la cos si checkout) — fallback automat la curier la adresa cu notificare client. 5) Rate limit Sameday (rar, dar peste 100 req/min uneori) — coada cu retry exponential backoff. 6) Adresa de livrare neidentificabila — geocoding cu fallback Nominatim. Toate erorile loggate in Sentry sau echivalent, retry automat de 3 ori inainte sa intervenim manual.

Sameday API e cel mai modern dintre cei trei: REST clean cu JSON, autentificare X-AUTH-TOKEN simpla, documentatie OK (sameday-api.docs.apiary.io), endpoint /api/lockers pentru easybox e unicul printre curierii romani. Fan Courier are API SOAP/XML mai vechi + REST partial, mai dureros de integrat, fara echivalent easybox dar are FAN Box partial. Cargus are URGENTcargus API REST decent, fara locker network propriu (folosesc DPD ShopOnline ca terta parte). Recomandam combo: Sameday pentru clienti care vor easybox (cresc conversia 8-15% pentru cosuri mici), Fan Courier sau Cargus ca backup pentru rute unde Sameday nu acopera bine. Putem integra toate trei intr-un workflow unificat cu rule-based routing pe cod postal.

Da, cazuri unde nu se justifica: 1) Magazine sub 20 comenzi pe luna — manual prin panel.sameday.ro e mai ieftin decat sa platesti integrare. 2) Produse mari sau grele care nu intra in tarif Sameday standard (peste 30kg sau peste 80cm) — folosesti curier dedicat tipul Cargus colete mari sau transportator local. 3) Livrari B2B cu paletizare sau cargo — Sameday face dar nu e specialitatea lor, mai bun Dumitruk sau Romcargo Trans. 4) Daca volumul tau e foarte mic dar ai retururi multe — fee-urile per AWB la volum mic + retur le inghit profit. 5) Daca contractul tau Sameday inca nu acopera zona geografica unde livrezi des — verifica acoperire inainte de implementare. Pentru toate cazurile alternative, recomandam integrarea unui agregator (Innoship, Sameday Connect) care multiplexeaza pe mai multi curieri.