Aller au contenu principal

Suivez vos Dashers

Marketplace APIs are limited access

Notre pipeline d’intégration Marketplace est actuellement au maximum de sa capacité. Nous n’acceptons pas de nouveaux partenaires pour le moment pendant que nous développons des outils libre-service pour l’intégration des commerçants. Veuillez remplir le formulaire d’intérêt pour l’intégration de Marketplace pour communiquer avec DoorDash avant de développer votre intégration.

DoorDash a amélioré l’entente Open API en ajoutant un nouveau point d’ancrage Web. Les partenaires d’intégration peuvent s’abonner à ce point d’ancrage Web en fournissant à leur gestionnaire de compte technique un point de terminaison et les détails de l’autorisation.

Le point d’ancrage Web de l’état du Dasher contient un indicateur d’état, une référence à la commande spécifique et des informations sur le Dasher. Un événement de point d’ancrage Web sera déclenché chaque fois qu’un état de Dasher spécifique est atteint; plusieurs événements devraient donc se déclencher pour une commande.

En donnant aux PDV des commerçants un aperçu du cycle de vie complet d’une commande, nous pouvons augmenter l’efficacité opérationnelle en permettant aux commerçants :

  • D’ajouter la touche finale à une commande juste avant que le Dasher n’entre dans le commerce, tout en assurant la qualité des aliments (finir l’emballage, sortir la crème glacée du congélateur, etc.).
  • De comprendre l’état actuel d’une commande et ainsi éliminer le besoin de communiquer avec le service de soutien.
  • De donner la priorité aux commandes en cours, en complétant la commande avec le Dasher qui arrive le plus tôt.
  • D’améliorer l’expérience de transfert des commandes en connaissant les détails du Dasher.

Format de point d’ancrage Web

dasher_status : chaîne indiquant l’état actuel du Dasher. Les valeurs comprennent dasher_confirmed, arriving_at_store, arrived_at_store, dasher_out_for_delivery.

external_order_id : UUID unique de la commande envoyée au commerçant par DoorDash

client_order_id : merchant_supplied_id de la charge utile de la confirmation de commande. Lorsqu’un commerçant confirme la commande, il peut transmettre son numéro de commande interne dans le champ merchant_supplied_id, nous enregistrons cette valeur sous le nom client_order_id. Il s’agit de la valeur que nous renvoyons dans la charge utile en tant que client_order_id. Si cette valeur n’est pas transmise lors de la confirmation de la commande, elle sera définie comme nulle dans la charge utile

created_at : horodatage de l’événement d’état du Dasher

location_id : identifiant d’un commerce fourni par le commerçant

Phone_number : numéro de téléphone masqué du Dasher (Remarque : le Dasher ne peut être joint que si l’appel est lancé à partir du numéro de téléphone du commerce)

Charge utile du point d’ancrage Web

Vous trouverez ci-dessous un exemple de charge utile :

{
"event": {
"type": "dasher_status_update",
"status": "<SUCCESS> OR <FAILURE>",
"reference": "<reference_uuid>"
},
"created_at": "2021-06-02T17:41:29.996321Z",
"delivery": {
"external_order_id": "7424215690108_2",
"client_order_id": "12321444",
"location_id": "123852",
"dasher_status": "arrived_at_store",
"dasher": {
"phone_number": "(586) 381-6148",
"first_name": "Jude",
"last_name": "D.",
"vehicle": {
"color": "",
"make": "Dodge",
"model": "Dakota"
}
}
}
}

Codes de réponse et d’erreur

Une fois qu’un point d’ancrage Web est reçu, le fournisseur doit retourner les codes de réponse suivants

Code d’étatDétails
200Renvoie un état 200 pour indiquer que les données ont été reçues avec succès
401Non autorisé. DoorDash n’a pas de jeton d’authentification pour ce point de terminaison
403Interdit, DoorDash n’a pas accès à ce point de terminaison
500Erreur interne du serveur – quelque chose n’a pas fonctionné du côté Mx
503Service non disponible – Le point de terminaison Mx est partiellement ou totalement indisponible