Configuration du menu et contenu du menu
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.
Où puis-je voir des exemples de données pour un menu imbriqué?
Consultez la section Références.
Y a-t-il une taille de menu maximale acceptable?
Nous pouvons traiter avec succès les menus avec une taille de fichier allant jusqu’à 25 Mo.
Comment la section « Favoris » est-elle remplie?
Cette section est remplie en fonction d’un calcul effectué par DoorDash grâce à l’apprentissage automatique. Dans le cas où l’étape de menu a échoué, nous ne créerons pas de menu et l’identifiant du menu sera nul.
Comment puis-je supprimer un menu?
Pour supprimer un menu de la plateforme de DoorDash, soumettez une demande PATCH de menu en définissant active comme false.
Puis-je contrôler l’état d’un menu?
Oui, pour activer/désactiver un menu, soumettez une demande de mise à jour du menu en définissant le champ active à true ou false, selon le résultat souhaité.
Quelle est la différence entre price et base_price?
Le champ base_price est un champ facultatif stocké au niveau de l’article et de l’option supplémentaire de l’article. Il peut être utilisé pour activer la double tarification dans le cas des commandes à emporter. Ce champ contiendra le prix en magasin d’un article ou d’une option, sans tenir compte de toute augmentation qui pourrait être appliquée au prix de livraison. Le champ price demeure un champ obligatoire. Il doit contenir le prix d’un article ou d’une option à la livraison (qui peut avoir été augmenté, si le commerçant le souhaite). Si le champ base_price contient une valeur pour un article/une option, nous appliquerons ce prix aux menus à emporter. Lorsqu’un client bascule entre la commande à emporter et la livraison sur le site, les prix seront mis à jour en conséquence entre base_price (à emporter) et price (livraison). Il est recommandé d’indiquer des prix pour les commandes à emporter afin de protéger notre expérience client partagée. Vous trouverez plus de détails ici. Si vous souhaitez utiliser cette fonctionnalité, veuillez communiquer avec votre personne-ressource DoorDash pour l’activer pour votre entreprise.
Qu’est-ce qu’un article / un supplément / une option?
Comment puis-je spécifier un taux de taxe?
Depuis 2020, nous prenons en charge la définition des taux de taxe pour chaque article et option supplémentaire de l’article dans le menu. Si cette valeur est définie, DoorDash l’utilisera pour calculer les taxes dans les États et les provinces qui n’ont pas de loi de facilitateur de marché. Le taux doit être envoyé sous forme de nombre entier. Par exemple, si mon taux de taxe est de 5 % pour un article, le tax_rate doit être envoyé comme 5 dans la charge utile du menu (et non comme .05). Si les taux de taxe ne sont pas définis dans le menu, le moteur de taxe tiers de DoorDash sera utilisé pour calculer les taxes. Veuillez communiquer avec votre personne-ressource DoorDash pour obtenir plus d’informations si vous prévoyez définir les taux de taxe dans le menu. Par défaut, nous honorerons uniquement les taux de taxe par article, indiqués dans la charge utile du menu, dans le cas des commerçants des États et des provinces qui n’ont pas de loi de facilitateur de marché. Pour les commerçants des États et des provinces qui n’ont pas de loi de facilitateur de marché, nous utilisons les calculs de taxes de DoorDash, car DoorDash est responsable de remettre ce montant de taxe et de le payer au nom du commerçant. Si vous pensez qu’un ou plusieurs de vos commerçants devraient être exonérés de l’utilisation des montants de taxes calculés par DoorDash dans un États qui ont une loi de facilitation du marché, veuillez communiquer avec votre personne-ressource principale de DoorDash. Cette exemption n’est accordée que dans le cadre d’exceptions spéciales en attendant l’approbation de l’équipe fiscale de DoorDash.
Où puis-je trouver une liste des États et des provinces qui ont une loi de facilitateur de marché?
Vous pouvez trouver la liste actuelle des États et des provinces qui ont une loi de facilitateur de marché ici.
Le moteur de taxation de DoorDash inclut-il des frais supplémentaires tels que la taxe sur les boissons sucrées et les consignes pour les bouteilles?
Actuellement, le moteur de taxation de DoorDash n’inclut aucun de ces frais supplémentaires lors du calcul des taxes pour les commandes. De telles taxes devront être intégrées au menu par les commerçants qui doivent les appliquer.
Comment puis-je créer une option d’article par défaut?
Pour définir une itemOption sélectionnée par défaut, veuillez inclure le paramètre default défini à la valeur true dans la charge utile du menu.
Comment les catégories, les articles et les options d’articles sont-ils triés?
Toutes les entités sont triées selon le sort_id défini dans la charge utile du menu. Si ce champ est vide, la méthode de triage par défaut, l’ordre alphabétique, sera utilisée.
Comment puis-je créer un bouton radio?
Afin de créer un bouton radio, vous devez définir max_num_options = 1 et min_num_options = 1 afin qu’une seule option soit disponible.
Que contrôle chacun des champs min/max?
Veuillez vous assurer que ces champs sont correctement définis pour qu’ils puissent fonctionner ensemble. Sinon, des problèmes surviendront lorsqu’un client ne pourra pas répondre aux exigences de chaque champ et qu’il ne sera pas en mesure d’ajouter un article au panier. Par exemple, vous ne pouvez pas définir simultanément min_nim_options = 1 (qui signifie que le client doit sélectionner au moins 1 option) et max_option_choice_quantity = 0 (qui signifie que le client ne peut pas sélectionner plus de 0 option parmi toutes les options).
Détails des champs ci-dessous :
_num_options : Précise le nombre d’options que vous pouvez sélectionner. La valeur maximale ne peut jamais dépasser le nombre d’options disponibles pour un supplément donné.
Par exemple, si min_num_options = 2 et max_num_options = 2 pour « Choisissez les saveurs d’ailes désossées », le supplément est obligatoire et le client peut faire 2 choix maximum.
_option_choice_quantity : Précise la quantité maximale d’une seule option autorisée. S’il s’agit d’une valeur non nulle, un sélecteur de quantité multiple est affiché au lieu d’une case à cocher ou d’un bouton radio (capture d’écran ci-dessous).
Par exemple, si min_option_choice_quantity = 2, un client doit sélectionner au moins 2 ailes par saveur choisie.
Par exemple, si max_option_choice_quantity = 10, un client ne peut pas sélectionner plus de 10 ailes par saveur choisie.
_aggregate_choice_quantity : Précise la valeur maximale de la somme des quantités d’options autorisées.
Par exemple, si min_aggregate_choice_quantity = 10 et max_aggregate_choice_quantity = 10, le client doit sélectionner 10 ailes au total parmi ses choix de saveurs.
num_free_options : Associé à option_choice_quantity. Lorsqu’une commande dépasse le nombre défini d’options choisies, un prix est appliqué à chaque option ultérieure.
Par exemple, si _num_free_options = 4, si le client sélectionne plus de 4 options, il sera facturé pour chaque option supplémentaire en fonction du prix défini.
Si les options ont des prix différents et que le nombre sélectionné dépasse le num_free_options, DoorDash facturera au client l’option la plus chère.
Comment puis-je avoir plusieurs menus (segmentation de la journée)?
Si vous utilisez la méthode POST en indiquant plusieurs menus avec des heures distinctes (menus pour différentes parties de la journée), le menu qui s’applique aux heures actuelles est affiché par défaut. La logique de menu continu s’applique à ces menus si l’intervalle entre l’heure de fin du menu 1 et l’heure de début du menu 2 est moins de 1 minute; c’est-à-dire que DoorDash n’appliquera pas le tampon de 20 minutes à l’heure de fin du menu 1.
Si vous utilisez la méthode POST en indiquant plusieurs menus avec des heures qui se chevauchent, ceux-ci seront tous affichés sur la plateforme de DoorDash, comme le montre le menu déroulant de la capture d’écran ci-dessous. Pendant la période de chevauchement des heures, c’est dernier menu créé qui sera affiché par défaut. Par exemple : Si vous avez un menu déjeuner et un menu toute la journée, le menu affiché par défaut sur DoorDash est le dernier qui a été créé.
Comment ajouter des photos à mon menu?
Nous avons amélioré notre intégration au PDV pour maintenant extraire les photos directement de la source avec le reste du menu que nous extrayons. Si le système reconnaît que l’URL de la photo fournie avec un article est la même que celle de la dernière mise à jour du menu, nous n’intégrerons pas de nouvelle photo. Si le système détecte une nouvelle URL de photo, l’API traitera l’image dans les systèmes DoorDash et la transmettra à notre équipe interne de photos. L’équipe examinera et approuvera, recadrera et liera les photos ou rejettera les photos en fonction de nos lignes directrices relatives à la qualité des images. Ce processus de liaison effectue le mappage des valeurs de Item<>PhotoURL à partir de la charge utile du menu du PDV pour déterminer quelle photo doit être liée à quel article. Toutes les images approuvées devraient apparaître dans les 3 jours ouvrables suivants.
Exigences relatives aux URL
- Format http ou https
- Aucun paramètre de requête dans l’URL
- Se termine par .jpg, .jpeg ou .png
- L’image doit être accessible par DoorDash et non verrouillée par des exigences d’autorisation, c.-à-d. problèmes 403
Spécifications des photos
La plateforme DoorDash exige que les photos respectent certains critères pour qu’elles soient correctement affichées sur le site. Ces exigences sont les suivantes :
Format 16:9
Taille de fichier maximale de 2 Mo
Format JPG, JPEG ou PNG
Si la taille du fichier, le format de fichier ou les critères d’URL ne sont pas respectés, cette nouvelle fonctionnalité d’extraction des photos ne fonctionnera pas comme prévu et aucune photo ne sera liée à l’article. Si une photo ne respecte pas les exigences de format d’image, DoorDash tentera de recadrer la photo tout en conservant la qualité de l’image. Si le recadrage entraîne un mauvais cadrage, la photo sera rejetée.
Puis-je inclure de l’alcool dans mon menu DoorDash?
DoorDash permet aux commerçants de vendre de l’alcool sur la plateforme une fois qu’ils ont signé un addenda sur l’alcool. Veuillez communiquer avec votre personne-ressource DoorDash pour examiner et signer l’addenda sur l’alcool. La charge utile du menu contient un indicateur nommé is_alcohol pour indiquer la présence d’articles alcoolisés. Après la signature de l’addenda, lorsque cet indicateur est défini comme true, nous marquons l’article comme 21+ dans notre système principal. Veuillez vous assurer que tous les articles alcoolisés sont marqués comme true dans le menu pour éviter tout problème juridique.
Y a-t-il une limite au nombre d’articles/modificateurs/sous-modificateurs que mon menu peut contenir?
DoorDash permet jusqu’à environ 600 000 articles au total (y compris les modificateurs et les sous-modificateurs) dans le menu (ItemOptions, ItemExtraOptions). Si vous voyez que cette limite est atteinte, assurez-vous d’utiliser les mêmes valeurs merchant_supplied_id dans toutes les mises à jour PATCH du menu en tant que valeurs utilisées dans le POST initial du menu. Si la valeur de merchant_supplied_id est différente dans le POST et un PATCH ultérieur de menu, chaque valeur unique sera comptée comme un nouvel article et le seuil de 600 000 serait atteint beaucoup plus rapidement que prévu.