netSEO Sameday Status pentru CS-Cart - Modul Preluare si Mapare Statusuri Livrare Sameday cu Comenzile

netSEO: Sameday Status pentru CS-Cart

netSEO: Sameday Status este un addon profesional pentru CS-Cart care preia statusurile de livrare de la Sameday și le mapează la statusurile de comandă din platformă. Modulul folosește API-ul Sameday (cod-ledger-download și status-sync), salvează istoricul statusurilor per AWB și permite configurarea flexibilă a fiecărui status Sameday către un status de comandă CS-Cart. Este complementar modulului netSEO: AWB Sameday, folosind aceleași credențiale API.

Preluare statusuri Sameday

Modulul oferă două surse principale de date de status:

• Cod-ledger-download – descărcare CSV desfășurător rambursuri (AWB-uri) pentru un interval de date (max. 31 zile), cu statusuri și informații per expediție
• Status-sync – sincronizare statusuri pentru un interval de timp, pentru actualizări în timp real ale comenzilor
• Istoric AWB – obținere istoric complet de statusuri pentru un număr AWB dat, util pentru urmărire livrare și raportare

Toate apelurile folosesc API-ul oficial Sameday și credențialele (user, parolă) configurate în addon-ul netSEO: AWB Sameday.

Mapare statusuri Sameday → CS-Cart

Fiecare status returnat de Sameday poate fi mapat la un status de comandă din platformă:

• AWB generat – status când AWB-ul a fost generat
• Colet ridicat de curier – ridicat de la expeditor
• Colet în depozit livrare – în depozitul de livrare (zona curier)
• Colet la curier în curs de livrare – în livrare
• Colet livrat la destinatar – livrat
• Colet refuzat la primire – refuzat
• Colet ne livrat – reîncercare livrare – reîncercare livrare
• Colet plătit/încasat către expeditor – încasat (ramburs)
• Colet returnat la expeditor – returnat
• Întrand în curierie (legacy) – cod INTRAND_IN_CURIERIE, pentru compatibilitate cu variante vechi API
• Anulat – expediție anulată la Sameday (AWB șters, livrare anulată)

Maparea se configurează din setările addon-ului; fiecare câmp oferă un dropdown cu toate statusurile de comandă CS-Cart. Alias-urile codurilor Sameday (ex: RETURNAT → RESTITUIT, COLECTAT → RIDICAT) sunt recunoscute automat.

Salvare istoric statusuri și AWB

Modulul păstrează istoricul statusurilor pentru raportare și urmărire:

• Tabel dedicat pentru istoricul per AWB (order_id, awb_number, status, date)
• Funcții helper pentru obținerea istoricului unei comenzi sau al unui AWB
• Log pentru operațiuni de sincronizare și erori (debugging și audit)

Datele rămân în baza de date și după dezinstalare (fără ștergere automată a tabelelor), pentru a nu pierde istoricul.

Integrare cu netSEO: AWB Sameday

Modulul depinde de netSEO: AWB Sameday și folosește:

• Credențialele API (user, parolă) și modul test din setările AWB Sameday
• SDK-ul Sameday (vendor) din addon-ul AWB pentru apeluri API
• Nicio configurare suplimentară de conectare – odată ce AWB Sameday este configurat, Sameday Status poate prelua statusurile

Licență și dependențe

Addon-ul depinde de netSEO Addons Manager:

• Cod licență configurat în setările modulului (secțiunea General)
• Verificare la activare și la salvare; modulul rămâne activ dacă licența este validă sau deja salvată în baza de date
• Compatibil cu actualizări prin Upgrade Center (connector dedicat)

Setări și acces

Configurarea se face din Add-on-uri → Suplimente descărcate → netSEO: Sameday Status → Setări:

• Secțiunea General: cod licență
• Secțiunea Mapare statusuri Sameday → CS-Cart: dropdown pentru fiecare status Sameday (AWB generat, ridicat, în depozit, în livrare, livrat, refuzat, reîncercare, încasat, returnat, întrand în curierie legacy, anulat)

Tooltip-uri explicative pentru fiecare câmp și pentru diferența între statusuri (ex: „Ridicat de la expeditor” față de „Întrand în curierie” legacy).

Compatibilitate

Modulul este construit pentru stabilitate și conformitate:

• Compatibil CS-Cart 4.10.1+, ediții ULTIMATE și MULTIVENDOR
• Necesită netSEO Addons Manager și netSEO: AWB Sameday instalate și active
• Fără meniu dedicat în sidebar – acces doar din lista de addon-uri, pentru interfață minimală

Integrare nativă în CS-Cart

netSEO: Sameday Status se integrează în fluxul de administrare CS-Cart prin setări dedicate (Add-on-uri → addon → Setări). Preluarea statusurilor de la Sameday și maparea lor la statusurile de comandă permit actualizarea automată sau semi-automată a comenzilor în funcție de stadiul livrării, fără introducere manuală. Împreună cu netSEO: AWB Sameday, oferă un flux complet: generare AWB și urmărire statusuri până la livrare, return sau anulare.

Fără un modul dedicat de mapare statusuri Sameday, actualizarea comenzilor în funcție de starea reală a livrării rămâne manuală și predispusă la erori. Acest addon oferă mapare clară, istoric salvat și integrare cu API-ul Sameday, potrivit pentru magazine care folosesc Sameday pentru livrări și doresc sincronizarea statusurilor comenzilor cu cele de la curier.