Adicionar itens a um pedido
POST/v1/orders/:id/combos
Adiciona um ou mais itens a um pedido existente e retorna o pedido com os totais recalculados. Envie todos os itens em uma única chamada: os totais são recalculados uma vez para todo o lote.
Cada item referencia uma variante de produto existente no seu menu por variant_id, e cada modificador referencia um modificador existente por modifier_id. A OlaClick resolve o produto, nome, preços e cozinha a partir do menu; você nunca os envia. Um id que não existe, ou que pertence a outra empresa, é rejeitado com 422.
A quantidade de um modificador é por unidade do item: um acompanhamento grande em um item com quantity: 2 registra dois acompanhamentos grandes.
Somente pedidos criados pela API podem ser alterados aqui. Um pedido feito na loja virtual, no POS ou em um food app pertence a esse canal e responde 422 order_not_modifiable.
Escopo necessário: orders:write
Request
Responses
- 201
- 401
- 403
- 404
- 422
O pedido com os itens adicionados.
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.