get https://api.pirpos.com/reports/reportSalesByCategory
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