Atualizar status do pedido
PATCH/v1/orders/:id/status
Altera o status de um pedido e retorna o pedido atualizado. Os pedidos só avançam: enviar um status anterior ao atual deixa o pedido inalterado, e avançar vários passos aplica os status intermediários. Para cancelar um pedido, use POST /v1/orders/{id}/cancel.
É também assim que um pedido criado com POST /v1/orders é confirmado: ele começa como INITIATED, e status: PENDING (ou PREPARING) o publica para o comerciante e atribui seu número diário.
Diferente dos endpoints que alteram o conteúdo de um pedido, este funciona para pedidos de qualquer canal: avançar um pedido que o comerciante já está preparando é uma ação operacional, independentemente de quem a realizou.
Escopo necessário: orders:write
Request
Responses
- 200
- 401
- 403
- 404
- 422
O pedido atualizado.
Não autenticado — a requisição não possui uma credencial, ou o token Bearer / API key é inválido, expirou ou foi revogado.
Escopo insuficiente — a credencial está autenticada, mas não possui um escopo exigido pelo endpoint.
Não encontrado — nenhum recurso corresponde ao id no caminho (ou ele pertence a outra empresa).
Falha de validação — o corpo da requisição falhou na validação do schema. errors[] lista todos os campos com problema.