Cancelar pedido

POST

Markdown (LLM)

Cancela um pedido DELIVERY, PDV ou TABLE.

Escopo:orders:write

Limite:300 requisições a cada 3 minutos.

Parâmetros de path

orderIdinteger

ID do pedido, maior ou igual a 1.

58449271

Parâmetros do body

cancellationReasonstring

Motivo do cancelamento.

"Cliente desistiu do pedido"

Parâmetros da resposta

Regras de cancelamento

O sucesso responde 200 sem corpo; consulte GET /v1/orders/{orderId} para ver o pedido. O cancelamento devolve o estoque e dispara o webhook order_updated.

Regras

Pedido com pagamento pago responde 409: remova o pagamento no PDV e repita a chamada. Pagamento só provisionado não bloqueia.
Pedido já cancelado responde 409, sem repetir webhook, estoque ou registro.
Pedido inexistente ou de outro restaurante responde 404.
A rota não remove pagamentos, não cancela a corrida na integradora de entrega e não emite aviso em tempo real para o painel.