:id`

Consulta los detalles completos de una orden específica.

📍 Ruta

GET /api/orders/:id

📝 Descripción

Obtiene la información detallada de una orden a partir de su _id de MongoDB. La respuesta incluye:

Información del cliente (por RUC)

Información del vendedor (por _id)

Productos solicitados (por ID numérico)

Totales, estado, fechas y comentarios

Incluye valores de fallback cuando alguno de los elementos relacionados no se encuentra.

🔐 Autenticación

Requiere un token JWT válido.

Middleware:

verificarAutenticacion

⚙️ Middleware Aplicado

verificarAutenticacion

validateGetOrderById

validateRequest

🔢 Parámetros

🛣️ Path Parameters

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

📤 Request Body

Ninguno.

✅ Respuestas

✔️ 200 OK – Orden encontrada

{
  "status": "success",
  "code": "ORDER_DETAILS_FETCHED",
  "msg": "Detalles de la orden obtenidos correctamente.",
  "data": {
    "_id": "ObjectId",
    "customer": {
      "Ruc": 12345678901,
      "Name": "Cliente Ejemplo"
    },
    "seller": {
      "_id": "ObjectId",
      "names": "Vendedor Ejemplo"
    },
    "products": [
      {
        "productId": "abc123",
        "quantity": 2,
        "productDetails": {
          "id": 101,
          "product_name": "Producto A"
        }
      }
    ],
    "discountApplied": 10,
    "netTotal": 200,
    "totalWithTax": 236,
    "status": "Pendiente",
    "registrationDate": "2025-04-24T14:00:00Z",
    "lastUpdate": "2025-04-24T14:30:00Z",
    "comment": "Cliente requiere factura.",
    "createdAt": "2025-04-24T14:00:00Z",
    "updatedAt": "2025-04-24T14:30:00Z"
  }
}

❌ Errores

⚠️ 400 Bad Request – ID inválido

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

🔐 401 Unauthorized – Token no válido o ausente

{
  "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 663120abc1234 no encontrada."
}

💥 500 Internal Server Error

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al obtener los detalles de la orden. Intente de nuevo más tarde.",
  "info": {
    "detail": "Referencia circular al obtener productos."
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Visualizar Ordenes por ID

📦 GET `/orders/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

⚙️ Middleware Aplicado

🔢 Parámetros

🛣️ Path Parameters

📤 Request Body

✅ Respuestas

✔️ 200 OK – Orden encontrada

❌ Errores

⚠️ 400 Bad Request – ID inválido

🔐 401 Unauthorized – Token no válido o ausente

📭 404 Not Found – Orden no encontrada

💥 500 Internal Server Error

Request

Responses

Visualizar Ordenes por ID

📦 GET /orders/:id#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

⚙️ Middleware Aplicado#

🔢 Parámetros#

🛣️ Path Parameters#

📤 Request Body#

✅ Respuestas#

✔️ 200 OK – Orden encontrada#

❌ Errores#

⚠️ 400 Bad Request – ID inválido#

🔐 401 Unauthorized – Token no válido o ausente#

📭 404 Not Found – Orden no encontrada#

💥 500 Internal Server Error#

Request

Responses

📦 GET `/orders/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

⚙️ Middleware Aplicado

🔢 Parámetros

🛣️ Path Parameters

📤 Request Body

✅ Respuestas

✔️ 200 OK – Orden encontrada

❌ Errores

⚠️ 400 Bad Request – ID inválido

🔐 401 Unauthorized – Token no válido o ausente

📭 404 Not Found – Orden no encontrada

💥 500 Internal Server Error