50 % Rabatt mit dem Code BLACKFRIDAY5020 % Rabatt mit dem Code BLACKFRIDAY20
Integrationen und APIAlle Tarife

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"}'

TeilWert
Methode und PfadPOST /api/v1/orders/{order_id}/status
HeaderAuthorization: Bearer ck_live_…, von einem Schlüssel mit Orders-Zugriff
BodyJSON: { "status": "accepted" }
order_idDie ID der Bestellung. Sie kommt als data.order_id im Bestell-Webhook an.
Erlaubter statusaccepted, food_ready, dispatched, in_transit, completed
Gut zu wissenStornieren ist hier nicht möglich. Eine Stornierung erstattet Treuepunkte, füllt den Bestand wieder auf und ruft jeden Lieferpartner zurück, deshalb bleibt sie im Dashboard. Siehe Eine Bestellung stornieren. pending_payment gehört zum Zahlungsanbieter und lässt sich ebenfalls nicht setzen.

Die Antwort

FeldBedeutung
oktrue bei Erfolg.
order_idDie Bestellung, die Sie aktualisiert haben.
previous_statusWas die Bestellung vorher war.
statusDer Status, den sie jetzt hat.
changedtrue, 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
400missing_status, unsupported_status, invalid_json, missing_order_idDer Body ist ungültig oder der Status steht nicht in der Liste der erlaubten.
401missing_api_key, invalid_api_keyKein Schlüssel oder ein falscher oder widerrufener.
403scope_deniedDer Schlüssel hat keinen Orders-Zugriff.
404order_not_foundKeine Bestellung mit dieser ID in Ihrem Konto.
429rate_limitedZu viele Anfragen in dieser Minute.
503lookup_failed, update_failedMenuthere konnte die Bestellung nicht lesen oder schreiben. Versuchen Sie es erneut.

Fragen

Was passiert, wenn mein POS nach einem Timeout erneut versucht?
Nichts Schlimmes. Hat die Bestellung diesen Status schon, gibt der Aufruf changed: false zurück und schreibt nichts.
Bekommt der Gast eine Nachricht, wenn ich den Status ändere?
Die Bestellung durchläuft ihre normalen Zustände, daher laufen Abläufe, die bei diesen Zuständen auslösen. Siehe Bestell-Updates an Gäste.

Nicht gefunden? Schreiben Sie an help@mail.menuthere.com oder chatten Sie mit uns, 9 bis 21 Uhr.Hilfe-CenterPreisemenuthere.com