Obtener estadísticas de artículos

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

Descripción

Endpoint para obtener estadísticas de artículos filtradas por ejercicio fiscal y opcionalmente por cliente, artículo, familia y subfamilia.

Permite analizar el rendimiento de ventas de artículos específicos en un periodo determinado, con desglose mensual de importes y unidades vendidas.

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
codigoArticulo	string	❌	Código del artículo para filtrar
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 artículo, incluyendo información del cliente, familia y subfamilia. Los valores negativos en importes o unidades indican devoluciones o notas de crédito.

Ejemplo con filtros

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

Respuesta exitosa (200)

{
  "message": "Estadísticas de artículos obtenidas exitosamente",
  "data": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "ejercicioAlbaran": 2025,
        "codigoCliente": "000001",
        "razonSocial": "AMAZON SPAIN",
        "codigoArticulo": "0000000004",
        "descripcionArticulo": "CERDO IBÉRICO BLANCO",
        "codigoFamilia": "CAR",
        "familia": "CARNICA",
        "codigoSubfamilia": "DESPIECE",
        "subfamilia": "DESPIECE",
        "importes": {
          "enero": 0,
          "febrero": 0,
          "marzo": 0,
          "abril": 0,
          "mayo": 0,
          "junio": 0,
          "julio": 0,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 13640.4,
          "noviembre": 18187.2,
          "diciembre": 0
        },
        "unidades": {
          "enero": 0,
          "febrero": 0,
          "marzo": 0,
          "abril": 0,
          "mayo": 0,
          "junio": 0,
          "julio": 0,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 9,
          "noviembre": 12,
          "diciembre": 0
        }
      },
      {
        "codigoEmpresa": 9999,
        "ejercicioAlbaran": 2025,
        "codigoCliente": "000001",
        "razonSocial": "AMAZON SPAIN",
        "codigoArticulo": "0000000006",
        "descripcionArticulo": "PRESA IBÉRICA",
        "codigoFamilia": "CAR",
        "familia": "CARNICA",
        "codigoSubfamilia": "DESPIECE",
        "subfamilia": "DESPIECE",
        "importes": {
          "enero": 0,
          "febrero": 0,
          "marzo": 1100,
          "abril": 0,
          "mayo": 0,
          "junio": -5.5,
          "julio": 57.5,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 50,
          "noviembre": 0,
          "diciembre": 0
        },
        "unidades": {
          "enero": 0,
          "febrero": 0,
          "marzo": 200,
          "abril": 0,
          "mayo": 0,
          "junio": -1,
          "julio": 10,
          "agosto": 0,
          "septiembre": 0,
          "octubre": 5,
          "noviembre": 0,
          "diciembre": 0
        }
      }
    ],
    "totalRecords": 140,
    "totalPages": 14,
    "currentPage": 1,
    "pageSize": 10
  }
}