---
title: "Consultar las ventas detallado por productos"
method: GET
path: "/reports/reportSalesByProduct"
tags: ["Reportes"]
---

# Consultar las ventas detallado por productos

`GET /reports/reportSalesByProduct`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/reports/reportSalesByProduct`
- Auth: HTTP bearer

Genera un reporte detallado de ventas organizadas por productos individuales en un período específico.

**Autenticación requerida:** Este endpoint requiere autenticación Bearer Token.
Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header:
`Authorization: Bearer {tokenCurrent}`

**Suscripción Premium requerida:** Este endpoint requiere una suscripción premium activa.

**Características del reporte:**
- Desglose detallado por producto individual
- Información de cantidades vendidas y precios
- Datos financieros completos (bruto, descuentos, impuestos, total)
- Información de vendedores y cajeros
- Datos de facturación y métodos de pago
- Información de entrega a domicilio cuando aplique
- Cálculo de costos promedio y promociones aplicadas

**Opciones de agrupación:**
- Vista detallada: Cada línea de producto por factura
- Vista agrupada: Totales consolidados por producto (usar groupResult=true)

**Casos de uso:**
- Análisis de performance de productos específicos
- Seguimiento de vendedores por producto
- Control de inventario basado en ventas
- Análisis de rentabilidad por producto
- Reportes de comisiones por vendedor
- Optimización de mix de productos
## Ejemplos de uso:

### 1. Reporte básico de productos con parámetros requeridos
Ejemplo mínimo funcional con solo los parámetros obligatorios:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 2. Reporte detallado de productos del mes
Vista línea por línea de todas las ventas de productos en agosto:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z&status=Pagada
Authorization: Bearer tu_token_aqui
```

### 3. Reporte consolidado por productos
Vista agrupada con totales por producto para análisis de performance:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&groupResult=true
Authorization: Bearer tu_token_aqui
```

### 4. Análisis de productos con combos incluidos
Reporte incluyendo productos que forman parte de combos:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-06T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&showProductCombo=true
Authorization: Bearer tu_token_aqui
```

### 5. Reporte de productos por vendedor
Análisis detallado para evaluación de comisiones y performance:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&status=Pagada
Authorization: Bearer tu_token_aqui
```

### 6. Análisis multi-negocio
Reporte consolidado de productos para usuarios con múltiples negocios:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z&allBusiness=true&groupResult=true
Authorization: Bearer tu_token_aqui
```

### 7. Reporte de productos del día para análisis rápido
Vista diaria consolidada para revisión rápida de performance:
```
GET /reports/reportSalesByProduct?dateInitISO=2025-08-22T00:00:00.000Z&dateEndISO=2025-08-22T23:59:59.999Z&groupResult=true&status=Pagada
Authorization: Bearer tu_token_aqui
```

## Query parameters

- `dateInitISO` string, date-time, required
- `dateEndISO` string, date-time, required
- `status` 'Pagada' | 'Facturada'
- `groupResult` boolean
- `showProductCombo` boolean
- `allBusiness` boolean

## Response `200`

Reporte de ventas por productos generado exitosamente

- object
  - `reportByProduct` object[]
    - `_id` object: Información detallada del producto y venta
      - `_id` string: ID del producto en la factura
      - `business` object: Información del negocio
        - `name` string
      - `client` object: Información del cliente
      - `seller` string: Nombre del vendedor
      - `cashier` string: Nombre del cajero
      - `categoryName` string: Nombre de la categoría
      - `code` string: Código del producto
      - `name` string: Nombre del producto
      - `number` string: Número de factura
      - `table` string: Nombre de la mesa
      - `quantity` number: Cantidad vendida
      - `priceNormal` number: Precio normal unitario
      - `avgCost` number: Costo promedio unitario
      - `deliveryProviderName` string: Proveedor de entrega si aplica
    - `mainSeller` string: Vendedor principal de la factura
    - `totalBruto` number: Total bruto del producto
    - `totalDiscount` number: Total de descuentos aplicados
    - `totalTaxes` number: Total de impuestos
    - `totalBaseTax` number: Base gravable
    - `total` number: Total final del producto

## Other responses

- `401`: Token de autorización inválido o faltante
- `402`: Suscripción premium requerida
- `403`: Sin permisos para ver reportes por productos
- `500`: Error interno del servidor

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)