Integrarea poate fi activată pentru fiecare client în parte, prin urmare vor fi transmise doar datele privind livrările aferente clienților Deliveo desemnați.
Condiții preliminare
- abonament la conexiunea API Deliveo;
- abonament la serviciul de webhook Deliveo;
- un cont Project44 activ;
- drepturi de instalare a extensiei;
- drepturi de configurare și utilizare a extensiei.
Instalare și acces
Extensia poate fi instalată pe Portalul dispeceratului, din meniul Extensii.
După instalare, acesta este accesibil din meniul „Extensii / Project44 Connect”. Instalarea și utilizarea pot fi efectuate numai de către utilizatorii care dețin drepturile corespunzătoare.
Opțiunile proprii ale extensiei:
- Panou de control
- Clienți
- Setări
Conectarea contului Project44
La conectarea extensiei, sistemul creează un utilizator tehnic în contul Project44.
Pentru a finaliza conectarea:
- Deschideți secțiunea de gestionare a utilizatorilor din Project44.
- Căutați utilizatorul cu numele afișat pe pagina Setări Project44 Connect.
- Deschideți rolurile utilizatorului.
- În secțiunea „Roles”, faceți clic pe butonul „Manage Roles”.
- Adăugați permisiunea „Shipment management”.
- Salvați modificarea.
Pe pagina Setări din Project44 Connect, o indicație de stare verde arată dacă conexiunea a fost stabilită cu succes.
Configurarea identificatorului de expediere transmis
Pe pagina „Setări” puteți selecta ce identificator de expediere va transmite Deliveo către Project44. Identificatorii disponibili sunt:
- DeliveoID
- Număr de referință
- Cod de urmărire
Pentru a salva valoarea selectată, faceți clic pe butonul „Salvare setare identificator”. Setarea modifică doar identificatorul transmis către Project44. Corelarea internă a evenimentelor din Deliveo și Project44 se realizează în continuare pe baza DeliveoID.
Configurarea webhook-urilor
Project44 Connect primește notificări despre evenimentele legate de expedieri prin intermediul funcției webhook a Deliveo. Pentru configurare:
- Deschideți meniul Setări / Webhook-uri din Portalul dispeceratului.
- Selectați evenimentul respectiv.
- Deschideți setările avansate ale evenimentului.
- Copiați adresa URL a webhook-ului afișată pentru evenimentul respectiv pe pagina Setări din Project44 Connect.
- Salvați setarea webhook-ului.
- Repetați operațiunea pentru fiecare eveniment necesar.
Există o adresă URL de webhook separată pentru următoarele evenimente:
- Crearea unei expedieri
- Preluarea expedierii
- Transfer
- Livrare reușită
- Livrare eșuată
URL-urile webhook sunt unice, de aceea trebuie să utilizați întotdeauna adresele afișate pe pagina Setări a instalării respective a Project44 Connect.
Selectarea clienților
Pe pagina Clienți puteți configura ce date ale clienților Deliveo vor fi transmise către Project44.
Pentru a activa un client:
- Deschideți meniul „Clienți”.
- Căutați clientul în listă.
- Activați comutatorul „Activ” din rândul clientului.
Când butonul este activat, evenimentele de expediere asociate clientului respectiv vor fi transmise. Când butonul este dezactivat, datele clientului nu vor fi transmise către Project44.
Lista clienților:
- poate fi filtrată după nume;
- filtrarea poate fi anulată;
- în cazul în care există mai multe pagini, se poate naviga între pagini.
Înainte de a activa integrarea, verifică dacă sunt activi doar clienții ale căror date dorești să le transmiți.
Evenimente transmise
Project44 Connect transformă evenimentele Deliveo în evenimente Project44.
Exemple de corelare a evenimentelor:
- Crearea unei expedieri →
SHIPMENT_CREATED - Preluarea expedierii →
PICKED_UP - Transferul expedierii →
ARRIVED_AT_STOP - Livrare reușită →
DELIVERED - Livrare nereușită → de exemplu
DELIVERY_MISSEDsauRETURN_TO_SENDER
Evenimentul Project44 asociat livrării eșuate poate depinde de evenimentul de livrare eșuată înregistrat în Deliveo.
Panoul de control
Panoul de control afișează solicitările webhook din ultimele 30 de zile.
Pagina prezintă, pe tipuri de evenimente:
- crearea expedierilor;
- preluările de colete;
- transferurile de colete;
- livrările reușite;
- încercările de livrare;
- livrările nereușite.
Lista detaliată a evenimentelor conține următoarele date:
- ID Deliveo
- Eveniment Deliveo
- Eveniment P44
- Acceptat
- Data
Coloana „Acceptat” indică dacă Project44 a acceptat evenimentul trimis.
Lista:
- poate fi filtrată în funcție de ID-ul Deliveo;
- poate fi parcursă pagină cu pagină;
- poate fi utilizată pentru verificarea cronologică și depistarea erorilor.
Verificarea conexiunii de date
După configurare, este recomandat să verificați funcționarea cu o livrare de test.
- Asigură-te că clientul asociat comenzii este activ pe pagina Clienți.
- Creați sau modificați o expediere astfel încât să se producă unul dintre evenimentele webhook configurate.
- Deschideți panoul de control Project44 Connect.
- Căutați expedierea pe baza ID-ului Deliveo.
- Verificați evenimentul Deliveo și evenimentul P44 asociat.
- Verificați dacă coloana „Acceptat” indică o primire cu succes.
Întreruperea conexiunii
Conexiunea activă cu Project44 poate fi întreruptă folosind butonul „Ștergere conexiune” din pagina „Setări”.
Înainte de a șterge conexiunea, verifică dacă nu mai este necesară transmiterea evenimentelor către Project44.
După întreruperea conexiunii, este recomandat să verificați și setările webhook-urilor asociate cu Project44 Connect în meniul Deliveo Setări → Webhooks și, dacă este necesar, să le eliminați.
Erori frecvente
Nu apar evenimente pe panoul de control
Verificați:
- dacă conexiunea este activă;
- dacă clientul în cauză este activ în pagina Clienți;
- dacă webhook-urile necesare sunt configurate;
- dacă pentru evenimentul corespunzător a fost introdusă adresa URL corespunzătoare a webhook-ului;
- dacă evenimentul a avut loc în ultimele 30 de zile.
Project44 nu acceptă evenimentul
Verificați:
- dacă utilizatorul tehnic Project44 are drepturi de gestionare a expedierilor;
- dacă conexiunea contului Project44 este activă;
- dacă identificatorul expedierii transmise este disponibil în expediere;
- ce evenimente Deliveo și P44 sunt vizibile în panoul de control.
Expedițiile unui client nu sunt transmise
Deschideți pagina Clienți și verificați dacă comutatorul Activ al clientului respectiv este activat.
În Project44 apare un identificator de expediere eronat
Verificați codul de expediere selectat pe pagina „Setări”.
Valorile disponibile sunt:
- DeliveoID
- Număr de referință
- Cod de urmărire
După modificare, fă clic pe butonul Salvare setări identificator.
Transmiterea unui anumit tip de eveniment nu funcționează
Verificați dacă webhook-ul corespunzător evenimentului respectiv este configurat separat. Pentru fiecare tip de eveniment trebuie utilizată adresa URL specifică afișată pe pagina Project44 Connect.