netSEO AWB Cargus pentru CS-Cart - Modul Integrare Generare Etichete Expediere Urgent Cargus

netSEO: AWB Cargus pentru CS-Cart

netSEO: AWB Cargus este un addon profesional pentru CS-Cart care automatizează generarea etichetelor AWB prin integrarea cu API-ul Urgent Cargus (urgentcargus.azure-api.net). Modulul elimină introducerea manuală a datelor, preia automat datele comenzii și integrează expedierile direct în comenzi, conform documentației oficiale API Cargus (LoginUser, PickupLocations, Awbs, AwbDocuments, ștergere AWB).

Generare automată a etichetelor AWB

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

• Date expediere: Punct de ridicare (LocationId) preluat din API Cargus (PickupLocations), Serviciu (34 până la 31 kg, 35 pentru 31–50 kg, 50 peste 50 kg), Nr. trimiteri (colete), tabel Colete cu greutate și dimensiuni per parcel (lățime, lungime, înălțime), Greutatea totală (cu calcul automat din greutățile individuale sau împărțire egală la număr colete), Plicuri (max. 9), Platitor transport (Expeditor/Destinatar), Ramburs (RON) – CashRepayment sau BankRepayment conform setării addon, Referință unică (CustomString), Observații (text default configurabil din setări, ex. „A se contacta telefonic”), Conținut colet (PackageContent), opțiuni Deschidere colet (OpenPackage) și Livrare sâmbătă (SaturdayDelivery)
• Destinatar: Nume companie (cu CUI în paranteză, ex. „FIRMA SRL (CUI: RO12345678)”), CUI Companie, Nume Persoană, Județ și Localitate (dropdown-uri dinamice din API Cargus Counties/Localities sau câmpuri text când API nu returnează liste), Stradă, Nr. clădire, Adresă (AddressText), Cod poștal, Telefon, Email

Procesul de expediere devine rapid, fără a introduce manual datele în platforma Cargus.

Expediții multi-colet (1/2, 2/2) – conform API Cargus

Modulul gestionează corect expedieri cu mai multe colete sub un singur AWB, conform condițiilor serviciului multipiece Cargus:

• Număr de trimiteri (colete) configurat în formular; la 2+ colete: un singur AWB (1/2, 2/2), un singur ramburs; clientul plătește o dată și ridică toate coletele
• Limitări Cargus: max. 15 colete per expediție, max. 31 kg per colet, max. 465 kg greutate totală (validare în modul)
• Tabel dinamic: greutate și dimensiuni per colet; greutate totală calculată automat sau introdusă manual (repartizare egală la colete)
• ParcelCodes trimis către API cu câte un element per parcel (greutate și dimensiuni din formular)

Integrare completă cu comenzile CS-Cart

Datele comenzii sunt preluate automat:

• Informații client și adresă livrare (județ, localitate, adresă, cod poștal, telefon, email)
• Metodă plată (ramburs sau nu; metode fără ramburs configurabile în setări – Payment (NO Ramburs))
• Valoare totală pentru ramburs (când este cazul)
• Persoană fizică/juridică: denumire firmă și CUI din câmpurile de profil configurate (Camp ID Denumire Firmă, Camp ID CUI Firmă); în formular se afișează „Nume companie (CUI în paranteză)” precompletat
• Conținut colet: mesaj configurabil cu parametri {order_id}, {domeniu} sau listă produse (referință / nume produs)

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

Vizualizare și printare etichete AWB

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

• Numere AWB generate (link către vizualizare PDF)
• Buton „Generează AWB” (stilizat portocaliu, text alb) în secțiunea transport
• Buton „Istoric expediție” (urmarire colet) – deschide în popup istoricul de status de la Cargus pentru AWB-urile comenzii
• Buton ștergere AWB (cu confirmare)

Etichetele se descarcă conform API Cargus (AwbDocuments / PDF) și pot fi deschise sau printate.

Urmărire colet (Istoric expediție)

Modulul oferă urmărirea coletului direct din admin, similar cu modulul Sameday:

• Buton „Istoric expediție” în pagina comenzii (secțiunea transport), vizibil când comanda are deja AWB-uri Cargus generate
• La click se deschide un popup cu istoricul de expediție preluat de la API Cargus (AwbTrace/WithRedirect): data/oră, status, stare, locație, observații pentru fiecare eveniment
• Pentru comenzi cu mai multe AWB-uri se afișează câte un tabel pe AWB
• În ediția MultiVendor, vendorii au acces la istoricul expediției pentru comenzile lor

