Saltar al contenido principal

Eliminar dirección

DELETE 
/addresses/:id

Propósito​

Elimina permanentemente una dirección de la empresa del usuario autenticado.

Objetivo​

Permitir limpiar direcciones obsoletas o erróneas que ya no son necesarias para la operativa de la empresa.

Casos de uso​

  • Eliminar una dirección de un almacén cerrado.
  • Limpiar direcciones duplicadas creadas por error.
  • Retirar puntos de entrega de clientes con los que ya no se trabaja.

Flujo de validación​

flowchart TD
  A[Recibir DELETE /addresses/:id] --> B{¿Usuario autenticado?}
  B -->|No| C[401 Unauthorized]
  B -->|Sí| D{¿Dirección existe?}
  D -->|No| E[404 NOT_FOUND]
  D -->|Sí| F{¿Pertenece a la empresa?}
  F -->|No| G[403 NOT_ALLOWED]
  F -->|Sí| H[Eliminar ref del array empresa]
  H --> I[Borrar documento Address]
  I --> J[200 OK]

Detalles técnicos​

La eliminación es irreversible: se borra el documento de la colección Address (soft-delete vía mongoose-delete) y se retira la referencia del array addresses de la empresa.

⚠️ Importante: Este endpoint no valida si la dirección está en uso como origen o destino en algún eCMR. Usa el campo can_be_deleted del listado (GET /addresses/) para verificarlo antes de invocar esta operación.

Autenticación​

Soporta JWT Bearer token y API Key.

Request​

Responses​

Dirección eliminada exitosamente. Devuelve el _id del registro borrado

Response Headers