Il webhook è uno strumento eccellente se desideri collegare Deliveo a un sistema con cui non esiste ancora un'integrazione. Potrebbe essere necessario disporre di competenze di sviluppo (programmazione) per creare il codice che elabora i dati trasmessi da Deliveo. Il sistema esterno può essere un sistema ERP, un sistema di fatturazione o qualsiasi altro sistema.
L'invio dei dati avviene sempre con il metodo POST. Come parametro GET puoi impostare i dati che preferisci (ad es. token o chiave di autenticazione).
Sotto ogni webhook troverai dei pulsanti:
- Disattivato - non viene effettuata alcuna chiamata
- Semplificato: la chiamata al webhook viene effettuata con i dati di base
- Esteso: la chiamata al webhook viene effettuata con dati estesi
La chiamata avviene immediatamente dopo il verificarsi dell'evento. I dati di ritorno delle chiamate sono visibili nel registro Webhook: Registro / Registro Webhook
La chiamata Webhook può essere attivata dai seguenti eventi:
Creazione di una spedizione
Dati inviati in una chiamata semplice:
"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."
Dati inviati in una chiamata estesa:
"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 ]
Spedizione ricevuta
Dati inviati in una chiamata semplice:
"deliveo_id" => "DELI12345678910"
"location_id" => "125"
Dati inviati in una chiamata avanzata:
"deliveo_id" => "DELIV25030494014"
"location_id" => "7"
"location_name" => "DEV-003"
"courier_name" => "Joe Courier"
"courier_phone" => "+367012345678"
"location_type" => "vehicle / storage / pickup_point"
Trasferimento
Dati inviati in una chiamata semplice:
"deliveo_id" => "DELI12345678910"
"location_id" => "A22"
Dati inviati con chiamata estesa:
"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"
Consegna riuscita
Dati inviati in una chiamata semplice:
"deliveo_id" => "DELIV25030445511"
"payment" => "CASH"
Dati inviati in una chiamata estesa:
"deliveo_id" => "DELIV25030476575"
"payment" => "CASH"
"recipient" => "Charles Bronson"
Tentativo di consegna non riuscito
Dati inviati in una chiamata semplice:
"deliveo_id" => "DELI25020884680"
"unsuccessful_id" => 5
Dati inviati in una chiamata estesa:
"deliveo_id" => "DELI25024404680"
"unsuccessful_id" => 5
"state" => "Was not home"
"close" => "true / false"