Интеграции и 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_id | ID заказа. Он приходит как data.order_id в вебхуке заказа. |
| Допустимый status | accepted, food_ready, dispatched, in_transit, completed |
Что стоит знатьОтмена здесь недоступна. Отмена возвращает баллы лояльности, возвращает позиции на склад и отзывает партнёра по доставке, поэтому она остаётся в панели. См. Отмена заказа. pending_payment принадлежит платёжной системе, и его тоже нельзя задать.
Ответ
| Поле | Значение |
|---|---|
| ok | true при успехе. |
| order_id | Заказ, который вы обновили. |
| previous_status | Каким заказ был раньше. |
| status | Какой статус у него теперь. |
| changed | true, если статус изменился. false, если он у заказа уже был, и тогда ничего не записывалось. |
Успешное изменение также отправляет событие order.status_updated на ваш вебхук, чтобы вторая система, например планшет, тоже его увидела. Ваше изменение никогда не завершится ошибкой из-за того, что адрес вебхука недоступен.
Ошибки
| Статус | `error` | Значение |
|---|---|---|
| 400 | missing_status, unsupported_status, invalid_json, missing_order_id | Тело недопустимо, или статуса нет в списке разрешённых. |
| 401 | missing_api_key, invalid_api_key | Нет ключа, либо ключ неверен или отозван. |
| 403 | scope_denied | У ключа нет доступа Orders. |
| 404 | order_not_found | В вашем аккаунте нет заказа с таким ID. |
| 429 | rate_limited | Слишком много запросов в эту минуту. |
| 503 | lookup_failed, update_failed | Menuthere не смогла прочитать или записать заказ. Повторите попытку. |
Вопросы
Что будет, если моя касса повторит запрос после таймаута?
Ничего плохого. Если у заказа уже есть этот статус, вызов вернёт changed: false и ничего не запишет.
Получит ли клиент сообщение, когда я меняю статус?
Заказ проходит обычные состояния, поэтому срабатывают сценарии, привязанные к этим состояниям. См. Обновления по заказу для клиентов.
См. также
Не нашли ответ? Напишите на [email protected] или в чат, с 9:00 до 21:00.Справочный центрЦеныmenuthere.com