El webhook es una herramienta excelente si deseas conectar Deliveo con un sistema con el que aún no existe integración. Es posible que necesites conocimientos de desarrollo (programación) para crear el código que procese los datos transmitidos por Deliveo. El sistema externo puede ser un sistema ERP, un programa de facturación o cualquier otro.
El envío de datos siempre se realiza mediante el método POST. Puedes configurar los datos que desees (por ejemplo, un token o clave de autenticación) como parámetros GET.
Debajo de cada webhook encontrarás unos interruptores:
- Desactivado: no se realiza ninguna llamada
- Simplificado: la llamada al webhook se realiza con datos básicos
- Ampliado: la llamada al webhook se realiza con datos ampliados
La llamada se realiza inmediatamente después de que se produzca el evento. Puedes ver los datos de respuesta de las llamadas en el registro de webhooks: Registro / Registro de webhooks
La llamada de webhook puede ser activada por los siguientes eventos:
Creación de un envío
Datos enviados en una llamada simple:
"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."
Datos enviados en una llamada ampliada:
"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 ]
Recepción de un envío
Datos enviados en una llamada simple:
"deliveo_id" => "DELI12345678910"
"location_id" => "125"
Datos enviados en una llamada ampliada:
"deliveo_id" => "DELIV25030494014"
"location_id" => "7"
"location_name" => "DEV-003"
"courier_name" => "Joe Courier"
"courier_phone" => "+367012345678"
"location_type" => "vehicle / storage / pickup_point"
Transferencia
Datos enviados en una llamada simple:
"deliveo_id" => "DELI12345678910"
"location_id" => "A22"
Datos enviados en una llamada ampliada:
"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"
Entrega correcta
Datos enviados en una llamada simple:
"deliveo_id" => "DELIV25030445511"
"payment" => "CASH"
Datos enviados en una llamada ampliada:
"deliveo_id" => "DELIV25030476575"
"payment" => "CASH"
"recipient" => "Charles Bronson"
Intento de entrega fallido
Datos enviados en una llamada simple:
"deliveo_id" => "DELI25020884680"
"unsuccessful_id" => 5
Datos enviados en una llamada ampliada:
"deliveo_id" => "DELI25024404680"
"unsuccessful_id" => 5
"state" => "Was not home"
"close" => "true / false"