Obtener estadísticas de familias

GET /api/common/estadisticas/familias?page={page}&pageSize={pageSize}&ejercicio={ejercicio} V4

Descripción

Endpoint para obtener estadísticas de marcas y familias filtradas por ejercicio fiscal y opcionalmente por cliente, familia y subfamilia.

Permite analizar el rendimiento de las familias de productos en un período específico.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
page	int	✅	Número de página
pageSize	int	✅	Cantidad de elementos por página
ejercicio	int	✅	Año del ejercicio fiscal
codigoCliente	string	❌	Código del cliente para filtrar las estadísticas
codigoFamilia	string	❌	Código de la familia para filtrar
codigoSubfamilia	string	❌	Código de la subfamilia para filtrar
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Note

Las estadísticas devuelven los importes y unidades vendidas desglosados por mes para cada combinación de cliente, familia y subfamilia. Si codigoSubfamilia y subfamilia están vacíos, significa que son datos generales de la familia sin subfamilia.

Ejemplo con filtros

# Obtener estadísticas de familias del ejercicio 2025
curl -X GET "https://api.tandem.com/api/common/estadisticas/familias?page=1&pageSize=10&ejercicio=2025&codigoEmpresa=9999" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "message": "Estadísticas de marcas y familias obtenidas exitosamente",
  "data": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "ejercicioAlbaran": 2025,
        "codigoCliente": "000001",
        "razonSocial": "AMAZON SPAIN",
        "codigoFamilia": "Acabados",
        "familia": "Materiales acabados",
        "codigoSubfamilia": "",
        "subfamilia": "",
        "importes": {
          "enero": 0,
          "febrero": 0,
          "marzo": 2500,
          "abril": 0,
          "mayo": 2500,
          "junio": 0,
          "julio": 0,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 0,
          "noviembre": 0,
          "diciembre": 0
        },
        "unidades": {
          "enero": 0,
          "febrero": 0,
          "marzo": 100,
          "abril": 0,
          "mayo": 100,
          "junio": 0,
          "julio": 0,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 0,
          "noviembre": 0,
          "diciembre": 0
        }
      },
      {
        "codigoEmpresa": 9999,
        "ejercicioAlbaran": 2025,
        "codigoCliente": "000001",
        "razonSocial": "AMAZON SPAIN",
        "codigoFamilia": "Accesorios",
        "familia": "Accesorios",
        "codigoSubfamilia": "Carretera",
        "subfamilia": "Accesorios carretera",
        "importes": {
          "enero": 0,
          "febrero": 0,
          "marzo": 0,
          "abril": 40,
          "mayo": 80,
          "junio": 0,
          "julio": 0,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 0,
          "noviembre": 0,
          "diciembre": 0
        },
        "unidades": {
          "enero": 0,
          "febrero": 0,
          "marzo": 0,
          "abril": 5,
          "mayo": 10,
          "junio": 0,
          "julio": 0,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 0,
          "noviembre": 0,
          "diciembre": 0
        }
      }
    ],
    "totalRecords": 87,
    "totalPages": 9,
    "currentPage": 1,
    "pageSize": 10
  }
}