Atualizar Status do Pedido

Introdução

Esta seção detalha como atualizar o status de um pedido no ambiente de sandbox.

Pré-requisitos para Atualização de Status do Pedido

Para atualizar o status de um pedido no ambiente de sandbox, é necessário utilizar:

• Um token de autorização válido para autenticação.
• O ID do pedido a ser atualizado.
• Um ID de canal válido para o ambiente de sandbox.
• O ID da entrega associada ao pedido.
• O status desejado para o pedido.

info

Os status disponíveis de atualização são:

• Approved
• Invoiced
• Shipped
• Delivered
• Cancelled

Abaixo está um exemplo de como atualizar o status de um pedido para approved (pagamento aprovado) utilizando CURL.

curl --request PUT \
  --url https://api-sandbox.magalu.com/v1/samples/orders/{id} \
  --header 'authorization: Bearer {{token}}' \
  --header 'content-type: application/json' \
  --data '{
    "channel": {
      "id": "5f62650a-0039-4d65-9b96-266d498c03bd"
    },
    "deliveries": [
      {
        "id": {delivery_id}
      }
    ],
    "status": "approved"
  }'

info

Observe que esse pedido não precisa ser criada no ambiente de sandbox de pedidos, e esse ambiente de sandbox está completamente separado de todos os demais.

atenção

Observe que o pedido deve ser criado no canal de sandbox, conforme explicitado na documentação do sandbox.

Cenários de Erros

Estes são exemplos de erros retornados como resposta à requisição.

Cenário	Código de Resposta	Como simular o cenário
Channel id 'channel_id' is unknown for the Sandbox environment.	422	Envie uma requisição com um channel_id inválido ou inexistente no ambiente de sandbox.
Delivery não existe no order informado.	404	Envie uma requisição utilizando um delivery inválido ou inexistente.
Package without approved invoice	400	Envie uma requisição utilizando status invoiced sem que tenha nota fiscal emitida previamente.