Documentation
Informations et status de livraison coursier (deliveryinfo)
Cette requête permet d’interroger l’état de la course créée.
Vous pouvez aussi avoir un retour automatique (pingback/webhook) à chaque étape ou modification de l’état de la course. Contactez le support pour demander l’activation du pinback automatique.
URL requête : http://www.expedy.fr/api/deliveryinfo
| Paramètre | Description |
| delivery_uid | UID obtenu après la création d’une course |
| Description résultats | |
| delivery_req_date | Date de la course (gmt+1 Paris) |
| delivery_type | Type d’envoi |
| delivery_speed | Durée de livraison max (en secondes) après prise en charge par le transporteur |
| delivery_step | Etapes de livraison : 0 = Nouvelle 1 = Livraison acceptée par le transporteur 2 = Livraison collectée (pickup done) 3 = Livraison terminée 4 = Livraison annulée |
| delivery_status | 0 or null : Not particular problem 1 = 15min delivery delay 2 = 30min delivery delay 3 = 1h delivery delay 4 = Unknown Pickup adress 5 = Pickup contact person unavailable 6 = Unknown delivery adress 7 = Delivery contact person unavailable 8 = Second delivery attempt</option> 9 = Returning to Sender/pickup</option> 10 = 15min pickup Restaurant/shop delay, shop is slow or busy 11 = 30 min pickup Restaurant/Shop delay, shop is slow or busy 99 = Delivery Canceled |
| runner_name | Prénom du coursier |
| runner_phone | Mobile du coursier |
| runner_acknowledgmentdate | Date livraison acceptée |
| runner_sig_pickup_date | Date livraison collectée |
| runner_sig_delivery_date | Date livraison terminée |
Exemple de code PHP
<?
// INTERROGER L'ETAT D'UNE COURSE ( api/deliveryinfo )
define('DS_SERVICE', 'api/deliveryinfo');
define('SID', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');
define('TOKEN', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');
define('DS_URL', 'www.expedy.fr');
define('DS_SERVICE_URL', 'https://'.DS_URL.'/'.DS_SERVICE);
$delivery_uid = "36XXBA5HW8CYU"; // id unique de la course
// construct params
$data_params = array('delivery_uid' => $delivery_uid);
// construct request :
$data_request = array(
'sid' => SID,
'token' => TOKEN,
'params' => $data_params
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, DS_SERVICE_URL);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data_request));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec ($ch);
curl_close ($ch);
header ("Content-Type: text/xml; charset=utf-8");
//print $result;
echo $result;
?>