Pular para o conteúdo principal

Soft delete a vehicle from the fleet

DELETE 
/company/vehicles/:id

Marca um veículo como excluído (exclusão lógica) da frota da empresa.

Objetivo​

Permitir que empresas removam veículos de uso ativo, mantendo o rastreamento de auditoria e a integridade dos dados históricos.

Casos de Uso​

  • Remover veículos vendidos ou desativados da frota ativa
  • Arquivar veículos antigos preservando registros históricos
  • Limpar a lista de veículos sem perder dados

Comportamento da Exclusão Lógica​

Este endpoint realiza uma exclusão lógica usando o plugin mongoose-delete:

  • O veículo NÃO é excluído permanentemente do banco de dados
  • O campo deleted é definido como true
  • O campo deletedAt recebe o carimbo de data/hora atual
  • O veículo é removido do array de veículos da empresa
  • Os dados permanecem no banco para fins de auditoria e recuperação

IMPORTANTE: Esta NÃO é uma exclusão permanente. O veículo pode ser recuperado por administradores do banco de dados, se necessário.

Efeitos Colaterais​

  • Atualiza o modelo da empresa para remover a referência do veículo do array de veículos
  • O veículo não aparecerá mais nas listagens da frota

Observação: Atualmente, não há validação de propriedade neste endpoint. Qualquer usuário autenticado pode excluir qualquer veículo se souber o ID. Isso pode representar uma preocupação de segurança.

Request​

Responses​

Veículo excluído com sucesso (exclusão lógica)

Response Headers