50% de descuento con el código BLACKFRIDAY5020% de descuento con el código BLACKFRIDAY20
Integraciones y APITodos los planes

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

ParteValor
Método y rutaPOST /api/v1/orders/{order_id}/status
EncabezadoAuthorization: Bearer ck_live_…, de una clave con acceso Orders
CuerpoJSON: { "status": "accepted" }
order_idEl ID del pedido. Llega como data.order_id en el webhook de pedidos.
status permitidoaccepted, food_ready, dispatched, in_transit, completed
Conviene saberAquí no se puede cancelar. Una cancelación devuelve los puntos de lealtad, repone el stock y cancela cualquier socio de delivery, así que se queda en el panel. Consulta Cancelar un pedido. pending_payment le pertenece a la pasarela de pago y tampoco se puede definir.

La respuesta

CampoSignificado
oktrue si salió bien.
order_idEl pedido que actualizaste.
previous_statusCómo estaba el pedido antes.
statusEl estado que tiene ahora.
changedtrue 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
400missing_status, unsupported_status, invalid_json, missing_order_idEl cuerpo no es válido, o el estado no está en la lista permitida.
401missing_api_key, invalid_api_keyNo hay clave, o la clave es incorrecta o fue revocada.
403scope_deniedLa clave no tiene acceso Orders.
404order_not_foundNo hay ningún pedido con ese ID en tu cuenta.
429rate_limitedDemasiadas solicitudes este minuto.
503lookup_failed, update_failedMenuthere 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?
Nada malo. Si el pedido ya tiene ese estado, la llamada devuelve changed: false y no escribe nada.
¿El cliente recibe un mensaje cuando cambio el estado?
El pedido pasa por sus estados normales, así que se ejecutan los flujos que se activan con esos estados. Consulta Avisos de pedidos a los clientes.

¿No lo encuentras? Escribe a help@mail.menuthere.com o chatea con nosotros, de 9 a. m. a 9 p. m.Centro de ayudaPreciosmenuthere.com