DELETE
https://www.allpost.com.br/api/v1/pedido/{numeroPedido}/anexos

Remove um anexo de um pedido (reversa ou envio) do S3 e de db.Pedido.anexos[]; numeroPedido (1578397 ou rvs0_1578397) + caminho de anexos[].url do 147

Módulo: Pedido

Descrição

Remove um anexo de um pedido (reversa ou envio). Exclui o binário do S3 e o registro do anexo em db.Pedido.anexos[].

Exemplo:
- DELETE https://www.allpost.com.br/api/v1/pedido/{numeroPedido}/anexos?caminho=logisticaReversa/anexos/{id}/arquivo.png
- DELETE https://www.allpost.com.br/api/v1/pedido/rvs0_1578397/anexos?caminho=logisticaReversa/anexos/{id}/arquivo.png

O caminho é o mesmo retornado no campo anexos[].url do endpoint 147 (GET anexos do pedido). O endpoint valida que o anexo pertence ao pedido informado (impede remoção arbitrária de objetos do S3).

A remoção no banco ocorre mesmo se a exclusão no S3 falhar (remoção parcial permitida — evita registro órfão no documento).

Códigos de retorno:
- 200: anexo removido com sucesso (JSON com mensagem).
- 400: parâmetro caminho ausente.
- 401: token ausente, expirado ou inválido.
- 403: o pedido não pertence à loja autenticada.
- 404: pedido ou anexo não encontrado.

Parâmetros de Path

Parâmetro Tipo Obrigatório Descrição
numeroPedido string Sim Número do pedido ou número do pedido de reversa (ex.: 1578397 ou rvs0_1578397). Atende reversa e envio.
caminho string Sim Caminho relativo do anexo no S3 (obtido em anexos[].url do endpoint 147).

Response

Sucesso (200):

{
  "mensagem": "Anexo removido com sucesso."
}



Erro (JSON):

{
  "mensagem": "Anexo não encontrado."
}