Základňa znalostí Deliveo

Integráciu je možné aktivovať pre jednotlivých zákazníkov, preto sa prenášajú len údaje o zásielkach patriacich k vybraným zákazníkom Deliveo.

Predpoklady

predplatené pripojenie k Deliveo API;
predplatené používanie webhookov Deliveo;
aktívny účet Project44;
oprávnenie na inštaláciu doplnku;
oprávnenie na nastavenie a používanie doplnku.

Inštalácia a prístup

Doplnok je možné nainštalovať na dispečerskom portáli v ponuke Doplnky.

Po inštalácii je dostupný v ponuke „Doplnky / Project44 Connect“. Inštaláciu a používanie môže vykonávať iba používateľ s príslušným oprávnením.

Vlastné položky menu doplnku:

Ovládací panel
Zákazníci
Nastavenia

Prepojenie účtu Project44

Pri pripojení doplnku systém vytvorí technického používateľa v účte Project44.

Na dokončenie prepojenia:

Otvorte správu používateľov v Project44.
Vyhľadajte používateľa s názvom, ktorý sa zobrazuje na stránke nastavení Project44 Connect.
Otvorte roly používateľa.
V časti Roles kliknite na tlačidlo Manage Roles.
Pridajte oprávnenie „Shipment management“.
Uložte zmeny.

Na stránke Nastavenia v Project44 Connect sa zelená ikona zobrazí, ak bolo pripojenie úspešne vytvorené.

Nastavenie prenášaného identifikačného čísla zásielky

Na stránke Nastavenia môžete zvoliť, ktoré identifikačné číslo zásielky má Deliveo odoslať do Project44. Na výber sú nasledujúce identifikačné čísla:

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

Na uloženie zvolenej hodnoty kliknite na tlačidlo Uložiť nastavenie identifikátora. Toto nastavenie mení iba identifikátor odosielaný do Project44. Vnútorné spárovanie udalostí Deliveo a Project44 sa naďalej vykonáva na základe DeliveoID.

Nastavenie webhookov

Project44 Connect dostáva oznámenia o udalostiach zásielok prostredníctvom funkcie webhookov Deliveo. Postup nastavenia:

Otvorte v dispečerskom portáli položku menu Nastavenia / Webhooky.
Vyberte príslušnú udalosť.
Otvorte rozšírené nastavenia udalosti.
Skopírujte URL webhooku, ktorá sa zobrazuje na stránke Nastavenia v Project44 Connect pri danej udalosti.
Uložte nastavenie webhooku.
Tento postup zopakujte pre všetky potrebné udalosti.

K nasledujúcim udalostiam patrí samostatná URL adresa webhooku:

Vytvorenie zásielky
Prevzatie zásielky
Preprava
Úspešné doručenie
Neúspešné doručenie

URL adresy webhookov sú jedinečné, preto vždy používajte adresy uvedené na stránke Nastavenia danej inštalácie Project44 Connect.

Výber zákazníkov

Na stránke Zákazníci môžete nastaviť, ktoré údaje zákazníkov Deliveo sa majú odosielať do Project44.

Aktivácia zákazníka:

Otvorte položku menu „Zákazníci“.
Vyhľadajte zákazníka v zozname.
Zapnite prepínač „Aktívny“ v riadku daného zákazníka.

Ak je prepínač zapnutý, udalosti týkajúce sa zásielok daného zákazníka sa budú odosielať. Ak je prepínač vypnutý, údaje zákazníka sa do Project44 neodosielajú.

Zoznam zákazníkov:

možno filtrovať podľa mena;
filtrovanie je možné zrušiť;
v prípade viacerých stránok je možné listovať.

Pred zapnutím integrácie skontrolujte, či sú aktívni skutočne len tí zákazníci, ktorých údaje chcete odosielať.

Prenesené udalosti

Project44 Connect prevádza udalosti z Deliveo na udalosti Project44.

Príklady priradenia udalostí:

Vytvorenie zásielky → SHIPMENT_CREATED
Prevzatie zásielky → PICKED_UP
Prenos zásielky → ARRIVED_AT_STOP
Úspešné doručenie → DELIVERED
Neúspešné doručenie → napríklad DELIVERY_MISSED alebo RETURN_TO_SENDER

Udalosť Project44 súvisiaca s neúspešným doručením môže závisieť od udalosti neúspešného doručenia zaznamenanej v systéme Deliveo.

Riadiaci panel

Ovládací panel zobrazuje požiadavky webhookov za posledných 30 dní.

Stránka agreguje podľa typov udalostí:

vytvorenia zásielok;
prevzatia zásielok;
prevody zásielok;
úspešné doručenia;
pokusy o doručenie;
neúspešné doručenia.

Podrobný zoznam udalostí obsahuje nasledujúce údaje:

ID Deliveo
Udalosť Deliveo
Udalosť P44
Prijaté
Dátum

Stĺpec „Prijaté“ označuje, či spoločnosť Project44 prijala odoslanú udalosť.

Zoznam:

možno filtrovať podľa Deliveo ID;
možno v nej listovať;
slúži na kontrolu časovej postupnosti a vyhľadávanie chýb.

Kontrola dátového pripojenia

Po nastavení odporúčame overiť funkčnosť pomocou testovej zásielky.

Uistite sa, že zákazník priradený k zásielke je aktívny na stránke Zákazníci.
Vytvorte alebo upravte zásielku tak, aby došlo k jednej z nastavených udalostí webhooku.
Otvorte riadiaci panel Project44 Connect.
Vyhľadajte zásielku podľa Deliveo ID.
Skontrolujte udalosť Deliveo a príslušnú udalosť P44.
Skontrolujte, či stĺpec „Prijaté“ označuje úspešné prijatie.

Ukončenie prepojenia

Aktívne prepojenie s Project44 môžete zrušiť pomocou tlačidla „Zrušiť prepojenie“ na stránke „Nastavenia“.

Pred zrušením prepojenia skontrolujte, či už nie je potrebné odosielanie udalostí do Project44.

Po zrušení pripojenia je vhodné skontrolovať aj nastavenia webhookov pre Project44 Connect v ponuke Deliveo Nastavenia → Webhooky a v prípade potreby ich odstrániť.

Časté chyby

Na riadiacom paneli sa nezobrazujú udalosti

Skontrolujte:

či je prepojenie aktívne;
či je príslušný zákazník aktívny na stránke Zákazníci;
či sú nastavené potrebné webhooky;
či bola k príslušnej udalosti priradená správna URL adresa webhooku;
či sa udalosť stala v priebehu posledných 30 dní.

Project44 udalosť neakceptuje

Skontrolujte:

či má technický používateľ Project44 oprávnenie na správu zásielok;
či je prepojenie účtu Project44 aktívne;
či je v zásielke k dispozícii prenesené identifikačné číslo zásielky;
aké udalosti Deliveo a P44 sa zobrazujú na riadiacom paneli.

Zásielky daného zákazníka sa neprenášajú

Otvorte stránku Zákazníci a skontrolujte, či je u daného zákazníka zapnutý prepínač Aktívny.

V Project44 sa zobrazuje nesprávne identifikačné číslo zásielky

Skontrolujte identifikátor zásielky vybraný na stránke Nastavenia.

Možné hodnoty:

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

Po vykonaní zmien kliknite na tlačidlo Uložiť nastavenie identifikátora.

Nefunguje odosielanie niektorého typu udalosti

Skontrolujte, či je pre danú udalosť nastavený samostatný webhook. Pre každý typ udalosti je potrebné použiť vlastnú URL adresu, ktorá sa zobrazuje na stránke Project44 Connect.

P44 Connect