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ètreDescription
delivery_uidUID obtenu après la création d’une course

Description résultats
delivery_req_dateDate de la course (gmt+1 Paris)
delivery_typeType d’envoi
delivery_speedDurée de livraison max (en secondes) après prise en charge par le transporteur
delivery_stepEtapes 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_status0 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_namePrénom du coursier
runner_phoneMobile du coursier
runner_acknowledgmentdateDate livraison acceptée
runner_sig_pickup_dateDate livraison collectée
runner_sig_delivery_dateDate 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;

?>