50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Интеграции и APIВсе тарифы

API: изменение статуса заказа

POST /api/v1/orders/{order_id}/status позволяет вашей кассе сообщать 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_idID заказа. Он приходит как data.order_id в вебхуке заказа.
Допустимый statusaccepted, food_ready, dispatched, in_transit, completed
Что стоит знатьОтмена здесь недоступна. Отмена возвращает баллы лояльности, возвращает позиции на склад и отзывает партнёра по доставке, поэтому она остаётся в панели. См. Отмена заказа. pending_payment принадлежит платёжной системе, и его тоже нельзя задать.

Ответ

ПолеЗначение
oktrue при успехе.
order_idЗаказ, который вы обновили.
previous_statusКаким заказ был раньше.
statusКакой статус у него теперь.
changedtrue, если статус изменился. false, если он у заказа уже был, и тогда ничего не записывалось.

Успешное изменение также отправляет событие order.status_updated на ваш вебхук, чтобы вторая система, например планшет, тоже его увидела. Ваше изменение никогда не завершится ошибкой из-за того, что адрес вебхука недоступен.

Ошибки

Статус`error`Значение
400missing_status, unsupported_status, invalid_json, missing_order_idТело недопустимо, или статуса нет в списке разрешённых.
401missing_api_key, invalid_api_keyНет ключа, либо ключ неверен или отозван.
403scope_deniedУ ключа нет доступа Orders.
404order_not_foundВ вашем аккаунте нет заказа с таким ID.
429rate_limitedСлишком много запросов в эту минуту.
503lookup_failed, update_failedMenuthere не смогла прочитать или записать заказ. Повторите попытку.

Вопросы

Что будет, если моя касса повторит запрос после таймаута?
Ничего плохого. Если у заказа уже есть этот статус, вызов вернёт changed: false и ничего не запишет.
Получит ли клиент сообщение, когда я меняю статус?
Заказ проходит обычные состояния, поэтому срабатывают сценарии, привязанные к этим состояниям. См. Обновления по заказу для клиентов.

Не нашли ответ? Напишите на help@mail.menuthere.com или в чат, с 9:00 до 21:00.Справочный центрЦеныmenuthere.com