Webhook je skvelý nástroj, ak chcete prepojiť Deliveo so systémom, s ktorým zatiaľ nie je integrované. Je možné, že budete potrebovať vývojárske (programátorské) kapacity na vytvorenie kódu, ktorý spracuje údaje odoslané systémom Deliveo. Externý systém môže byť napríklad ERP systém, fakturačný systém alebo čokoľvek iné.
Odosielanie údajov prebieha vždy metódou POST. Ako parameter GET môžete nastaviť ľubovoľné údaje (napr. autentifikačný token alebo kľúč).
Pod každým webhookom nájdete prepínače:
- Vypnuté – neuskutoční sa žiadne volanie
- Zjednodušené – volanie webhooku prebieha so základnými údajmi
- Rozšírené – volanie webhooku prebieha s rozšírenými údajmi
Volanie sa uskutoční ihneď po nastaňovaní udalosti. Návratové údaje volaní môžete vidieť v protokole Webhook: Protokol / Protokol Webhook
Volanie Webhook môžu spustiť nasledujúce udalosti:
Vytvorenie zásielky
Údaje odoslané v jednoduchom volaní:
"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 odoslané v rozšírenom volaní:
"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]"
"colli" => "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 ]
Príjem zásielky
Údaje odoslané v jednoduchom volaní:
"deliveo_id" => "DELI12345678910"
"location_id" => "125"
Údaje odoslané v rozšírenom hovore:
"deliveo_id" => "DELIV25030494014"
"location_id" => "7"
"location_name" => "DEV-003"
"courier_name" => "Joe Courier"
"courier_phone" => "+367012345678"
"location_type" => "vehicle / storage / pickup_point"
Prenos
Údaje odoslané v jednoduchom hovore:
"deliveo_id" => "DELI12345678910"
"location_id" => "A22"
Údaje odoslané v rozšírenom volaní:
"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"
Úspešné doručenie
Údaje odoslané v jednoduchom volaní:
"deliveo_id" => "DELIV25030445511"
"payment" => "CASH"
Údaje odoslané v rozšírenom volaní:
"deliveo_id" => "DELIV25030476575"
"payment" => "CASH"
"recipient" => "Charles Bronson"
Neúspešný pokus o doručenie
Údaje odoslané v jednoduchom volaní:
"deliveo_id" => "DELI25020884680"
"unsuccessful_id" => 5
Údaje odoslané v rozšírenom volaní:
"deliveo_id" => "DELI25024404680"
"unsuccessful_id" => 5
"state" => "Was not home"
"close" => "true / false"