Connecter DoorDash Drive : coter, expédier et suivre les livraisons locales

Copiez Developer ID, Key ID et Signing Secret depuis la page Credentials du DoorDash Developer Portal, choisissez une option d’enlèvement dans Integration (une adresse d’enlèvement, ou la paire External Business ID plus External Store ID), testez, puis demandez des livraisons DoorDash Drive.

Le connecteur DoorDash demande des livraisons locales DoorDash Drive depuis ce système : il obtient un devis, crée une livraison, consulte le statut et peut annuler une livraison. C’est uniquement une connexion de livraison du dernier kilomètre : il n’importe pas les commandes du marketplace DoorDash dans ce système et ne synchronise ni menus ni catalogues de magasin. Devis et livraisons utilisent votre propre compte DoorDash Drive et votre lieu d’enlèvement.

Prérequis#

• Un compte DoorDash Drive et l’accès au DoorDash Developer Portal, où la page Credentials affiche votre Developer ID, Key ID et Signing Secret.
• Vous savez comment identifier l’enlèvement : soit l’adresse d’enlèvement en une ligne de votre magasin ou entrepôt, soit un magasin déjà enregistré chez DoorDash, désigné par son External Business ID et son External Store ID. L’adresse et la paire d’ID sont des alternatives : choisissez laquelle vous utiliserez avant de commencer.
• Le nom de l’établissement d’enlèvement et un numéro que le livreur peut appeler à l’enlèvement, si vous voulez les afficher : par exemple, le nom du magasin et sa ligne directe.

Obtenir les identifiants#

1. Connectez-vous au DoorDash Developer Portal et ouvrez la page Credentials.
2. Copiez le Developer ID affiché sur cette page. Il identifie votre compte développeur et fait partie des trois valeurs avec lesquelles la connexion signe les requêtes.
3. Copiez le Key ID affiché sur la même page Credentials.
4. Copiez en entier le Signing Secret affiché sur la même page Credentials. Le Key ID et le Signing Secret vont ensemble comme une paire, et le Signing Secret est une valeur en base64 que la connexion utilise pour signer un jeton de courte durée à chaque requête : copiez-le depuis la même page que le Key ID, pas depuis une autre paire de clés.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → DoorDash → Nouvelle connexion.
2. developer_id, obligatoire, Developer ID : collez le Developer ID de DoorDash Developer Portal → page Credentials.
3. key_id, obligatoire, Key ID : collez le Key ID de la même page Credentials.
4. signing_secret, obligatoire, Signing Secret : collez en entier le Signing Secret de la même page Credentials. C’est un champ de type mot de passe, conservé comme secret.
5. Choisissez maintenant UNE option d’enlèvement. Option A, l’adresse : remplissez pickup_address avec l’adresse d’enlèvement en une ligne de votre magasin ou entrepôt, par ex. 901 Market Street, San Francisco, CA 94103, US, et laissez vides les deux champs d’ID externes.
6. Option B, un magasin enregistré : laissez pickup_address vide et remplissez LES DEUX champs, pickup_external_business_id (External Business ID) et pickup_external_store_id (External Store ID), avec les ID du magasin enregistré chez DoorDash. Les deux ID doivent toujours être remplis ensemble comme une paire : n’en remplir qu’un ne fonctionne pas, car l’adresse d’un magasin enregistré ne remplace l’adresse d’enlèvement que lorsque les deux ID sont présents.
7. pickup_business_name, facultatif, nom de l’établissement d’enlèvement : le nom affiché au livreur pour l’enlèvement, par ex. le nom de votre magasin. pickup_phone_number, facultatif, téléphone d’enlèvement : un numéro que le livreur peut appeler à l’enlèvement, par ex. +16505550100.
8. user_agent, facultatif, User-Agent : dans la plupart des cas, laissez-le vide ; la connexion utilisera sa valeur par défaut, Docklify/1.0.

Tester la connexion#

Cliquez sur Tester la connexion. Le test vérifie d’abord que les trois valeurs d’identifiants sont présentes (developer_id, key_id et signing_secret) et s’arrête sans envoyer de requête s’il en manque une. Les trois présentes, il signe un jeton de courte durée (cinq minutes) à partir des trois valeurs et l’utilise pour chercher une livraison qui n’existe pas : docklify-probe-nonexistent. Une réponse 404 de DoorDash est la réussite : le jeton signé a été accepté et seule la livraison inventée est absente. Le résultat attendu de ce test est donc un 404, pas une erreur à corriger. Une réponse 401 ou 403 est signalée comme AUTH_FAILED et c’est le vrai échec : DoorDash a rejeté le jeton signé. Si vous lancez le test avant d’enregistrer des identifiants, le résultat est seulement une vérification simulée : enregistrez les vrais identifiants et testez à nouveau pour un résultat réel. Le test ne crée aucune livraison et ne vérifie ni votre adresse d’enlèvement ni votre paire d’ID externes : un mauvais réglage d’enlèvement peut donc passer le test et n’échouer que plus tard, au devis ou à la création de la livraison.

Mapping / choisir un modèle#

