Top ventas por cliente

GET /api/common/ventas/clientes/topventas?numeroTop={numeroTop}&fechaDesde={fechaDesde}&fechaHasta={fechaHasta}&codigoCliente={codigoCliente}&codigoEmpresa={codigoEmpresa} V4

Descripción

Endpoint para obtener los artículos más vendidos de un cliente dentro de un rango de fechas especificado.

Permite indicar cuántos artículos se desean listar (por ejemplo, el Top 10) y filtrar por el cliente y las fechas del período a analizar.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
numeroTop	int	✅	Número máximo de artículos a devolver en el listado
fechaDesde	string	✅	Fecha inicial del período en formato YYYY-MM-DD
fechaHasta	string	✅	Fecha final del período en formato YYYY-MM-DD
codigoCliente	string	✅	Código del cliente del que se desean obtener los datos
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Ejemplo con filtros

# Obtener el Top 10 de artículos más vendidos de un cliente
curl -X GET "https://api.tandem.com/api/common/ventas/clientes/topventas?numeroTop=10&fechaDesde=2025-01-01&fechaHasta=2025-11-01&codigoCliente=000002&codigoEmpresa=9999" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Top 10 artículos encontrados exitosamente.",
  "totalArticulos": 10,
  "periodo": "01/01/2025 - 01/11/2025",
  "data": [
    {
      "codigoArticulo": "X0019",
      "descripcionArticulo": "Cable Transmisión",
      "unidades": 20
    },
    {
      "codigoArticulo": "0000000022",
      "descripcionArticulo": "CHAPA ACERO 3000X1500X6",
      "unidades": 17
    },
    {
      "codigoArticulo": "X0001",
      "descripcionArticulo": "Cámara Tubular Carretera",
      "unidades": 10
    },
    {
      "codigoArticulo": "X0008",
      "descripcionArticulo": "Llanta Aluminio Carretera",
      "unidades": 5
    },
    {
      "codigoArticulo": "COMENXPARTES",
      "descripcionArticulo": "Cuota Mensual - Ejemplo",
      "unidades": 2
    },
    {
      "codigoArticulo": "ECTA",
      "descripcionArticulo": "Entrega a cuenta albarán 2025/ZZENT/1",
      "unidades": 2
    },
    {
      "codigoArticulo": "ECTA",
      "descripcionArticulo": "Entrega a cuenta albarán 2025/ZZZ/2",
      "unidades": 1
    },
    {
      "codigoArticulo": "0000000101A",
      "descripcionArticulo": "DOLOMITE BIANCO 89X57.2",
      "unidades": 1
    },
    {
      "codigoArticulo": "0000000003",
      "descripcionArticulo": "CISTERNA 11.000 LITROS",
      "unidades": 0
    },
    {
      "codigoArticulo": "0000000002",
      "descripcionArticulo": "ARTÍCULO PARTE",
      "unidades": 0
    }
  ]
}