P44 Connect

Az integráció ügyfelenként kapcsolható be, ezért csak a kijelölt Deliveo-ügyfelekhez tartozó küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.adatok kerülnek továbbításra.

Előfeltételek

• előfizetett Deliveo API-kapcsolat;
• előfizetett Deliveo webhookhasználat;
• aktív Project44-fiók;
• jogosultság a kiegészítő telepítéséhez;
• jogosultság a kiegészítő beállításához és használatához.

Telepítés és elérés

A kiegészítő a Diszpécserportálon, a Kiegészítők menüpont alatt telepíthető.

A telepítés után a Kiegészítők / Project44 Connect menüpontban érhető el. A telepítést és a használatot csak megfelelő jogosultsággal rendelkező felhasználó végezheti.

A kiegészítő saját menüpontjai:

• Vezérlőpult
• Ügyfelek
• Beállítások

A Project44-fiók összekapcsolása

A kiegészítő csatlakoztatásakor a rendszer létrehoz egy technikai felhasználót a Project44-fiókban.

Az összekapcsolás befejezéséhez:

1. Nyisd meg a Project44 felhasználókezelését.
2. Keresd meg a Project44 Connect Beállítások oldalán megjelenő nevű felhasználót.
3. Nyisd meg a felhasználó szerepköreit.
4. A Roles szakaszban kattints a Manage Roles gombra.
5. Add hozzá a Shipment management jogosultságot.
6. Mentsd el a módosítást.

A Project44 Connect Beállítások oldalán zöld állapotjelzés mutatja, ha az összeköttetés sikeresen létrejött.

A továbbított küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.azonosító beállítása

A Beállítások oldalon kiválasztható, hogy a Deliveo melyik küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.azonosítót továbbítsa a Project44 felé. A választható azonosítók:

• DeliveoIDA küldemények egyedi elsődleges azonosítója a Deliveo rendszerében.
• Hivatkozási szám
• Követőkód

A kiválasztott érték mentéséhez kattints az Azonosító-beállítás mentése gombra. A beállítás csak a Project44 felé továbbított azonosítót módosítja. A Deliveo és a Project44 eseményeinek belső párosítása továbbra is a DeliveoIDA küldemények egyedi elsődleges azonosítója a Deliveo rendszerében. alapján történik.

Webhookok beállítása

A Project44 Connect a Deliveo webhook funkcióján keresztül kap értesítést a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.eseményekről. A beállításhoz:

1. Nyisd meg a Diszpécserportál Beállítások / Webhookok menüpontját.
2. Válaszd ki az adott eseményt.
3. Nyisd meg az esemény bővített beállításait.
4. Másold be a Project44 Connect Beállítások oldalán az adott eseményhez megjelenő webhook URL-t.
5. Mentsd el a webhook beállítását.
6. Ismételd meg a műveletet minden szükséges eseménynél.

Külön webhook URL tartozik az alábbi eseményekhez:

• KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozás
• KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. felvétel
• Transzfer
• Sikeres kézbesítés
• Sikertelen kézbesítés

A webhook URL-ek egyediek, ezért mindig az adott Project44 Connect telepítés Beállítások oldalán megjelenő címeket használd.

Ügyfelek kiválasztása

Az Ügyfelek oldalon szabályozható, hogy mely Deliveo-ügyfelek adatai kerüljenek továbbításra a Project44 felé.

Az ügyfél aktiválásához:

1. Nyisd meg az Ügyfelek menüpontot.
2. Keresd meg az ügyfelet a listában.
3. Kapcsold be az ügyfél sorában található Aktív kapcsolót.

Bekapcsolt állapotban az adott ügyfélhez tartozó küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.események továbbításra kerülnek. Kikapcsolt állapotban az ügyfél adatai nem kerülnek továbbításra a Project44 felé.

Az ügyféllista:

• név alapján szűrhető;
• a szűrés törölhető;
• több oldal esetén lapozható.

Az integráció bekapcsolása előtt ellenőrizd, hogy valóban csak azok az ügyfelek legyenek aktívak, amelyek adatait továbbítani szeretnéd.

Továbbított események

A Project44 Connect a Deliveo eseményeit Project44-eseményekké alakítja.

Példák az események megfeleltetésére:

• KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. létrehozás → SHIPMENT_CREATED
• KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. felvétel → PICKED_UP
• KüldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll. transzferálás → ARRIVED_AT_STOP
• Sikeres kézbesítés → DELIVERED
• Sikertelen kézbesítés → például DELIVERY_MISSED vagy RETURN_TO_SENDER

A sikertelen kézbesítéshez tartozó Project44-esemény a Deliveo-ban rögzített sikertelen kézbesítési eseménytől függhet.

Vezérlőpult

A Vezérlőpult az elmúlt 30 nap webhook-kéréseit jeleníti meg.

Az oldal eseménytípusonként összesíti:

• a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.-létrehozásokat;
• a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.felvételeket;
• a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.transzfereket;
• a sikeres kézbesítéseket;
• a kézbesítési kísérleteket;
• a sikertelen kézbesítéseket.

A részletes eseménylista az alábbi adatokat tartalmazza:

• Deliveo ID
• Deliveo esemény
• P44 esemény
• Elfogadva
• Időpont

Az Elfogadva oszlop jelzi, hogy a Project44 fogadta-e az elküldött eseményt.

A lista:

• Deliveo ID alapján szűrhető;
• lapozható;
• időrendi ellenőrzésre és hibakeresésre használható.

Az adatkapcsolat ellenőrzése

A beállítás után érdemes egy tesztküldeménnyel ellenőrizni a működést.

1. Győződj meg róla, hogy a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.hez tartozó ügyfél aktív az Ügyfelek oldalon.
2. Hozz létre vagy módosíts egy küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.t úgy, hogy a beállított webhookesemények egyike bekövetkezzen.
3. Nyisd meg a Project44 Connect Vezérlőpultját.
4. Keresd meg a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.t a Deliveo ID alapján.
5. Ellenőrizd a Deliveo-eseményt és a hozzá tartozó P44-eseményt.
6. Ellenőrizd, hogy az Elfogadva oszlop sikeres fogadást jelez-e.

Az összeköttetés megszüntetése

Az aktív Project44-kapcsolat a Beállítások oldalon található Összeköttetés törlése gombbal szüntethető meg.

Az összeköttetés törlése előtt ellenőrizd, hogy a Project44 felé történő eseménytovábbításra már nincs szükség.

Az összeköttetés megszüntetése után célszerű a Deliveo Beállítások → Webhookok menüpontjában a Project44 Connecthez tartozó webhookbeállításokat is ellenőrizni, és szükség esetén eltávolítani.

Gyakori hibák

Nem jelennek meg események a vezérlőpulton

Ellenőrizd:

• hogy az összeköttetés aktív-e;
• hogy az érintett ügyfél aktív-e az Ügyfelek oldalon;
• hogy a szükséges webhookok be vannak-e állítva;
• hogy a megfelelő eseményhez a megfelelő webhook URL került-e;
• hogy az esemény az elmúlt 30 napban történt-e.

A Project44 nem fogadja el az eseményt

Ellenőrizd:

• hogy a Project44 technikai felhasználó rendelkezik-e Shipment management jogosultsággal;
• hogy a Project44-fiók kapcsolata aktív-e;
• hogy a továbbított küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.azonosító rendelkezésre áll-e a küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.ben;
• hogy a vezérlőpulton milyen Deliveo- és P44-esemény látható.

Egy ügyfél küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.ei nem kerülnek továbbításra

Nyisd meg az Ügyfelek oldalt, és ellenőrizd, hogy az adott ügyfél Aktív kapcsolója be van-e kapcsolva.

Hibás küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.azonosító jelenik meg a Project44-ben

Ellenőrizd a Beállítások oldalon kiválasztott küldeményA Feladótól a Címzetthez egy Ügyfél által egy időben feladott csomagokat összefogó azonosító. Gyakorlatilag a teljes szállítmányt értjük alatta, akkor is ha az több Colliból áll.azonosítót.

A választható értékek:

• DeliveoIDA küldemények egyedi elsődleges azonosítója a Deliveo rendszerében.
• Hivatkozási szám
• Követőkód

A módosítás után kattints az Azonosító-beállítás mentése gombra.

Nem működik valamelyik eseménytípus továbbítása

Ellenőrizd, hogy az adott eseményhez tartozó webhook külön be van-e állítva. Minden eseménytípushoz a Project44 Connect oldalán megjelenő saját URL-t kell használni.