netSEO AWB Dragon Star pentru CS-Cart - Modul Integrare Generare Etichete Expediere Curier Dragon Star

netSEO: AWB Dragon Star pentru CS-Cart

netSEO: AWB Dragon Star este un addon profesional pentru CS-Cart care automatizează generarea etichetelor AWB prin integrarea cu API-ul Curier Dragon Star (CurierDragonStar). Modulul elimină introducerea manuală a datelor în platforma Dragon Star, preia automat datele comenzii și integrează expedierile direct în comenzi.

Generare automată a etichetelor AWB

Modulul permite generarea etichetelor AWB direct din pagina comenzii, cu formular precompletat:

• Date destinatar și adresă (județ, localitate, adresă, contact, telefon, email)
• Tip expediție: plic sau colet
• Nr. trimiteri (colete) și greutate totală cu repartizare la colete
• Dimensiuni per colet (lățime, lungime, înălțime)
• Plată transport (expeditor sau destinatar), ramburs, valoare asigurată
• Observații, conținut colet, referință unică (order_id|company_id|domeniu)
• Opțiune SMS livrare

Procesul de expediere devine rapid, fără a introduce manual datele în aplicația Dragon Star.

Expediții multi-colet (1/2, 2/2, 1/3, 2/3, 3/3)

Modulul gestionează expedieri cu mai multe colete sub un singur AWB, similar Sameday și Fan Courier:

• Nr. trimiteri configurat în formular (1–20 colete)
• Un singur AWB cu etichete 1/2, 2/2 sau 1/3, 2/3, 3/3 etc.
• Un singur ramburs pentru întreaga expediție; clientul plătește o dată și ridică toate coletele
• Tabel dinamic: greutate și dimensiuni per colet; la schimbarea numărului de colete se generează automat rândurile
• Greutate totală: introduceți totalul și se împarte egal la numărul de colete, sau modificați greutățile individuale și se calculează automat totalul
• API Dragon Star primește nrColete și greutatea totală (suma greutăților colete)

Referință unică

Modulul include câmpul Referință unică, precompletat cu formatul order_id|company_id|domeniu (ex: 1025|1|cs-cart.ro), pentru identificarea expedierii pe AWB. Referința este trimisă la API (câmp referinta) și inclusă în observații (Ref: …) pentru vizibilitate pe etichetă.

Integrare completă cu comenzile CS-Cart

Datele comenzii sunt preluate automat:

• Informații client și adresă livrare
• Metodă plată (ramburs sau nu)
• Valoare totală pentru ramburs (sau 0 pentru metode de plată fără ramburs)
• Persoană fizică/juridică: denumire firmă și CUI din câmpurile de profil configurate
• Județe și localități din API Dragon Star (dropdown-uri)

Setările permit excluderea anumitor metode de plată de la ramburs.

Vizualizare și printare etichete AWB

După generare, în pagina comenzii sunt afișate:

• Număr AWB generat
• Link vizualizare PDF (etichetă AWB)
• Buton ștergere AWB

PDF-ul se descarcă din API Dragon Star (format A4 sau A6 conform documentației).

Ștergere AWB

Modulul permite ștergerea unui AWB generat (în limita perioadei acceptate de API-ul Dragon Star):

• Ștergere pe platforma Dragon Star (API DELETE)
• Ștergere din baza de date addon
• Ștergere expedierea asociată din CS-Cart (shipments / shipment_items)

Gestionare expedieri în CS-Cart

După generarea AWB-ului:

• Se creează sau actualizează o expediere în CS-Cart (carrier Dragon Star, tracking number = număr AWB)
• Opțional: schimbare automată a statusului comenzii după generare AWB (configurabil în setări: Da/Nu și statusul dorit, ex. Procesată)

Configurare avansată

Setări disponibile în addon:

• Credențiale API Dragon Star (user, parolă) și mod test (mediu test: app.curierdragonstar.ro/test)
• Câmpuri profil: ID câmp Denumire firmă, ID câmp CUI firmă (persoane juridice)
• Nr. colete implicit, greutate implicită, dimensiuni pachet (lățime, lungime, înălțime)
• Mesaj conținut colet (șablon cu {order_id}, {domeniu})
• Metode de plată fără ramburs (excludere ramburs)
• Schimbă status comandă după generare AWB (Da/Nu)
• Status comandă după AWB (ex. Procesată)

Persoane fizice și juridice

Modulul preia automat datele din câmpurile de profil configurate:

• Denumire firmă și CUI pentru persoane juridice
• Contact și adresă pentru toate comenzile

Formularul AWB afișează județe și localități din API Dragon Star.

Istoric și costuri

AWB-urile generate sunt salvate în baza de date addon:

• order_id, nr_awb, info_trimise (date trimise), mesaj_in (răspuns API), cost (totalNet), created_at
• Datele permit urmărirea expedierilor și reconcilierea cu Dragon Star

Mod test

Modulul include mod test (API Dragon Star – mediul /test) pentru verificarea configurației și a fluxului fără generare de AWB-uri reale.

Licență și dependențe

Addon-ul depinde de netSEO Addons Manager pentru verificarea licenței. Codul de licență se configurează în setările modulului. Actualizările sunt gestionate prin Centrul de upgrade CS-Cart (connector netseo_awb_dragon_star).

Integrare nativă în CS-Cart

netSEO: AWB Dragon Star se integrează în interfața de administrare CS-Cart: buton „Generează AWB” în pagina comenzii (secțiune transport), formular dedicat cu două coloane (date expediere + destinatar), listă AWB-uri și acțiuni (PDF, ștergere) fără a părăsi ecranul comenzii.

Fără integrare Dragon Star directă în CS-Cart, generarea AWB-urilor devine manuală și predispusă la erori. Acest addon oferă generare etichete, suport multi-colet cu un singur ramburs și câmpuri utile (greutate totală, referință unică) într-un singur flux, optimizat pentru e-commerce cu Curier Dragon Star.