Pular para o conteúdo principal

Marcar Entrega como Finalizada

Introdução​

Esta seção detalha como marcar uma entrega como finalizada no ambiente de sandbox.

Pré-requisitos para Marcar Entrega como Finalizada​

Para marcar uma entrega como finalizada no ambiente de sandbox, é necessário utilizar:

  • Um token de autorização válido para autenticação.
  • O ID da entrega associada ao pedido.
  • Um ID de canal válido para o ambiente de sandbox.
  • Data de entrega efetiva.

Abaixo está um exemplo de como marcar uma entrega como finalizada utilizando CURL.

curl --request POST \
  --url https://api-sandbox.magalu.com/v1/deliveries/{delivery_id}/finishing \
  --header 'authorization: Bearer {{token}}' \
  --header 'content-type: application/json' \
  --data '{
    "channel": {
      "id": "5f62650a-0039-4d65-9b96-266d498c03bd"
    },
    "delivered_at": "2025-08-12T09:12:20.313561"
  }'
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árioCódigo de RespostaComo simular o cenário
Channel id 'channel_id' is unknown for the Sandbox environment.422Envie uma requisição com um channel_id inválido ou inexistente no ambiente de sandbox.
Delivery não existe.404Envie uma requisição utilizando um delivery_id inválido ou inexistente.
Invalid delivered at.400Envie uma requisição informando delivered_at com data anterior a atual.