:id`

Cancela una orden pendiente o en proceso y restaura el stock correspondiente.

📍 Ruta

DELETE /api/orders/delete/:id

📝 Descripción

Este endpoint cancela una orden existente, validando primero su estado. Si es 'Pendiente' o 'En proceso', se procede a restaurar el stock de los productos relacionados usando operaciones atómicas (bulkWrite).
Si la restauración del inventario es exitosa, la orden se marca como 'Cancelado'. Si ocurre un conflicto o error, se evita cambiar el estado de la orden para preservar la consistencia.

🔐 Autenticación

Requiere un token JWT válido.

Middleware aplicado:

verificarAutenticacion

validateDeleteOrder

validateRequest

🔢 Parámetros

🛣️ Path Parameters

Parámetro	Tipo	Requerido	Descripción
`id`	string	✅	`_id` de la orden (formato ObjectId)

📥 Request Body

No se requiere ningún cuerpo (body) para esta solicitud.

✅ Respuestas

✔️ 200 OK – Orden cancelada y stock restaurado correctamente

{
  "status": "success",
  "code": "ORDER_CANCELLED",
  "msg": "Orden cancelada con éxito y stock restaurado.",
  "data": {
    "_id": "ObjectId",
    "status": "Cancelado"
  },
  "info": {
    "stockRestoreDetails": {
      "attempted": 3,
      "modified": 3,
      "status": "Éxito",
      "message": "Stock restaurado correctamente para todos los productos."
    }
  }
}

❌ Errores

⚠️ 400 Bad Request – ID inválido

{
  "status": "error",
  "code": "INVALID_FORMAT",
  "msg": "ID de orden inválido: 123abc."
}

⚠️ 400 Bad Request – Estado de orden no cancelable

{
  "status": "error",
  "code": "INVALID_OPERATION",
  "msg": "No se puede cancelar una orden con estado 'Enviado'. Solo se permiten 'Pendiente' o 'En proceso'."
}

🔐 401 Unauthorized – Token ausente o inválido

{
  "status": "error",
  "code": "AUTH_ERROR",
  "msg": "Acceso no autorizado. Se requiere token válido."
}

🕳️ 404 Not Found – Orden no encontrada

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "Orden con ID 662cdef90a2f4e30e8ac9b4e no encontrada."
}

❗ 409 Conflict – Fallo al restaurar el stock

{
  "status": "error",
  "code": "STOCK_CONFLICT",
  "msg": "Conflicto al restaurar stock: Se intentaron 4 restauraciones, pero solo 2 se completaron. La orden NO fue cancelada.",
  "info": {
    "attempted": 4,
    "modified": 2,
    "status": "Conflicto",
    "message": "Fallo parcial en operaciones de inventario."
  }
}

💥 500 Internal Server Error – Falla inesperada

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al cancelar la orden. Intente de nuevo más tarde.",
  "info": {
    "detail": "Excepción en la restauración del stock.",
    "stockRestoreStatus": "Error al restaurar...",
    "orderCancelStatus": "Error al cancelar..."
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Eliminar Orden

🗑️ DELETE `/orders/delete/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Orden cancelada y stock restaurado correctamente

❌ Errores

⚠️ 400 Bad Request – ID inválido

⚠️ 400 Bad Request – Estado de orden no cancelable

🔐 401 Unauthorized – Token ausente o inválido

🕳️ 404 Not Found – Orden no encontrada

❗ 409 Conflict – Fallo al restaurar el stock

💥 500 Internal Server Error – Falla inesperada

Request

Responses

Eliminar Orden

🗑️ DELETE /orders/delete/:id#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🔢 Parámetros#

🛣️ Path Parameters#

📥 Request Body#

✅ Respuestas#

✔️ 200 OK – Orden cancelada y stock restaurado correctamente#

❌ Errores#

⚠️ 400 Bad Request – ID inválido#

⚠️ 400 Bad Request – Estado de orden no cancelable#

🔐 401 Unauthorized – Token ausente o inválido#

🕳️ 404 Not Found – Orden no encontrada#

❗ 409 Conflict – Fallo al restaurar el stock#

💥 500 Internal Server Error – Falla inesperada#

Request

Responses

🗑️ DELETE `/orders/delete/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Orden cancelada y stock restaurado correctamente

❌ Errores

⚠️ 400 Bad Request – ID inválido

⚠️ 400 Bad Request – Estado de orden no cancelable

🔐 401 Unauthorized – Token ausente o inválido

🕳️ 404 Not Found – Orden no encontrada

❗ 409 Conflict – Fallo al restaurar el stock

💥 500 Internal Server Error – Falla inesperada