Databáze znalostí Deliveo

Integraci lze aktivovat pro jednotlivé zákazníky, proto se přenášejí pouze údaje o zásilkách patřící vybraným zákazníkům Deliveo.

Předpoklady

předplacené připojení k API Deliveo;
předplacené využití webhooků Deliveo;
aktivní účet Project44;
oprávnění k instalaci doplňku;
oprávnění k nastavení a používání doplňku.

Instalace a přístup

Doplněk lze nainstalovat na portálu Diszpécserportál v nabídce Doplňky.

Po instalaci je k dispozici v položce menu „Doplňky / Project44 Connect“. Instalaci a používání smí provádět pouze uživatel s příslušným oprávněním.

Vlastní položky nabídky doplňku:

Ovládací panel
Zákazníci
Nastavení

Propojení účtu Project44

Při připojení doplňku systém vytvoří technického uživatele v účtu Project44.

Chcete-li propojení dokončit:

Otevřete správu uživatelů Project44.
Vyhledejte uživatele, jehož jméno se zobrazuje na stránce Nastavení Project44 Connect.
Otevřete role uživatele.
V sekci Roles klikněte na tlačítko Manage Roles.
Přidejte oprávnění „Shipment management“.
Uložte změnu.

Na stránce Nastavení Project44 Connect se zelená ikona stavu zobrazí, pokud bylo připojení úspěšně navázáno.

Nastavení předávaného identifikačního čísla zásilky

Na stránce Nastavení můžete vybrat, který identifikátor zásilky má Deliveo předávat do Project44. K dispozici jsou následující identifikátory:

DeliveoID
Referenční číslo
Sledovací kód

Pro uložení vybrané hodnoty klikněte na tlačítko Uložit nastavení identifikátoru. Toto nastavení mění pouze identifikátor předávaný do Project44. Vnitřní přiřazování událostí Deliveo a Project44 se i nadále provádí na základě DeliveoID.

Nastavení webhooků

Project44 Connect dostává oznámení o událostech zásilek prostřednictvím funkce webhooků Deliveo. Postup nastavení:

Otevřete v dispečerském portálu položku menu Nastavení / Webhooky.
Vyberte příslušnou událost.
Otevřete rozšířená nastavení události.
Zkopírujte URL webhooku, která se zobrazuje u dané události na stránce Nastavení v Project44 Connect.
Uložte nastavení webhooku.
Tento postup opakujte u všech potřebných událostí.

K následujícím událostem patří samostatná adresa URL webhooku:

Vytvoření zásilky
Převzetí zásilky
Převoz
Úspěšné doručení
Neúspěšné doručení

URL adresy webhooků jsou jedinečné, proto vždy používejte adresy zobrazené na stránce Nastavení dané instalace Project44 Connect.

Výběr zákazníků

Na stránce „Zákazníci“ lze nastavit, které údaje o zákaznících Deliveo se mají předávat do Project44.

Aktivace zákazníka:

Otevřete položku menu „Zákazníci“.
Vyhledejte zákazníka v seznamu.
Zapněte přepínač „Aktivní“ v řádku daného zákazníka.

Je-li přepínač zapnutý, budou události zásilek patřící k danému zákazníkovi předávány. Je-li přepínač vypnutý, údaje o zákazníkovi nebudou předávány do Project44.

Seznam zákazníků:

lze filtrovat podle jména;
filtrování lze zrušit;
v případě více stránek lze listovat.

Před zapnutím integrace zkontrolujte, zda jsou skutečně aktivní pouze ti zákazníci, jejichž údaje chcete předávat.

Přenesené události

Project44 Connect převádí události Deliveo na události Project44.

Příklady přiřazení událostí:

Vytvoření zásilky → SHIPMENT_CREATED
Převzetí zásilky → PICKED_UP
Převoz zásilky → ARRIVED_AT_STOP
Úspěšné doručení → DELIVERED
Neúspěšné doručení → například DELIVERY_MISSED nebo RETURN_TO_SENDER

Událost Project44 související s neúspěšným doručením může záviset na události neúspěšného doručení zaznamenané v systému Deliveo.

Řídicí panel

Ovládací panel zobrazuje webhookové požadavky za posledních 30 dní.

Stránka agreguje podle typu události:

vytvoření zásilek;
převzetí zásilek;
přepravy zásilek;
úspěšná doručení;
pokusy o doručení;
neúspěšná doručení.

Podrobný seznam událostí obsahuje následující údaje:

ID Deliveo
Událost Deliveo
Událost P44
Přijato
Datum

Sloupec „Přijato“ označuje, zda společnost Project44 přijala odeslanou událost.

Seznam lze

lze filtrovat podle Deliveo ID;
lze v ní listovat;
lze použít k chronologické kontrole a vyhledávání chyb.

Kontrola datového připojení

Po nastavení je vhodné ověřit funkčnost pomocí testovací zásilky.

Ujistěte se, že zákazník, ke kterému zásilka patří, je aktivní na stránce Zákazníci.
Vytvořte nebo upravte zásilku tak, aby došlo k jedné z nastavených událostí webhooku.
Otevřete řídicí panel Project44 Connect.
Vyhledejte zásilku podle Deliveo ID.
Zkontrolujte událost Deliveo a související událost P44.
Zkontrolujte, zda sloupec „Přijato“ označuje úspěšné přijetí.

Ukončení propojení

Aktivní propojení s Project44 lze zrušit pomocí tlačítka „Zrušit propojení“ na stránce „Nastavení“.

Před zrušením propojení se ujistěte, že již není nutné předávat události do Project44.

Po zrušení připojení je vhodné v menu Deliveo Nastavení → Webhooky zkontrolovat také nastavení webhooků souvisejících s Project44 Connect a v případě potřeby je odstranit.

Časté chyby

Na ovládacím panelu se nezobrazují události

Zkontrolujte:

zda je připojení aktivní;
zda je daný zákazník aktivní na stránce Zákazníci;
zda jsou nastaveny potřebné webhooky;
zda je k příslušné události přiřazena správná URL adresa webhooku;
zda k události došlo v posledních 30 dnech.

Project44 událost nepřijme

Zkontrolujte:

zda má technický uživatel Project44 oprávnění pro správu zásilek;
zda je propojení s účtem Project44 aktivní;
zda je v zásilce k dispozici předané identifikační číslo zásilky;
jaké události Deliveo a P44 se zobrazují na ovládacím panelu.

Zásilky určitého zákazníka se nepřenášejí

Otevřete stránku „Zákazníci“ a zkontrolujte, zda je u daného zákazníka zapnutý přepínač „Aktivní“.

V Project44 se zobrazuje nesprávný identifikátor zásilky

Zkontrolujte identifikátor zásilky vybraný na stránce Nastavení.

Možné hodnoty:

DeliveoID
Referenční číslo
Sledovací kód

Po provedení změn klikněte na tlačítko Uložit nastavení identifikátoru.

Nepodaří se odeslat některý typ události

Zkontrolujte, zda je pro danou událost samostatně nastaven webhook. Pro každý typ události je třeba použít vlastní URL, která se zobrazuje na stránce Project44 Connect.

P44 Connect