📄 GET `/orders`

Obtiene una lista paginada de órdenes registradas, incluyendo detalles de cliente, vendedor y productos.

🔐 Requiere autenticación JWT.

📍 Ruta

GET /api/orders

📝 Descripción

Este endpoint devuelve una lista de órdenes, ordenadas por fecha de registro descendente. Incluye detalles completos del cliente, vendedor y productos. Se pueden controlar la paginación con parámetros page y limit.

🔒 Autenticación

Middleware: verificarAutenticacion

Header requerido: Authorization: Bearer <token>

🧱 Middleware Aplicado

verificarAutenticacion

validateGetAllOrders

validateRequest

🔍 Parámetros de Consulta (Query Parameters)

Parámetro	Tipo	Opcional	Default	Descripción
`page`	number	✅	1	Número de la página a obtener
`limit`	number	✅	10	Cantidad de órdenes por página

✅ Respuestas

200 OK – Órdenes obtenidas correctamente

{
  "status": "success",
  "code": "ORDERS_FETCHED",
  "msg": "Órdenes obtenidas para la página 1.",
  "data": [
    {
      "_id": "ObjectId",
      "customer": {
        "Ruc": 12345678901,
        "Name": "Nombre del Cliente"
      },
      "seller": {
        "_id": "ObjectId",
        "names": "Nombre del Vendedor"
      },
      "products": [
        {
          "productId": "101",
          "quantity": 5,
          "productDetails": {
            "id": 101,
            "product_name": "Producto A"
          }
        }
      ],
      "discountApplied": 10,
      "netTotal": 100,
      "totalWithTax": 118,
      "status": "Pendiente",
      "registrationDate": "2025-04-24T10:00:00Z",
      "lastUpdate": "2025-04-24T10:10:00Z",
      "comment": "Entrega urgente",
      "createdAt": "2025-04-24T10:00:00Z",
      "updatedAt": "2025-04-24T10:10:00Z"
    }
  ],
  "info": {
    "currentPage": 1,
    "totalPages": 5,
    "totalOrders": 50,
    "limit": 10
  }
}

200 OK – No se encontraron órdenes

{
  "status": "success",
  "code": "NO_ORDERS_FOUND",
  "msg": "No se encontraron órdenes registradas.",
  "data": [],
  "info": {
    "currentPage": 1,
    "totalPages": 0,
    "totalOrders": 0,
    "limit": 10
  }
}

❌ Errores

400 Bad Request – Parámetros de paginación inválidos

{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "El parámetro 'page' debe ser un número entero positivo."
}

401 Unauthorized – Token inválido o ausente

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

404 Not Found – Página fuera de rango

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "Página no encontrada. Solo hay 3 páginas."
}

500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al obtener las órdenes. Intente de nuevo más tarde.",
  "info": {
    "detail": "Error al conectar con la base de datos."
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Visualizar Ordenes

📄 GET `/orders`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🔍 Parámetros de Consulta (Query Parameters)

✅ Respuestas

200 OK – Órdenes obtenidas correctamente

200 OK – No se encontraron órdenes

❌ Errores

400 Bad Request – Parámetros de paginación inválidos

401 Unauthorized – Token inválido o ausente

404 Not Found – Página fuera de rango

500 Internal Server Error – Error inesperado

Request

Responses

Visualizar Ordenes

📄 GET /orders#

📍 Ruta#

📝 Descripción#

🔒 Autenticación#

🧱 Middleware Aplicado#

🔍 Parámetros de Consulta (Query Parameters)#

✅ Respuestas#

200 OK – Órdenes obtenidas correctamente#

200 OK – No se encontraron órdenes#

❌ Errores#

400 Bad Request – Parámetros de paginación inválidos#

401 Unauthorized – Token inválido o ausente#

404 Not Found – Página fuera de rango#

500 Internal Server Error – Error inesperado#

Request

Responses

📄 GET `/orders`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🔍 Parámetros de Consulta (Query Parameters)

✅ Respuestas

200 OK – Órdenes obtenidas correctamente

200 OK – No se encontraron órdenes

❌ Errores

400 Bad Request – Parámetros de paginación inválidos

401 Unauthorized – Token inválido o ausente

404 Not Found – Página fuera de rango

500 Internal Server Error – Error inesperado