---
title: "Consultar las ventas agrupadas por categorías"
method: GET
path: "/reports/reportSalesByCategory"
tags: ["Reportes"]
---

# Consultar las ventas agrupadas por categorías

`GET /reports/reportSalesByCategory`

## Request

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

Genera un reporte agregado de ventas organizadas por categorías de productos 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:**
- Agrupa ventas por categorías de productos
- Calcula totales brutos, descuentos e impuestos por categoría
- Incluye desglose detallado de impuestos por tipo
- Solo incluye facturas en estado "Pagada"
- Excluye facturas eliminadas
- Resultados ordenados alfabéticamente por nombre de categoría

**Métricas incluidas:**
- Total bruto por categoría
- Total de descuentos aplicados
- Total de impuestos por tipo
- Total neto final
- Desglose detallado de cada impuesto

**Casos de uso:**
- Análisis de performance por categoría de producto
- Identificación de categorías más rentables
- Reportes de impuestos por categoría
- Análisis de tendencias de venta por tipo de producto
- Toma de decisiones sobre mix de productos
## Ejemplos de uso:

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

### 2. Reporte de categorías del mes actual
Analizar performance de categorías en el mes de agosto:
```
GET /reports/reportSalesByCategory?dateInitISO=2025-08-01T00:00:00.000Z&dateEndISO=2025-08-31T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 3. Reporte de categorías de la última semana
Análisis semanal de performance por categoría:
```
GET /reports/reportSalesByCategory?dateInitISO=2025-07-30T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 4. Reporte de categorías del día actual
Análisis diario de ventas por categoría:
```
GET /reports/reportSalesByCategory?dateInitISO=2025-08-06T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 5. Análisis trimestral por categorías
Reporte consolidado de tres meses para análisis de tendencias:
```
GET /reports/reportSalesByCategory?dateInitISO=2025-05-01T00:00:00.000Z&dateEndISO=2025-08-06T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

### 6. Reporte de categorías para período específico de negocio
Análisis de fin de semana (viernes a domingo) para categorías de productos:
```
GET /reports/reportSalesByCategory?dateInitISO=2025-08-02T00:00:00.000Z&dateEndISO=2025-08-04T23:59:59.999Z
Authorization: Bearer tu_token_aqui
```

## Query parameters

- `dateInitISO` string, date-time, required
- `dateEndISO` string, date-time, required

## Response `200`

Reporte de ventas por categorías generado exitosamente

- object
  - `reportByCategory` object[]
    - `_id` object
      - `_id` string: ID de la categoría
      - `name` string: Nombre de la categoría
    - `totalBruto` number: Total bruto de ventas de la categoría
    - `totalDiscount` number: Total de descuentos aplicados
    - `totalTaxes` number: Total de impuestos
    - `totalBaseTax` number: Base gravable total
    - `total` number: Total neto final de la categoría
    - `taxes` object[]: Desglose de impuestos por tipo
      - `tax` string: ID del impuesto
      - `taxName` string: Nombre del impuesto
      - `totalTax` number: Total del impuesto específico

## Other responses

- `401`: Token de autorización inválido o faltante
- `402`: Suscripción premium requerida
- `403`: Sin permisos para ver reportes por categorías
- `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)