50% de desconto com o código BLACKFRIDAY5020% de desconto com o código BLACKFRIDAY20
Integrações e APITodos os planos

API: atualizar o status de um pedido

POST /api/v1/orders/{order_id}/status permite que seu PDV avise a Menuthere quando a cozinha aceitou um pedido e quando ele saiu. Precisa de uma chave com acesso Orders. Enviar um status que o pedido já tem não muda nada, então repetir a chamada é seguro.

Onde
Ask Menuthere support for a key
Plano
O painel não restringe isso por plano.
Atualizado

A requisição

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 e caminhoPOST /api/v1/orders/{order_id}/status
CabeçalhoAuthorization: Bearer ck_live_…, de uma chave com acesso Orders
CorpoJSON: { "status": "accepted" }
order_idO ID do pedido. Ele chega como data.order_id no webhook de pedidos.
status permitidoaccepted, food_ready, dispatched, in_transit, completed
Bom saberCancelar não está disponível aqui. Um cancelamento devolve pontos de fidelidade, repõe os itens no estoque e cancela qualquer parceiro de entrega, então fica no painel. Veja Cancelar um pedido. pending_payment pertence ao gateway de pagamento e também não pode ser definido.

A resposta

CampoSignificado
oktrue em caso de sucesso.
order_idO pedido que você atualizou.
previous_statusO que o pedido era antes.
statusO status que ele tem agora.
changedtrue se o status mudou. false se o pedido já o tinha, caso em que nada foi gravado.

Uma mudança bem-sucedida também envia um evento order.status_updated ao seu webhook, para que um segundo sistema, como um tablet, também a veja. Sua própria mudança nunca falha porque o endpoint do seu webhook está fora do ar.

Erros

Status`error`Significado
400missing_status, unsupported_status, invalid_json, missing_order_idO corpo não é válido, ou o status não está na lista permitida.
401missing_api_key, invalid_api_keySem chave, ou chave errada ou revogada.
403scope_deniedA chave não tem acesso Orders.
404order_not_foundNenhum pedido com esse ID na sua conta.
429rate_limitedRequisições demais neste minuto.
503lookup_failed, update_failedA Menuthere não conseguiu ler ou gravar o pedido. Tente de novo.

Perguntas

O que acontece se meu PDV repetir a chamada depois de um timeout?
Nada de ruim. Se o pedido já tem esse status, a chamada retorna changed: false e não grava nada.
O cliente recebe uma mensagem quando eu mudo o status?
O pedido passa pelos estados normais, então os fluxos que disparam nesses estados rodam. Veja Avisos de pedido para os clientes.

Não encontrou? Escreva para help@mail.menuthere.com ou fale com a gente no chat, das 9h às 21h.Central de ajudaPreçosmenuthere.com