コードBLACKFRIDAY50で50%オフコードBLACKFRIDAY20で20%オフ
連携と API全プラン

API:注文のステータスを更新する

POST /api/v1/orders/{order_id}/status を使うと、キッチンが注文を承認したときや、注文が出たときを POS から Menuthere に伝えられます。Orders アクセスのあるキーが必要です。注文がすでにそのステータスのときに同じステータスを送っても何も変わらないため、再試行しても安全です。

場所
Ask Menuthere support for a key
プラン
ダッシュボードでは、これはプランによって制限されません。
更新日

リクエスト

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

項目値
メソッドとパスPOST /api/v1/orders/{order_id}/status
ヘッダーAuthorization: Bearer ck_live_…(Orders アクセスのあるキー)
ボディJSON:{ "status": "accepted" }
order_id注文の ID。注文の Webhook では data.order_id として届きます。
使える statusaccepted, food_ready, dispatched, in_transit, completed
知っておくと便利なことここからキャンセルはできません。キャンセルすると、ポイントの返却、在庫の戻し、配送パートナーの手配取り消しが行われるため、ダッシュボードでのみ行えます。注文をキャンセルするをご覧ください。pending_payment は決済ゲートウェイが管理するもので、これも設定できません。

レスポンス

項目意味
ok成功すると true。
order_id更新した注文。
previous_status更新前の注文のステータス。
status現在のステータス。
changedステータスが変わった場合は true。すでにそのステータスだった場合は false で、何も書き込まれません。

変更に成功すると、Webhook に order.status_updated イベントも送られるため、タブレットなどの別のシステムでも反映されます。Webhook のエンドポイントが停止していても、お店からの変更が失敗することはありません。

エラー

ステータス`error`意味
400missing_status, unsupported_status, invalid_json, missing_order_idボディが正しくないか、ステータスが許可されたリストにありません。
401missing_api_key, invalid_api_keyキーがない、またはキーが間違っているか無効になっています。
403scope_deniedキーに Orders アクセスがありません。
404order_not_foundアカウントにその ID の注文がありません。
429rate_limited1分間のリクエストが多すぎます。
503lookup_failed, update_failedMenuthere が注文を読み取れない、または書き込めませんでした。もう一度試してください。

よくある質問

タイムアウト後に POS が再試行するとどうなりますか?
問題ありません。注文がすでにそのステータスの場合、呼び出しは changed: false を返し、何も書き込みません。
ステータスを変更すると、お客様にメッセージが届きますか?
注文は通常の状態遷移をたどるため、その状態で始まるフローが実行されます。お客様への注文通知をご覧ください。

見つからない場合は help@mail.menuthere.com までメールするか、チャットでお問い合わせください(9:00〜21:00)。ヘルプセンター料金menuthere.com