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

netSEO: Generare AWB GLS pentru CS-Cart

netSEO: Generare AWB GLS este un addon profesional pentru CS-Cart care automatizează generarea etichetelor AWB prin integrarea cu API-ul MyGLS Romania (api.mygls.ro). Modulul elimină introducerea manuală a datelor în platforma MyGLS, 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 (nume, contact, telefon, email, țară, județ, oraș, adresă, cod postal)
• Punct de ridicare (Adresa implicită din setări sau puncte preluate din contul MyGLS prin API GetAddresses)
• Tip serviciu GLS: NOS (fără SMS, email etc.), SM2 (Preadvice), SZL (Document Return)
• Data ridicare, număr colete (suport 1/N, 2/N etc. – un AWB cu mai multe părți)
• Tabel dimensiuni per colet (greutate, lățime, lungime, înălțime) și greutate totală
• Ramburs (RON), referință unică, observații, conținut colet
• Opțional: nume companie și CUI pentru persoane juridice

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

Puncte de ridicare din contul MyGLS

Modulul preia punctele de ridicare (adresele expeditorului) direct din contul GLS prin API-ul GetAddresses. În setări este suficient să configurezi User API GLS, Parolă și Client Number GLS (ID client); datele expeditorului (nume, adresă, oraș, contact, telefon, email) pot fi lăsate goale și se completează automat din cont. Câmpurile „Date expeditor” din setări sunt opționale și pot fi folosite ca override sau rezervă dacă API-ul nu returnează adrese.

Servicii GLS

Modulul oferă trei tipuri de serviciu (hardcodate, conform documentației GLS):

• NOS – Fără servicii suplimentare (fără SMS, email, notificări)
• SM2 – Preadvice (notificare înainte de livrare; se trimite telefonul destinatarului)
• SZL – Document Return (returnare documente; se completează numărul de document)

Serviciul implicit este configurat în setări addon (Opțiuni AWB).

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

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

• Număr colete configurat în formular (ex. 2 → etichete 1/2, 2/2)
• Un singur AWB cu mai multe părți
• Un singur ramburs pentru întreaga expediție
• Tabel dinamic: greutate și dimensiuni per colet; greutate totală calculată automat
• Parametrul Count este trimis corect către API MyGLS PrintLabels

Referință unică și conținut

Referința unică este generată automat în format CMD-{order_id}-{YmdHis} (ex. CMD-96-20260225045246) pentru identificarea expedierii; poate fi modificată în formular. Conținutul coletului este precompletat cu „Comanda #ID, domeniu” și poate fi editat. Observațiile pot avea text implicit configurat în setări addon (ex. „A se contacta telefonic înainte de livrare”).

Integrare completă cu comenzile CS-Cart

Datele comenzii sunt preluate automat:

• Informații client și adresă livrare
• Metodă plată (ramburs sau nu; metode fără ramburs configurabile în setări)
• Valoare totală pentru ramburs (când este cazul)
• Persoană fizică/juridică: denumire firmă și CUI din câmpurile de profil configurate (ID câmp companie, ID câmp CUI)

Vizualizare și printare etichete AWB

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

• Număr(e) AWB generat(e)
• Link vizualizare PDF (etichetă AWB)
• Buton „Generează AWB” (stilizat albastru GLS cu dungă galbenă)

Etichetele sunt salvate în directorul var și pot fi deschise în browser sau printate.

Gestionare expedieri în CS-Cart

După generarea AWB-ului:

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

Configurare addon

Setări disponibile:

• Licență și acces API: Cod licență, User API GLS, Parolă API GLS, Client Number GLS (ID client), ID câmp Nume Companie, ID câmp CUI
• Date expeditor (opțional): Nume, țară, oraș, adresă, cod postal, contact, telefon, email – se completează din contul MyGLS dacă sunt goale
• Opțiuni AWB: Serviciu default (NOS/SM2/SZL), format print etichete (A4 2x2 etc.), metode de plată fără ramburs, email client default, observații default, conținut colet default, schimbare status comandă după AWB, status comandă după AWB

Integrare cu netSEO Addons Manager

Modulul respectă ecosistemul netSEO:

• Dependență de netSEO Addons Manager pentru licențe și actualizări
• Cod licență în setări addon; verificare la activare și la salvare
• Upgrade Center Connector pentru actualizări prin Centrul de upgrade CS-Cart; la upgrade setările sunt păstrate (fn_update_addon_settings cu valorile existente)
• Traduceri complete (RO/EN) pentru setări, tooltip-uri (SettingsTooltips) și variante dropdown (SettingsVariants)

Compatibilitate și cerințe

Modulul este compatibil cu CS-Cart 4.10.1+, ediții Ultimate și Multivendor. Fără acest addon, generarea AWB GLS implică introducerea manuală a datelor în MyGLS. netSEO: Generare AWB GLS oferă integrare directă cu API MyGLS (PrintLabels, GetAddresses), preluare automată a punctelor de ridicare din cont, formular precompletat din comandă și suport multi-colet, optimizat pentru e-commerce cu GLS Romania.