DoorDash Drive n’a pas besoin de mapping de commandes : elle traite des livraisons, pas des commandes. Ce que vous confirmez ici, c’est le réglage d’enlèvement de l’étape de saisie, plus les champs de livraison portés par chaque demande : l’enlèvement vient soit de votre pickup_address, soit de votre magasin enregistré (External Business ID plus External Store ID), et chaque demande de livraison utilise l’adresse de destination, le contact et les articles de l’envoi dans ce système. Avant d’activer, créez un devis réel et une livraison de test vers votre propre adresse, puis comparez le nom d’enlèvement, le téléphone d’enlèvement et les détails de destination avec l’envoi.

Activer#

Après activation, les envois de ce système peuvent demander des livraisons DoorDash Drive : la connexion cote la livraison, la crée après acceptation du devis, conserve le statut de la livraison sur l’envoi et peut annuler une livraison pas encore enlevée. Surveillez les premières livraisons réelles dans Runs / Logs et comparez les détails d’enlèvement et de destination avec DoorDash avant de laisser la connexion sans surveillance.

Ce que cette connexion ne fait pas : elle n’importe pas les commandes du marketplace DoorDash dans ce système, ne synchronise ni menus ni catalogues de magasin et ne règle ni la paie des livreurs ni la facturation DoorDash à votre place. Elle se limite à coter, créer, suivre et annuler des livraisons DoorDash Drive pour les envois que vous passez par elle.

FAQ#

Le test mentionne 404 — a-t-il échoué ?

Non — pour DoorDash Drive, ce 404 est le signal de réussite. Le test cherche volontairement une livraison qui n’existe pas, docklify-probe-nonexistent. Recevoir une réponse introuvable signifie que DoorDash a accepté le jeton signé à partir de vos developer_id, key_id et signing_secret, et n’a rejeté que la livraison inventée.

Considérez le test comme réussi et passez à l’activation. Seule une réponse 401 ou 403, signalée comme AUTH_FAILED, signifie un vrai échec du test.

Le test échoue avec AUTH_FAILED, 401 ou 403

DoorDash a rejeté le jeton signé, ce qui signifie que l’une des trois valeurs ne correspond pas : developer_id, key_id ou signing_secret a été mal copié, ou le Signing Secret collé n’appartient pas au Key ID collé — les deux forment une paire émise ensemble sur la page Credentials.

Retournez dans DoorDash Developer Portal → page Credentials et recopiez les trois valeurs depuis cette même page : Developer ID dans developer_id, Key ID dans key_id, et le Signing Secret appartenant à ce Key ID, en entier, dans signing_secret. Puis testez à nouveau.

Le test s’arrête avant tout envoi parce qu’un identifiant manque

Le test signe son jeton avec les trois valeurs d’identifiants : il ne peut donc même pas commencer s’il en manque une. Sans developer_id, key_id et signing_secret ensemble, il n’y a rien pour signer, et le test s’arrête au lieu d’envoyer une requête qui ne peut pas réussir.

Remplissez les trois champs depuis DoorDash Developer Portal → page Credentials, enregistrez la connexion, puis testez à nouveau. Ne testez sans identifiants que pour la vérification simulée : enregistrez les vraies valeurs pour un résultat réel.

Je n’ai rempli qu’un des deux champs d’ID externes et les enlèvements ne fonctionnent pas

L’External Business ID et l’External Store ID ne fonctionnent qu’en paire. L’adresse d’un magasin enregistré ne remplace l’adresse d’enlèvement que lorsque les deux ID sont présents ensemble : avec un seul ID, la connexion n’a ni magasin enregistré complet ni, si vous avez laissé l’adresse vide, d’adresse d’enlèvement du tout.

Choisissez une option et complétez-la : soit remplissez LES DEUX champs pickup_external_business_id et pickup_external_store_id pour le magasin enregistré, soit effacez les deux champs d’ID et remplissez pickup_address avec l’adresse d’enlèvement en une ligne. Puis refaites un devis.

Le test réussit, mais la création d’une livraison échoue côté enlèvement

Le test de connexion ne prouve que les identifiants : il signe un jeton et interroge une livraison qui n’existe pas. Il ne vérifie ni votre adresse d’enlèvement ni votre paire d’ID externes : une adresse manquante, une paire d’ID incomplète ou une paire d’ID d’un magasin non enregistré peut donc passer le test et n’apparaître que lorsqu’un devis ou une livraison réelle essaie d’utiliser cet enlèvement.

Vérifiez l’option d’enlèvement sur la connexion : pickup_address rempli comme une adresse complète en une ligne, ou les deux champs d’ID externes remplis pour un magasin enregistré chez DoorDash — sans mélange, et sans ID unique. Corrigez, enregistrez, puis refaites le devis avant de créer la livraison.

Le livreur va au mauvais endroit ou ne joint personne à l’enlèvement

Le livreur suit ce que la connexion envoie pour l’enlèvement : l’adresse d’enlèvement (ou le magasin enregistré derrière votre paire d’ID externes), le pickup_business_name affiché pour l’enlèvement et le pickup_phone_number que le livreur peut appeler. Si l’un de ces éléments est faux ou manquant, le livreur reçoit le mauvais endroit, le mauvais nom ou un numéro injoignable.

Corrigez les champs d’enlèvement sur la connexion : l’adresse d’enlèvement ou la paire d’ID du magasin enregistré, pickup_business_name avec le nom que le personnel de l’enlèvement reconnaîtra, et pickup_phone_number avec un numéro décroché aux heures d’enlèvement. Enregistrez : les valeurs corrigées serviront à la prochaine livraison — les livraisons déjà créées gardent les détails d’enlèvement de leur création.