:id`

Actualiza el estado de una orden existente con validación de flujo de estados y autenticación.

📍 Ruta

PATCH /api/orders/update/state/:id

📝 Descripción

Este endpoint actualiza únicamente el campo status de una orden específica identificada por su _id.
Permite transiciones válidas entre los siguientes estados:

Pendiente

En proceso

Enviado

Cancelado

⚠️ Reglas de transición:

No se puede revertir una orden Enviado a Pendiente.

No se puede modificar una orden que ya esté en estado Cancelado.

🔐 Autenticación

Requiere token JWT válido.

Middleware aplicado:

verificarAutenticacion

validateUpdateOrderStatus

validateRequest

🔢 Parámetros

🛣️ Path Parameters

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

📥 Request Body

{
  "status": "En proceso"
}

📌 Valores permitidos: "Pendiente", "En proceso", "Enviado", "Cancelado"

✅ Respuestas

✔️ 200 OK – Estado actualizado exitosamente

{
  "status": "success",
  "code": "ORDER_STATUS_UPDATED",
  "msg": "Estado de la orden actualizado a 'En proceso'.",
  "data": {
    "_id": "ObjectId",
    "customer": 20406090,
    "products": [
      {
        "productId": "123",
        "quantity": 5
      }
    ],
    "discountApplied": 10,
    "netTotal": 90,
    "totalWithTax": 106.2,
    "status": "En proceso",
    "comment": "Actualizando estado",
    "registrationDate": "2025-04-24T14:00:00Z",
    "lastUpdate": "2025-04-24T16:00:00Z",
    "seller": "ObjectId"
  }
}

❌ Errores

⚠️ 400 Bad Request – ID o cuerpo inválido

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

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "El campo 'status' es requerido para actualizar el estado."
}

{
  "status": "error",
  "code": "INVALID_FORMAT",
  "msg": "Estado inválido: 'Procesando'. Los estados permitidos son: Pendiente, En proceso, Enviado, Cancelado."
}

❗ 400 Bad Request – Transición no permitida

{
  "status": "error",
  "code": "INVALID_OPERATION",
  "msg": "No se puede revertir una orden 'Enviado' a 'Pendiente'."
}

{
  "status": "error",
  "code": "INVALID_OPERATION",
  "msg": "No se puede cambiar el estado de una orden 'Cancelado'."
}

🔐 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": "No se encontró la orden con el id 663abc1234."
}

💥 500 Internal Server Error – Falla inesperada

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al actualizar el estado de la orden. Intente de nuevo más tarde.",
  "info": {
    "detail": "Excepción no capturada en controlador."
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Actualizar Estado de Orden

🔁 PATCH `/orders/update/state/:id`

📍 Ruta

📝 Descripción

⚠️ Reglas de transición:

🔐 Autenticación

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Estado actualizado exitosamente

❌ Errores

⚠️ 400 Bad Request – ID o cuerpo inválido

❗ 400 Bad Request – Transición no permitida

🔐 401 Unauthorized – Token ausente o inválido

🕳️ 404 Not Found – Orden no encontrada

💥 500 Internal Server Error – Falla inesperada

Request

Responses

Actualizar Estado de Orden

🔁 PATCH /orders/update/state/:id#

📍 Ruta#

📝 Descripción#

⚠️ Reglas de transición:#

🔐 Autenticación#

🔢 Parámetros#

🛣️ Path Parameters#

📥 Request Body#

✅ Respuestas#

✔️ 200 OK – Estado actualizado exitosamente#

❌ Errores#

⚠️ 400 Bad Request – ID o cuerpo inválido#

❗ 400 Bad Request – Transición no permitida#

🔐 401 Unauthorized – Token ausente o inválido#

🕳️ 404 Not Found – Orden no encontrada#

💥 500 Internal Server Error – Falla inesperada#

Request

Responses

🔁 PATCH `/orders/update/state/:id`

📍 Ruta

📝 Descripción

⚠️ Reglas de transición:

🔐 Autenticación

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Estado actualizado exitosamente

❌ Errores

⚠️ 400 Bad Request – ID o cuerpo inválido

❗ 400 Bad Request – Transición no permitida

🔐 401 Unauthorized – Token ausente o inválido

🕳️ 404 Not Found – Orden no encontrada

💥 500 Internal Server Error – Falla inesperada