:id`

Actualiza los detalles de una orden existente con validación de stock y control de consistencia.

📍 Ruta

PATCH /api/orders/update/:id

📝 Descripción

Actualiza los datos de una orden existente identificada por su _id. Solo se permite modificar órdenes con estado 'Pendiente'.
El endpoint:

Permite cambiar los productos y cantidades.

Recalcula descuentos y totales.

Ajusta el stock de productos de forma atómica.

Realiza reversión de stock si ocurre un error.

🔐 Autenticación

Requiere token JWT válido.

Middleware aplicado:

verificarAutenticacion

validateUpdateOrder

validateRequest

🔢 Parámetros

🛣️ Path Parameters

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

📥 Request Body

{
  "products": [
    {
      "productId": "123",      // ID del producto (string de número)
      "quantity": 5            // cantidad > 0
    }
  ],
  "discountApplied": 10,
  "netTotal": 90,
  "totalWithTax": 106.2,
  "comment": "Actualizar por cambio de cantidad"
}

✅ Respuestas

✔️ 200 OK – Orden actualizada correctamente

{
  "status": "success",
  "code": "ORDER_UPDATED",
  "msg": "Orden actualizada con éxito.",
  "data": {
    "_id": "ObjectId",
    "customer": 20406090,
    "products": [
      {
        "productId": "123",
        "quantity": 5
      }
    ],
    "discountApplied": 10,
    "netTotal": 90,
    "totalWithTax": 106.2,
    "status": "Pendiente",
    "comment": "Actualizar por cambio de cantidad",
    "registrationDate": "2025-04-24T14:00:00Z",
    "lastUpdate": "2025-04-24T15:00:00Z",
    "seller": "ObjectId"
  },
  "info": {
    "stockUpdateDetails": {
      "attempted": 2,
      "modified": 2,
      "status": "Éxito",
      "message": "Stock ajustado correctamente."
    }
  }
}

❌ Errores

⚠️ 400 Bad Request – Datos inválidos

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "Campos requeridos: products (array), discountApplied, netTotal, totalWithTax."
}

{
  "status": "error",
  "code": "INVALID_OPERATION",
  "msg": "La orden con estado 'Enviado' no puede ser actualizada."
}

{
  "status": "error",
  "code": "INSUFFICIENT_STOCK",
  "msg": "Stock insuficiente para el producto 123. Stock actual: 2, se intentarían quitar 5 unidades adicionales."
}

🔐 401 Unauthorized – Token inválido o ausente

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

🕳️ 404 Not Found – Orden o producto no existe

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

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "Producto con ID 123 no encontrado en la base de datos."
}

⚔️ 409 Conflict – Error al ajustar stock

{
  "status": "error",
  "code": "STOCK_CONFLICT",
  "msg": "Conflicto al ajustar stock: Se intentaron 3 ajustes, pero solo 2 se completaron. Cambios revertidos.",
  "info": {
    "attempted": 3,
    "modified": 2,
    "status": "Conflicto",
    "message": "Fallo parcial en stock.",
    "reversion": "Reversión completada con éxito."
  }
}

💥 500 Internal Server Error – Falla inesperada

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al actualizar la orden. Intente de nuevo más tarde.",
  "info": {
    "detail": "Referencia circular detectada.",
    "reversionStatus": "Reversión completada parcialmente. Verificar integridad manualmente."
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Actualizar Orden

🔄 PATCH `/orders/update/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Orden actualizada correctamente

❌ Errores

⚠️ 400 Bad Request – Datos inválidos

🔐 401 Unauthorized – Token inválido o ausente

🕳️ 404 Not Found – Orden o producto no existe

⚔️ 409 Conflict – Error al ajustar stock

💥 500 Internal Server Error – Falla inesperada

Request

Responses

Actualizar Orden

🔄 PATCH /orders/update/:id#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🔢 Parámetros#

🛣️ Path Parameters#

📥 Request Body#

✅ Respuestas#

✔️ 200 OK – Orden actualizada correctamente#

❌ Errores#

⚠️ 400 Bad Request – Datos inválidos#

🔐 401 Unauthorized – Token inválido o ausente#

🕳️ 404 Not Found – Orden o producto no existe#

⚔️ 409 Conflict – Error al ajustar stock#

💥 500 Internal Server Error – Falla inesperada#

Request

Responses

🔄 PATCH `/orders/update/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Orden actualizada correctamente

❌ Errores

⚠️ 400 Bad Request – Datos inválidos

🔐 401 Unauthorized – Token inválido o ausente

🕳️ 404 Not Found – Orden o producto no existe

⚔️ 409 Conflict – Error al ajustar stock

💥 500 Internal Server Error – Falla inesperada