Reportes del negocio
POST
Reporte de ventas por producto
POST /api/reports/list-product-sales
Descripción
Devuelve el listado paginado de ventas agregadas por producto en un rango de fechas, con totales del período y categorías para filtrar.
Detalles
Agrupa las ventas confirmadas por producto dentro del rango de fechas consultado y entrega unidades, órdenes e ingresos de cada uno, junto con los totales del período y las categorías disponibles para filtrar. Las cortesías no suman ingreso. Permite acotar por categoría y por búsqueda de nombre o código.
Permisos requeridos
reports.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| dateFrom | string | No |
max:30
|
| dateTo | string | No |
max:30
|
| categoryId | int | No |
min_value:1
|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 10 |
| maxLimit | 200 |
| allowedSorts | productName, units, orders, netRevenueCents, totalCents |
| defaultSort | netRevenueCents |
| defaultDir | desc |
| withTotal | true |
Ejemplo de request
curl -X POST https://restofy.pro/api/reports/list-product-sales \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.