netSEO Generare AWB DPD pentru CS-Cart - Modul Integrare Generare Etichete Expediere DPD Romania

netSEO: Generare AWB DPD pentru CS-Cart

netSEO: Generare AWB DPD este un addon profesional pentru CS-Cart care automatizează generarea etichetelor AWB prin integrarea cu API-ul DPD Romania (api.dpd.ro). Modulul elimină introducerea manuală a datelor în platforma DPD, 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)
• Punct de ridicare (doar punctele din contractul DPD al clientului; „Adresa implicita” = sediul principal)
• Serviciu DPD (ex. DPD STANDARD)
• 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ă
• Referință unică (order_id|domeniu), observații, conținut colet

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

Puncte de ridicare și expeditor

Modulul folosește doar punctele de ridicare ale clientului (din contractul DPD), nu toate oficii DPD. La selectarea „Adresa implicita” se trimite sediul principal (primul client din contract). La generare AWB, expeditorul este identificat prin clientId și telefon (API DPD); numele companiei și contactul nu sunt trimise când se folosește clientId, conform cerințelor API.

Expediții multi-colet

Modulul gestionează expedieri cu mai multe colete sub un singur AWB:

• Nr. trimiteri configurat în formular
• Un singur AWB cu etichete 1/2, 2/2 sau 1/3, 2/3, 3/3 etc.
• Un singur ramburs pentru întreaga expediție
• Tabel dinamic: greutate și dimensiuni per colet; greutate totală calculată automat
• Secvențiere corectă a parcelelor (seqNo) către API DPD

Moneda AWB și conversie ramburs

Addon-ul permite setarea monedei în care se generează AWB-ul (ramburs, valoare asigurată) din monedele active ale platformei (ex. RON). La CS-Cart Ultimate, setarea este per storefront. Rambursul și valoarea asigurată sunt convertite automat din moneda comenzii în moneda AWB; în formular, valorile sunt afișate deja în moneda aleasă (inclusiv conversia corectă a totalului comenzii din moneda primară în moneda AWB).

Referință unică și observații

Modulul include câmpul Referință unică, precompletat cu formatul order_id|domeniu (ex. 1028|cs-cart.ro), pentru identificarea expedierii pe AWB. Conținutul coletului poate fi personalizat (ex. „Comanda {order_id} plasata pe {domeniu}.”).

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 (convertită în moneda AWB)
• Persoană fizică/juridică: denumire firmă și CUI din câmpurile de profil configurate
• Nume destinatar: dacă există nume companie și CUI, se trimite „NUME COMPANIE (CUI)”

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

La ștergerea AWB-ului, administratorul este redirecționat la detaliile comenzii (fără reload pe URL-ul de ștergere).

Ștergere AWB

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

• Ștergere pe platforma DPD (API)
• Ștergere din baza de date addon
• Ștergere expedierea asociată din CS-Cart (shipments / shipment_items)
• Redirect la pagina de detaliu comandă după ștergere

Gestionare expedieri în CS-Cart

După generarea AWB-ului:

• Se creează sau actualizează o expediere în CS-Cart (carrier DPD, 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. Completă)

Configurare avansată

Setări disponibile în addon:

• Credențiale API DPD Romania (Username, parolă) și mod test
• Câmpuri profil: ID câmp Denumire firmă, ID câmp CUI (persoane juridice)
• Moneda AWB (din monedele active; la Ultimate: per storefront)
• 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. Completă)

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

Pentru destinatar, dacă există nume companie și CUI, numele trimis la DPD este „NUME COMPANIE (CUI)”.

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, created_at
• Datele permit urmărirea expedierilor și reconcilierea cu DPD

Mod test

Modulul include mod test (API DPD) 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 la upgrade se păstrează setările existente.

Integrare nativă în CS-Cart

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

Fără integrare DPD directă în CS-Cart, generarea AWB-urilor devine manuală și predispusă la erori. Acest addon oferă generare etichete, puncte de ridicare din contract, monedă AWB configurabilă cu conversie corectă a rambursului și suport multi-colet într-un singur flux, optimizat pentru e-commerce cu DPD Romania.