Prima-Back
  1. Estadisticas
Prima-Back
  • API DOCUMENTATION
  • Principal
    • /
      GET
  • Modulo Administradores
    • Vendedores Operaciones
      • Registro de Vendedores
      • Visualizar Vendedores
      • Visualizar Vendedores por Mongo ID
      • Visualizar Vendedores por cedula
      • Actualizar Vendedor
      • Eliminar Vendedor
    • Estadisticas
      • Estadisticas de documentos
        GET
      • Visualizacion de top Vendedores
        GET
      • Visualizar Ventas por Vendedor
        GET
    • Login Administradores
      POST
    • Recuperacion de contraseña Administrador
      POST
  • Modulo Vendedores
    • Inicio de Sesión Vendedores
      POST
    • Confirmación de Cuenta
      GET
    • Solicitud de restablecimiento de contraseña
      POST
    • Restablecimiento de contraseña
      POST
  • Modulo Clientes
    • Registrar Cliente
      POST
    • Visualizar Clientes
      GET
    • Visualizar Clientes por RUC
      GET
    • Actualizar Cliente
      PATCH
    • Eliminar Cliente
      DELETE
  • Modulo Productos
    • Crear Producto
      POST
    • Visualizar Productos
      GET
    • Visualizar Productos por ID
      GET
    • Actualizar Producto
      PATCH
    • Eliminar Producto
      DELETE
  • Modulo Pedidos
    • Crear Orden
      POST
    • Visualizar Ordenes
      GET
    • Visualizar Ordenes por ID
      GET
    • Actualizar Orden
      PATCH
    • Actualizar Estado de Orden
      PATCH
    • Eliminar Orden
      DELETE
  1. Estadisticas

Visualizar Ventas por Vendedor

GET
/api/statics/sales-by-seller

📊 GET /statics/sales-by-seller#

Obtiene el monto total de ventas (totalWithTax) para cada vendedor que tenga al menos una orden registrada, ordenado de menor a mayor.

📍 Ruta#

GET /api/statics/sales-by-seller

📝 Descripción#

Devuelve dos arrays:
names: nombres de los vendedores.
totalSales: montos de ventas totales (con impuestos incluidos).
Ambos están ordenados por el monto de ventas, de menor a mayor.

🔐 Autenticación#

✅ Requiere autenticación.
Token JWT en cabecera:
Authorization: Bearer <token>
Middleware: verificarAutenticacion

📦 Request Body#

❌ No se requiere body.

✅ Respuestas#

✔️ 200 OK – Ventas totales por vendedor obtenidas#

{
  "status": "success",
  "code": "SALES_BY_SELLER_RETRIEVED",
  "msg": "Ventas totales por vendedor obtenidas exitosamente.",
  "data": {
    "names": [
      "Nombre Vendedor C",
      "Nombre Vendedor A",
      "Nombre Vendedor B"
    ],
    "totalSales": [
      1500.75,
      3250.50,
      5100.00
    ]
  }
}

❌ Errores#

🔒 401 Unauthorized – Token inválido o ausente#

{
  "status": "error",
  "code": "UNAUTHORIZED",
  "msg": "Acceso no autorizado. Se requiere token de autenticación válido."
}

💥 500 Internal Server Error – Error inesperado#

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al obtener las ventas por vendedor. Intente de nuevo más tarde."
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://back-prima-s-a.onrender.com/api/statics/sales-by-seller' \
--header 'User-Agent: insomnia/10.3.0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE'
Response Response Example
{}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
User-Agent
string 
optional
Example:
insomnia/10.3.0
Authorization
string 
optional
Example:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE

Responses

🟢200Success
application/json
Body
object {0}
Modified at 2025-06-14 22:38:20
Previous
Visualizacion de top Vendedores
Next
Login Administradores
Built with