Ștergere AWB

Modulul permite ștergerea unui AWB generat:

• Ștergere pe platforma Cargus (API Awbs DELETE cu barCode)
• Ștergere din baza de date addon și din expedierile comenzii CS-Cart
• Confirmare înainte de ștergere

Gestionare expedieri în CS-Cart

După generarea AWB-ului:

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

MultiVendor – Mapare puncte ridicare per vendor

Pe ediția MULTIVENDOR, modulul oferă funcționalitate dedicată pentru mai mulți vânzători:

• Setare addon: „Mapare puncte ridicare per vendor (MultiVendor)” (Da/Nu). Când este activată, fiecare vendor vede doar punctele de ridicare Cargus mapate pentru el.
• Pagină dedicată: „Mapare puncte ridicare per vendor” (accesibilă din meniul Comenzi – „Cargus - Mapare puncte ridicare” și din setările addon-ului). Doar administratorul poate accesa pagina; pentru fiecare vendor (companie) se selectează punctele de ridicare la care poate expedia (multi-select; Ctrl/Cmd pentru mai multe).
• La generare AWB: Dacă maparea este activă, în formularul AWB dropdown-ul „Punct de ridicare” afișează doar punctele mapate pentru vendorul comenzii (sau pentru vendorul logat). Un vendor fără puncte mapate primește mesaj: „Nu aveți puncte de ridicare mapate. Contactați administratorul pentru configurare.”
• Câmpuri restricționate pentru vendor: Când utilizatorul este vendor (cont vânzător), anumite câmpuri sunt înghețate: Platitor transport (forțat „Expeditor (1)”), Referință (CustomString) – readonly cu valoarea precompletată. Rambursul rămâne editabil. Comportament aliniat cu modulul Sameday pentru consistență multi-curier.

Fără mapare activată, toți utilizatorii văd toate punctele de ridicare returnate de API.

Configurare addon

Setări disponibile:

• General: Cod licență, API Key (Subscription Key), User API (UserName), Parolă API, URL API Cargus (implicit https://urgentcargus.azure-api.net/api), Tip ramburs (Ramburs cash / Ramburs în cont), Camp ID Denumire Firmă, Camp ID CUI Firmă
• MultiVendor: Mapare puncte ridicare per vendor (Da/Nu)
• Opțiuni: Observații (default) – text precompletat în câmpul Observații (ex. „A se contacta telefonic”), Nr. colete (default), Greutate totală colet (kg), Mesaj Conținut colet (parametri {order_id}, {domeniu}), Conținut colet (Referință / Nume produs), Payment (NO Ramburs), Schimbă status comanda după generare AWB, Status comanda după AWB

Toate setările și tooltip-urile sunt traduse (RO/EN) în fișierele de limbă ale addon-ului (SettingsOptions, SettingsTooltips, SettingsVariants).

Persoane fizice și juridice

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

• Nume firmă și CUI pentru persoane juridice; în formular se afișează „Nume companie (CUI în paranteză)” și câmp separat CUI Companie
• Contact și adresă pentru toate comenzile

Județul și localitatea destinatarului se pot selecta din listele din API Cargus (Counties, Localities) sau se completează ca text când API nu oferă liste.

Istoric și costuri

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

• order_id, nr_awb, info_trimise, mesaj_in (răspuns API), cost, created_at
• Datele permit urmărirea expedierilor și reconcilierea cu Cargus.

Licență și dependențe

Addon-ul depinde de netSEO Addons Manager pentru verificarea licenței. Codul de licență se configurează în setările modulului. Este inclus Upgrade Center Connector pentru actualizări prin Centrul de upgrade CS-Cart.

Integrare nativă în CS-Cart

netSEO: AWB Cargus se integrează în interfața de administrare CS-Cart: buton „Generează AWB” în pagina comenzii (secțiune transport), formular dedicat cu toate câmpurile necesare conform API Cargus, listă AWB-uri și acțiuni (vizualizare PDF, ștergere) fără a părăsi ecranul comenzii.

Fără integrare Cargus directă în CS-Cart, generarea AWB-urilor devine manuală și predispusă la erori. Acest addon oferă generare etichete conform documentației API Urgent Cargus, suport multi-colet (1/2, 2/2) cu limitele de greutate și număr colete, ramburs cash sau în cont, urmarire colet (istoric expediție) în admin, mapare puncte ridicare per vendor în MultiVendor și câmpuri restricționate pentru vânzători, optimizat pentru e-commerce cu Cargus.