Saltar al contenido principal

Eliminar vehículo

DELETE 
/vehicles/:id

Propósito​

Elimina (soft-delete) un vehículo de la flota y lo desasocia de la empresa.

Objetivo​

Permitir que los transportistas den de baja vehículos que ya no están en servicio.

Casos de uso​

  • Un vehículo se vende y se elimina de la flota.
  • Se registró por error y se necesita eliminar.

Flujo de eliminación​

flowchart TD
  A[Recibir DELETE /vehicles/:id] --> B{¿Empresa encontrada?}
  B -->|No| C[404 NOT_FOUND]
  B -->|Sí| D{¿Vehículo en company.vehicles?}
  D -->|No| E[404 NOT_FOUND]
  D -->|Sí| F{¿Vehículo existe en BD?}
  F -->|No| G[404 NOT_FOUND]
  F -->|Sí| H[Soft-delete del vehículo]
  H --> I[Eliminar ID del array company.vehicles]
  I --> J[200 OK - ID del vehículo eliminado]

Detalles técnicos​

  • Verifica existencia y pertenencia a company.vehicles.
  • Utiliza soft-delete (mongoose-delete).
  • Elimina el ID del array company.vehicles y guarda la empresa.
  • Devuelve solo el _id del vehículo eliminado.

Autenticación​

Requiere JWT Bearer token o API Key.

Request​

Responses​

Vehículo eliminado (soft-delete) y desasociado de la empresa

Response Headers