netSEO Dragon Star Status Colet pentru CS-Cart - Modul Preluare si Mapare Statusuri Colete Dragon Star Curier cu Comenzile

netSEO: Dragon Star Status Colet pentru CS-Cart

netSEO: Dragon Star Status Colet este un addon profesional pentru CS-Cart care preia statusurile coletelor de la Dragon Star Curier (DSC) și le mapează la statusurile de comandă din platformă. Modulul folosește API-ul REST Dragon Star (https://app.curierdragonstar.ro) pentru tracking, salvează istoricul statusurilor per AWB și permite configurarea flexibilă a tuturor statusurilor Dragon Star către statusuri de comandă CS-Cart. Poate fi folosit independent sau alături de un modul de generare AWB Dragon Star; necesită doar credențialele API (user și parolă) pentru preluarea statusurilor.

Preluare statusuri Dragon Star

Modulul preia statusurile coletelor din API REST Dragon Star:

• GET /awb/status/:awb – ultimul status pentru un AWB (data, status, detalii: eveniment, centru)
• GET /awb/history/:awb – istoricul complet de statusuri pentru AWB-ul dat; fiecare intrare conține data, statusul (text) și detaliile (eveniment, centru)
• Autentificare Basic (user:parolă) conform documentației API Dragon Star
• Salvare în baza de date addon pentru raportare și actualizare status comenzi

Preluarea se face pe baza numărului AWB; modulul poate identifica AWB-urile din platformă (tabel netseo_awb_dragonstar dacă există, sau din transporturile CS-Cart – carrier DragonStar / Dragon Star / DSC) și permite maparea fiecărui status Dragon Star la un status de comandă CS-Cart.

Mapare statusuri Dragon Star → CS-Cart

Fiecare status returnat de API Dragon Star poate fi mapat la un status de comandă CS-Cart. Modulul include mapare dedicată pentru toate statusurile disponibile în Dragon Star:

• Abandonat – expediția abandonată
• Avariat – colet avariat
• Avizat – colet avizat
• Colectata – colet colectat
• Iesire Depozit – ieșire din depozit
• Intrare Depozit – intrare în depozit
• Livrare nereusita – livrare eșuată
• Livrat – livrat la destinatar
• Prealertat – expediție prealertată
• Preluata – colet preluat
• Reavizat – colet reavizat
• Receptie dep. local – recepție depozit local
• Receptie dep. central – recepție depozit central
• Redirectionat – expediție redirectionată
• Reexpediat – colet reexpediat
• Returnat – colet returnat
• Spre livrare – în drum spre livrare
• Expeditie inexistenta – expediție inexistentă / anulată
• Alte statusuri – orice alt status returnat de API fără mapare dedicată

Maparea se configurează din setările addon-ului; fiecare status Dragon Star are un dropdown cu toate statusurile de comandă CS-Cart. Tooltip-uri explicative pentru fiecare câmp. Statusurile din API sunt normalizate automat (fără diacritice, lowercase, spații înlocuite cu _) pentru potrivire cu maparea.

Conectare API Dragon Star

Modulul folosește credențialele introduse în setări:

• User API Dragon Star – utilizatorul pentru autentificarea Basic (obligatoriu)
• Parolă API Dragon Star – parola pentru autentificarea Basic (obligatorie)

Header-urile request-urilor către API includ Authorization: Basic <base64 user:password> și Content-Type: application/x-www-form-urlencoded, conform documentației API REST Dragon Star. Nu depinde de un addon de generare AWB – poți folosi Dragon Star Status și dacă generezi AWB-uri prin alt mod (addon netSEO AWB Dragon Star sau alt sistem), introducând doar user și parolă pentru acces la statusuri.

Setări addon

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

• Licență și acces API – cod licență netSEO; verificat automat la salvare
• Conectare API Dragon Star Curier – User API Dragon Star și Parolă API Dragon Star; folosite pentru GET /awb/status/:awb și GET /awb/history/:awb
• Mapare statusuri Dragon Star → CS-Cart – 19 câmpuri selectbox (Abandonat, Avariat, Avizat, Colectata, Iesire Depozit, Intrare Depozit, Livrare nereusita, Livrat, Prealertat, Preluata, Reavizat, Receptie dep. local, Receptie dep. central, Redirectionat, Reexpediat, Returnat, Spre livrare, Expeditie inexistenta, Alte statusuri), fiecare cu tooltip și dropdown cu statusurile de comandă din platformă

Toate secțiunile au nume și tooltip-uri; traduceri RO/EN pentru setări și opțiuni.

Salvare istoric și log

Modulul păstrează:

• Istoric statusuri – per AWB (awb_number, order_id, status_text, status_date, details), pentru raportare și afișare pe comandă
• Log – operațiuni de sincronizare, tip, mesaj, detalii (debugging și audit)

Tabelele sunt create la instalare și șterse la dezinstalare.

Integrare cu netSEO Addons Manager

Addon-ul depinde de netSEO Addons Manager pentru verificarea licenței:

• Cod licență în setări (tab Licență și acces API)
• Verificare la activare și la salvare; modulul poate fi dezactivat automat dacă licența este invalidă
• Upgrade Center Connector pentru actualizări prin Addon Manager / Centrul de upgrade CS-Cart

Dependențe și compatibilitate

Modulul depinde doar de:

• netSEO Addons Manager – obligatoriu

Nu necesită modulul netSEO AWB Dragon Star; poate fi folosit și cu alte surse de AWB (transporturi CS-Cart cu tracking number, alt addon AWB). Compatibil CS-Cart 4.10.1+, ediții ULTIMATE și MULTIVENDOR. Fără meniu dedicat în sidebar – acces din lista de addon-uri → Setări.

Integrare nativă în CS-Cart

netSEO: Dragon Star Status Colet se integrează prin setări dedicate (Add-on-uri → addon → Setări). Preluarea statusurilor de la Dragon Star Curier și maparea lor la statusurile de comandă permit actualizarea automată sau semi-automată a comenzilor în funcție de stadiul livrării (colectat, în depozit, spre livrare, livrat, returnat etc.), fără introducere manuală. Oferă mapare clară pentru toate statusurile Dragon Star disponibile (Abandonat, Avariat, Avizat, Colectata, Iesire/Intrare Depozit, Livrare nereusita, Livrat, Prealertat, Preluata, Reavizat, Receptie dep. local/central, Redirectionat, Reexpediat, Returnat, Spre livrare, Expeditie inexistenta, Alte statusuri), cu istoric salvat și integrare cu API-ul REST Dragon Star.

Fără un modul dedicat de mapare statusuri Dragon Star, actualizarea comenzilor în funcție de starea reală a livrării rămâne manuală. Acest addon oferă mapare completă pentru toate statusurile Dragon Star, credențiale API simple (user + parolă), istoric per AWB și potrivire flexibilă a textului de status din API (normalizare automată), potrivit pentru magazine care folosesc Curier Dragon Star și doresc sincronizarea statusurilor comenzilor cu cele de la curier.