Consultar las ventas detallado por productos

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