API: Status einer Bestellung aktualisieren
Mit POST /api/v1/orders/{order_id}/status teilt Ihr POS Menuthere mit, wann die Küche eine Bestellung angenommen hat und wann sie rausging. Dafür brauchen Sie einen Schlüssel mit Orders-Zugriff. Wird ein Status gesendet, den die Bestellung schon hat, ändert sich nichts, ein erneuter Versuch ist also sicher.
- Wo
- Ask Menuthere support for a key
- Tarif
- Das Dashboard sperrt dies nicht nach Tarif.
- Aktualisiert
Die Anfrage
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"}'
| Teil | Wert |
|---|---|
| Methode und Pfad | POST /api/v1/orders/{order_id}/status |
| Header | Authorization: Bearer ck_live_…, von einem Schlüssel mit Orders-Zugriff |
| Body | JSON: { "status": "accepted" } |
| order_id | Die ID der Bestellung. Sie kommt als data.order_id im Bestell-Webhook an. |
| Erlaubter status | accepted, food_ready, dispatched, in_transit, completed |
Die Antwort
| Feld | Bedeutung |
|---|---|
| ok | true bei Erfolg. |
| order_id | Die Bestellung, die Sie aktualisiert haben. |
| previous_status | Was die Bestellung vorher war. |
| status | Der Status, den sie jetzt hat. |
| changed | true, wenn der Status gewechselt hat. false, wenn die Bestellung ihn schon hatte, dann wurde nichts geschrieben. |
Eine erfolgreiche Änderung sendet außerdem ein Ereignis order.status_updated an Ihren Webhook, damit ein zweites System, etwa ein Tablet, sie ebenfalls sieht. Ihre eigene Änderung scheitert nie daran, dass Ihr Webhook-Endpunkt ausgefallen ist.
Fehler
| Status | `error` | Bedeutung |
|---|---|---|
| 400 | missing_status, unsupported_status, invalid_json, missing_order_id | Der Body ist ungültig oder der Status steht nicht in der Liste der erlaubten. |
| 401 | missing_api_key, invalid_api_key | Kein Schlüssel oder ein falscher oder widerrufener. |
| 403 | scope_denied | Der Schlüssel hat keinen Orders-Zugriff. |
| 404 | order_not_found | Keine Bestellung mit dieser ID in Ihrem Konto. |
| 429 | rate_limited | Zu viele Anfragen in dieser Minute. |
| 503 | lookup_failed, update_failed | Menuthere konnte die Bestellung nicht lesen oder schreiben. Versuchen Sie es erneut. |
Fragen
Was passiert, wenn mein POS nach einem Timeout erneut versucht?
Bekommt der Gast eine Nachricht, wenn ich den Status ändere?
Siehe auch
Nicht gefunden? Schreiben Sie an [email protected] oder chatten Sie mit uns, 9 bis 21 Uhr.Hilfe-CenterPreisemenuthere.com