Eliminar conductor
DELETE/drivers/:id
Propósito
Elimina (soft-delete) un conductor de la empresa del usuario autenticado.
Objetivo
Permitir que los gestores de flotas den de baja conductores que ya no trabajan con la empresa.
Casos de uso
- Un conductor deja la empresa y se elimina su acceso.
- Se dio de alta por error y se necesita eliminar.
Flujo de eliminación
flowchart TD
A[Recibir DELETE /drivers/:id] --> B{¿Conductor existe?}
B -->|No| C[404 NOT_FOUND]
B -->|Sí| D{¿Pertenece a la empresa?}
D -->|No| E[403 NOT_ALLOWED]
D -->|Sí| F[Soft-delete del conductor]
F --> G[Eliminar ID del array cia.truckers]
G --> H[Guardar empresa]
H --> I[200 OK - ID del conductor eliminado]
Detalles técnicos
- Verifica que el conductor exista y pertenezca al array
cia.truckers. - Utiliza soft-delete (
mongoose-delete): el registro no se borra físicamente, se marca como eliminado. - Elimina el ID del conductor del array
cia.truckersy guarda la empresa. - Devuelve solo el
_iddel conductor eliminado como confirmación.
Autenticación
Requiere JWT Bearer token o API Key.
Request
Responses
- 200
- 401
- 403
- 404
- 500
Conductor eliminado (soft-delete). Devuelve el ID como confirmación
Response Headers
Token JWT o API Key ausente, expirado o inválido
Response Headers
El conductor no pertenece al array truckers de la empresa autenticada
Response Headers
No se encontró un conductor con el ID proporcionado
Response Headers
Error inesperado al eliminar el conductor