Webhook je vynikající nástroj, pokud chcete propojit Deliveo se systémem, se kterým zatím není integrováno. Je možné, že budete potřebovat vývojářské (programátorské) kapacity k vytvoření kódu, který bude zpracovávat data předávaná systémem Deliveo. Externím systémem může být například ERP systém, fakturační systém nebo cokoli jiného.
Odesílání dat se vždy provádí metodou POST. Jako parametr GET můžete nastavit libovolná data (např. autentizační token nebo klíč).
Pod každým webhookem najdete přepínače:
- Vypnuto – nedochází k volání
- Zjednodušené – volání webhooku se provádí se základními údaji
- Rozšířené – volání webhooku se provádí s rozšířenými údaji
Volání se provede ihned po výskytu události. Návratové údaje volání můžete vidět v protokolu webhooků: Protokol / Protokol webhooků
Volání webhooku mohou spustit následující události:
Vytvoření zásilky
Údaje zaslané v jednoduchém volání:
"deliveo_id" => "DELIV25020302677"
"sender" => "John Wick"
"sender_country" => "HU"
"sender_zip" => "2340"
"sender_city" => "Kiskunlacháza"
"sender_address" => "Kinizsi 10"
"sender_apartment" => "Kinizsi 10"
"consignee" => "John Doe"
"consignee_country" => "HU"
"consignee_zip" => "2340"
"consignee_city" => "Belgrad"
"consignee_address" => "Main street 1"
"consignee_apartment" => "1"
"customer" => "Monster Inc."
"customer_country" => "HU"
"customer_zip" => "555666"
"customer_city" => "Los Angeles"
"customer_address" => "Baker str. 3."
"customer_building" => "3."
Údaje odeslané v rozšířeném volání:
"deliveo_id" => "DELIV25020302677"
"sender" => "John Wick"
"sender_country" => "HU"
"sender_zip" => "2340"
"sender_city" => "Kiskunlacháza"
"sender_address" => "Kinizsi 10"
"sender_apartment" => "A/2"
"sender_phone" => "+363012345678"
"sender_email" => "[email protected]"
"consignee" => "John Doe"
"consignee_country" => "HU"
"consignee_zip" => "2340"
"consignee_city" => "Belgrad"
"consignee_address" => "Main street 1"
"consignee_apartment" => "B/21"
"consignee_phone" => "+362012345678"
"consignee_email" => "[email protected]"
"customer_id" => "12345"
"customer" => "Monster Inc."
"customer_country" => "HU"
"customer_zip" => "555666"
"customer_city" => "Los Angeles"
"customer_address" => "3."
"customer_phone" => "+36305059287"
"customer_email" => "[email protected]"
"colliBalicí jednotka. Ukazuje, kolik kusů je součástí dané zásilky." => "1"
"cod" => "0.00"
"referenceid" => "ref123456-ABC"
"tracking" => "tr_123456"
"sender_lat" => "12.34567890"
"sender_lng" => "12.34567890"
"consignee_lat" => "12.34567890"
"consignee_lng" => "12.34567890"
"courier_lat" => "12.34567890"
"courier_lng" => "12.34567890"
"packages" => array:1 [ 0 => array:4 [ "weight" => "1.00" "customcode" => "52061-760142_0" "x" => 5 "y" => 10 "z" => 15 ]
Zásilka doručena
Údaje zaslané v jednoduchém volání:
"deliveo_id" => "DELI12345678910"
"location_id" => "125"
Údaje odeslané v rozšířeném hovoru:
"deliveo_id" => "DELIV25030494014"
"location_id" => "7"
"location_name" => "DEV-003"
"courier_name" => "Joe Courier"
"courier_phone" => "+367012345678"
"location_type" => "vehicle / storage / pickup_point"
Převod
Údaje zaslané v jednoduchém hovoru:
"deliveo_id" => "DELI12345678910"
"location_id" => "A22"
Údaje zaslané v rozšířeném volání:
"deliveo_id" => "DELI24050227112"
"location_id" => "A22"
"location_id_old" => "A13"
"location_type" => "vehicle / storage / pickup_point"
"location_country" => "Hrvatska"
"location_zip" => "10000"
"location_city" => "Zagrab"
"location_address" => "Martićeva ul. 71"
"location_lat" => "12.34567890"
"location_lng" => "12.34567890"
Úspěšné doručení
Údaje zaslané v jednoduchém hovoru:
"deliveo_id" => "DELIV25030445511"
"payment" => "CASH"
Údaje odeslané v rozšířeném volání:
"deliveo_id" => "DELIV25030476575"
"payment" => "CASH"
"recipient" => "Charles Bronson"
Neúspěšný pokus o doručení
Údaje zaslané v jednoduchém volání:
"deliveo_id" => "DELI25020884680"
"unsuccessful_id" => 5
Údaje odeslané v rozšířeném volání:
"deliveo_id" => "DELI25024404680"
"unsuccessful_id" => 5
"state" => "Was not home"
"close" => "true / false"