API: actualizar el estado de un pedido
POST /api/v1/orders/{order_id}/status permite que tu POS le diga a Menuthere cuándo la cocina aceptó un pedido y cuándo salió. Necesita una clave con acceso Orders. Enviar un estado que el pedido ya tiene no cambia nada, así que reintentar es seguro.
- Dónde
- Ask Menuthere support for a key
- Plan
- El panel no bloquea esto por plan.
- Actualizado
La solicitud
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"}'
| Parte | Valor |
|---|---|
| Método y ruta | POST /api/v1/orders/{order_id}/status |
| Encabezado | Authorization: Bearer ck_live_…, de una clave con acceso Orders |
| Cuerpo | JSON: { "status": "accepted" } |
| order_id | El ID del pedido. Llega como data.order_id en el webhook de pedidos. |
| status permitido | accepted, food_ready, dispatched, in_transit, completed |
La respuesta
| Campo | Significado |
|---|---|
| ok | true si salió bien. |
| order_id | El pedido que actualizaste. |
| previous_status | Cómo estaba el pedido antes. |
| status | El estado que tiene ahora. |
| changed | true si el estado cambió. false si el pedido ya lo tenía, y en ese caso no se escribió nada. |
Un cambio exitoso también envía un evento order.status_updated a tu webhook, para que un segundo sistema, como una tableta, también lo vea. Tu propio cambio nunca falla porque el endpoint de tu webhook esté caído.
Errores
| Estado | `error` | Significado |
|---|---|---|
| 400 | missing_status, unsupported_status, invalid_json, missing_order_id | El cuerpo no es válido, o el estado no está en la lista permitida. |
| 401 | missing_api_key, invalid_api_key | No hay clave, o la clave es incorrecta o fue revocada. |
| 403 | scope_denied | La clave no tiene acceso Orders. |
| 404 | order_not_found | No hay ningún pedido con ese ID en tu cuenta. |
| 429 | rate_limited | Demasiadas solicitudes este minuto. |
| 503 | lookup_failed, update_failed | Menuthere no pudo leer ni escribir el pedido. Inténtalo de nuevo. |
Preguntas
¿Qué pasa si mi POS reintenta después de un tiempo de espera agotado?
¿El cliente recibe un mensaje cuando cambio el estado?
Relacionado
¿No lo encuentras? Escribe a [email protected] o chatea con nosotros, de 9 a. m. a 9 p. m.Centro de ayudaPreciosmenuthere.com