Curierat
Secțiune: Operațiuni
URL:/admin/couriers
Titlul paginii: Setări Curierat
Prezentare generală
Modulul Curierat integrează CRMConnect cu doi furnizori de curierat din România — Cargus și FanCourier — permițând personalului să genereze AWB-uri (documente de transport) direct din comenzi sau livrări, să urmărească statusurile expedierii și să păstreze un jurnal complet de audit al fiecărui apel API efectuat către serviciile de curierat.
Modulul este opțional și trebuie activat în panoul Module înainte de a deveni accesibil. Odată activat, încarcă două biblioteci API (Cargus_api și Fancourier_api) și un logger dedicat (Couriers_logger), astfel încât toată activitatea de curierat este înregistrată independent față de jurnalul principal al aplicației.
Valoare pentru business
Generarea manuală a AWB-urilor într-un portal de curierat și copierea ulterioară a numerelor de urmărire în CRM este predispusă la erori și consumatoare de timp. Acest modul automatizează întregul proces: un AWB este creat în aplicație, răspunsul curierului (inclusiv numărul de urmărire) este stocat față de expediere, iar etichetele pot fi tipărite fără a părăsi CRMConnect.
- Cine îl folosește: Personal de depozit și coordonatori logistici care pregătesc expedierile; administratori back-office care configurează credențialele API.
- Beneficiul principal: Crearea AWB-ului, tipărirea etichetei și urmărirea — pe un singur ecran, fără copiere manuală între sisteme.
Cazuri de utilizare tipice:
- Generați un AWB pentru o comandă confirmată și tipăriți eticheta de expediere într-un singur pas.
- Verificați statusul de livrare în timp real al unui colet folosind API-ul de urmărire al curierului.
- Schimbați furnizorul de curierat implicit (Cargus vs FanCourier) per depozit sau global.
- Consultați jurnalul de apeluri API pentru a diagnostica o generare eșuată de AWB.
- Configurați sau rotiți credențialele API pentru oricare curier fără a modifica fișierele aplicației.
Accesarea modulului
/admin/couriers — redirecționează automat la /admin/couriers/settings.
Modulul trebuie să fie activ în Setări → Module. Accesul la pagina de setări necesită drepturi de administrator sau permisiunea de vizualizare couriers_settings.
Concepte cheie
| Concept | Descriere |
|---|---|
| AWB (Air Waybill) | Documentul de transport și numărul de urmărire emis de curier pentru un colet. |
| Punct de ridicare | O locație fizică înregistrată la curier de unde sunt colectate coletele. Configurat per furnizor. |
| Workpoint (FanCourier) | Termenul FanCourier pentru o locație de expeditor înregistrată, preluată în timp real din API. |
| Cheie de abonament (Cargus) | Credențial de autentificare API necesar alături de utilizator/parolă pentru apelurile Cargus. |
| ID client (FanCourier) | Identificator API suplimentar FanCourier utilizat împreună cu utilizatorul și parola. |
| Furnizor preferat | Curierul preferat la nivel global, utilizat implicit la crearea unui nou AWB. |
| Depozit preferat | Locația implicită de depozit/ridicare preselectată la crearea AWB-urilor. |
| Logger curierat | Jurnal intern de audit care înregistrează fiecare cerere și răspuns API pentru ambii furnizori. |
| Sincronizare | Procesul care actualizează punctele de ridicare și workpointurile din API-ul curierului în baza de date locală. |
Acțiuni frecvente
- Configurați credențialele Cargus — Accesați
/admin/couriers/settings?tab=cargus, introduceți URL-ul de bază, cheia de abonament, utilizatorul și parola, apoi salvați. Modulul validează și stochează aceste valori. - Configurați credențialele FanCourier — Accesați
/admin/couriers/settings?tab=fancourier, introduceți URL-ul de bază, URL-ul de rapoarte, utilizatorul, parola și ID-ul de client. La salvare, modulul încearcă imediat să preia workpointurile dvs. înregistrate pentru a confirma conectivitatea. - Setați furnizorul și depozitul implicit (preferat) — Pe tab-ul General din Setări, alegeți curierul preferat și depozitul al cărui punct de ridicare va fi preselectat la crearea AWB-ului.
- Generați un AWB — Deschideți o livrare sau comandă, faceți clic pe acțiunea de curierat, selectați furnizorul și punctul de ridicare, confirmați detaliile coletului și trimiteți. Numărul AWB este stocat și o etichetă gata de tipărit este disponibilă imediat.
- Tipăriți o etichetă de expediere — Din lista AWB sau din vizualizarea detaliată a AWB-ului, folosiți acțiunea de etichetă pentru a deschide vizualizarea gata de tipărit.
- Urmăriți o expediere — Deschideți un AWB existent; modulul apelează API-ul curierului în timp real pentru a returna statusul curent de livrare.
- Sincronizați punctele de ridicare — Declanșați o sincronizare din pagina Setări pentru a prelua cea mai recentă listă de puncte de ridicare din API-ul curierului în baza de date locală.
- Consultați jurnalele API — Navigați la vizualizarea Jurnale pentru a inspecta fiecare apel API: timestamp, endpoint, payload cerere, status HTTP și corpul răspunsului. Util pentru diagnosticarea generărilor eșuate de AWB sau erorilor de urmărire.
Setați un furnizor implicit (preferat) și depozit în Setări Generale — crearea AWB pre-selectează automat curierul și punctul de ridicare corect, eliminând selecția manuală repetitivă la fiecare expediere.
Credențialele AWB sunt specifice furnizorului: Cargus necesită cheie de abonament + utilizator/parolă; FanCourier necesită ID client + utilizator/parolă. Testați conectivitatea în Setări înainte de lansare — o credențială eșuată produce erori de generare AWB la momentul expedierii când personalul este sub presiune de timp.
Sursă: crm-connect-main/app/modules/couriers