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. |