Connexions API de livraison : comment ça marche
Relie l'API partenaire d'une plateforme de livraison : ses commandes arrivent par webhook directement sur l'écran cuisine avec le numéro de la plateforme, et le statut des commandes, la carte, les articles épuisés et l'ouverture / fermeture du point de vente remontent à la plateforme. Les commissions et versements restent sur la page Delivery platforms.
Leçon 3 sur 12 · Comment ça marche
Comment ça marche
Ajoutez une connexion sous «Add a connection» : Deliveroo, Talabat / foodpanda (Delivery Hero POS) et Uber Eats disposent d'API partenaires ; Careem, Noon Food et Zomato n'en publient pas et ne fonctionnent donc qu'en simulation. Pour elles, utilisez le «Generic webhook contract» via un middleware, ou la réception par CSV / e-mail.
Enregistrez les identifiants fournis par la plateforme et déclarez l'adresse du webhook auprès d'elle. La signature de chaque message est vérifiée ; les Messages La messagerie du personnel dans l'administration : messages directs, discussions de groupe et canaux comme #general. Tapez @ suivi d'un nom pour mentionner un collègue. Plus de mots dans le glossaire non signés ou altérés sont refusés.
Placez les articles dans l'onglet «Menu» avec leur identifiant d'article sur la plateforme ; «Push menu» les envoie au prix de la plateforme, et les ruptures signalées par la cuisine partent d'elles-mêmes.
Une commande devient une commande de plateforme ordinaire : stock et recettes, ticket cuisine avec le nom et le numéro de la plateforme, commission sur la commande, en attente du versement. Une même commande de plateforme n'est jamais prise deux fois.
Accepter, refuser, prête et récupérée se trouvent dans l'onglet «Orders» (ou se font automatiquement avec «Accept orders automatically») ; «Ready» est aussi envoyé quand la cuisine valide le dernier ticket.
Une commande contenant un article absent de la carte ici est mise en attente et une tâche s'ouvre : elle n'est jamais devinée et envoyée en cuisine. Une annulation par la plateforme arrête les tickets cuisine et ouvre une tâche.
Où le trouver
- Point of sale → Tables → Delivery API connections
/admin/pos/platforms/connections - Generic webhook contract
/admin/pos/platforms/connections?tab=generic
Réglages qui le modifient
- Platforms & prices
/admin/pos/platforms?tab=platforms
Liste de contrôle
Avant de continuer, vérifiez que vous savez :
- Ouvrir Point of sale → Tables → Delivery API connections
- Ajoutez une connexion sous Add a connection : Deliveroo, Talabat / foodpanda (Delivery Hero POS) et Uber…
- Enregistrez les identifiants fournis par la plateforme et déclarez l'adresse du webhook auprès d'elle.
- Placez les articles dans l'onglet Menu avec leur identifiant d'article sur la plateforme ; Push menu les…
- Une commande devient une commande de plateforme ordinaire : stock et recettes, ticket cuisine avec le nom et…
Astuces et erreurs fréquentes
- Envoyez des commandes de test depuis l'onglet «Simulator» avant d'utiliser de vrais identifiants : elles parcourent tout le circuit, signature comprise.
- Si la plateforme annule les commandes que vous n'avez pas acceptées à temps, activez «Accept orders automatically».
- Uber Eats n'a pas d'appel prête / récupérée : ces étapes sont seulement enregistrées ici.