Der Webhook ist ein hervorragendes Werkzeug, wenn du Deliveo mit einem System verbinden möchtest, für das es noch keine Integration gibt. Möglicherweise benötigst du Entwicklungs- (Programmier-)Kapazitäten, um den Code zu erstellen, der die von Deliveo übermittelten Daten verarbeitet. Das externe System kann beispielsweise ein ERP-System, ein Rechnungsstellungsprogramm oder etwas anderes sein.
Die Datenübertragung erfolgt immer über die POST-Methode. Als GET-Parameter kannst du beliebige Daten festlegen (z. B. ein Authentifizierungstoken oder einen Schlüssel).
Unter jedem Webhook findest du Schalter:
- Ausgeschaltet – es erfolgt kein Aufruf
- Vereinfacht – der Webhook-Aufruf erfolgt mit Basisdaten
- Erweitert – der Webhook-Aufruf erfolgt mit erweiterten Daten
Der Aufruf erfolgt unmittelbar nach dem Eintreten des Ereignisses. Die Rückmeldedaten der Aufrufe kannst du im Webhook-Protokoll einsehen: Protokoll / Webhook-Protokoll
Der Webhook-Aufruf kann durch folgende Ereignisse ausgelöst werden:
Sendung erstellen
In einem einfachen Aufruf gesendete Daten:
"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."
Daten, die in einem erweiterten Aufruf gesendet werden:
"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 ]
Sendung eingegangen
Daten, die in einem einfachen Aufruf gesendet werden:
"deliveo_id" => "DELI12345678910"
"location_id" => "125"
Daten, die in einem erweiterten Anruf gesendet wurden:
"deliveo_id" => "DELIV25030494014"
"location_id" => "7"
"location_name" => "DEV-003"
"courier_name" => "Joe Courier"
"courier_phone" => "+367012345678"
"location_type" => "vehicle / storage / pickup_point"
Übertragung
In einem einfachen Anruf gesendete Daten:
"deliveo_id" => "DELI12345678910"
"location_id" => "A22"
Daten, die in einem erweiterten Anruf gesendet wurden:
"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"
Erfolgreiche Zustellung
Daten, die in einem einfachen Anruf gesendet wurden:
"deliveo_id" => "DELIV25030445511"
"payment" => "CASH"
Daten, die in einem erweiterten Anruf gesendet wurden:
"deliveo_id" => "DELIV25030476575"
"payment" => "CASH"
"recipient" => "Charles Bronson"
Fehlgeschlagener Zustellversuch
Daten, die in einem einfachen Anruf gesendet wurden:
"deliveo_id" => "DELI25020884680"
"unsuccessful_id" => 5
Daten, die in einem erweiterten Anruf gesendet wurden:
"deliveo_id" => "DELI25024404680"
"unsuccessful_id" => 5
"state" => "Was not home"
"close" => "true / false"