VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Referência completa/Pedidos

PUTAtualizar produtos do pedido

Atualiza as quantidades e os produtos de um pedido existente.

Use este endpoint para atualizar os produtos de um pedido existente. Você pode mudar as quantidades ou adicionar e remover produtos. A resposta devolve o ID do pedido atualizado.

Importante

Ao atualizar um pedido com vários produtos, informe todos os produtos que devem continuar no pedido. Qualquer produto que não for informado na requisição é removido do pedido.

PUT/api/orders/{order_id}Seller

Atualiza os produtos de um pedido

Cabeçalhos

Authorizationstringobrigatório
Basic Auth. Combinação usuário:senha codificada em Base64 (o e-mail e a chave de API do Seller Center).

Parâmetros de caminho

order_idintegerobrigatório
ID do pedido a atualizar.

Corpo da requisição

productsobjectobrigatório

Objeto com as informações dos produtos a atualizar no pedido. Cada chave é um código de produto e cada valor é um objeto com os detalhes do produto a atualizar.

amountstring/integerobrigatório
Nova quantidade do produto no pedido.

Exemplo de requisição

bash
curl -X PUT "$BASE_URL/api/orders/5127" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "products": {
    "7893590691023": {
      "amount": "5"
    },
    "7501006707694": {
      "amount": 17
    }
  }
}'

Resposta

200Pedido atualizado (200 OK)
json
{
  "order_id": "5127"
}

Erros

StatusQuandoCorpo de exemplo
400Requisição inválida: erro de sintaxe, JSON malformado.{"message": "Bad Request: Syntax error, malformed JSON", "status": 400}
Dica

Para remover um produto do pedido por completo, você pode não incluí-lo na requisição (mas inclua todos os outros produtos que quer manter) ou definir a quantidade (amount) dele como 0.

Nota

Ao atualizar os produtos, o sistema pode recalcular o frete, os impostos e outros valores do pedido. Consulte os detalhes do pedido depois da alteração para obter as informações mais atuais.

Veja também

  • Atualizar status do pedido
  • Detalhes do pedido
  • Visão geral de pedidos
Anterior
Envios do pedido
Próxima
Atualizar status do pedido
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também