-50 % avec le code BLACKFRIDAY50-20 % avec le code BLACKFRIDAY20
Intégrations et APIToutes les formules

API : mettre à jour le statut d'une commande

POST /api/v1/orders/{order_id}/status permet à votre caisse d'indiquer à Menuthere quand la cuisine a accepté une commande et quand elle est partie. Il faut une clé avec l'accès Orders. Envoyer un statut que la commande a déjà ne change rien : un nouvel essai est donc sans risque.

Où
Ask Menuthere support for a key
Formule
Le tableau de bord ne verrouille pas cela selon la formule.
Mis à jour

La requête

curl -X POST 'https://menuthere.com/api/v1/orders/ORDER_ID/status' -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{"status":"accepted"}'

ÉlémentValeur
Méthode et cheminPOST /api/v1/orders/{order_id}/status
En-têteAuthorization: Bearer ck_live_…, avec une clé ayant l'accès Orders
CorpsJSON : { "status": "accepted" }
order_idL'identifiant de la commande. Il arrive sous la forme data.order_id dans le webhook de commande.
status autorisésaccepted, food_ready, dispatched, in_transit, completed
Bon à savoirL'annulation n'est pas disponible ici. Une annulation rembourse les points de fidélité, remet les articles en stock et annule tout partenaire de livraison : elle reste donc dans le tableau de bord. Voir Annuler une commande. pending_payment appartient à la passerelle de paiement et ne peut pas non plus être défini.

La réponse

ChampSignification
oktrue en cas de succès.
order_idLa commande que vous avez mise à jour.
previous_statusL'état précédent de la commande.
statusLe statut qu'elle a maintenant.
changedtrue si le statut a changé. false si la commande l'avait déjà : dans ce cas, rien n'a été écrit.

Un changement réussi envoie aussi un événement order.status_updated à votre webhook, de sorte qu'un second système, comme une tablette, le voit aussi. Votre propre modification n'échoue jamais parce que le point d'accès de votre webhook est en panne.

Erreurs

Statut`error`Signification
400missing_status, unsupported_status, invalid_json, missing_order_idLe corps n'est pas valide, ou le statut ne figure pas dans la liste autorisée.
401missing_api_key, invalid_api_keyAucune clé, ou une clé erronée ou révoquée.
403scope_deniedLa clé n'a pas l'accès Orders.
404order_not_foundAucune commande avec cet identifiant sur votre compte.
429rate_limitedTrop de requêtes cette minute.
503lookup_failed, update_failedMenuthere n'a pas pu lire ou écrire la commande. Réessayez.

Questions

Que se passe-t-il si ma caisse réessaie après un délai dépassé ?
Rien de fâcheux. Si la commande a déjà ce statut, l'appel renvoie changed: false et n'écrit rien.
Le client reçoit-il un message quand je change le statut ?
La commande passe par ses états habituels : les flux qui se déclenchent sur ces états s'exécutent donc. Voir Suivi de commande envoyé aux clients.

Vous ne trouvez pas ? Écrivez à help@mail.menuthere.com ou discutez avec nous, de 9 h à 21 h.Centre d'aideTarifsmenuthere.com