Pipeline del CRM

GET https://api.afer.pro/api/v1/crm/opportunities

Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarOportunidades

Las oportunidades abiertas por funnel y etapa (número y valor) y, con un rango de fechas, las creadas, ganadas y perdidas con su win rate.

El embudo comercial para el panel: cuántas oportunidades hay abiertas (ni ganadas ni perdidas) y qué valor suman, desglosado por funnel y etapa.

Si envías fecha_inicio y fecha_fin, añade la actividad del período: oportunidades creadas (por fecha de creación) y ganadas/perdidas (por fecha de cierre), con el win_rate_pct = ganadas / cerradas.

Autenticación

Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →

Este endpoint requiere autenticación con API key: sin credenciales responde 401.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

`funnel_fk`string\|int opcional	Limita la consulta a un funnel: acepta el `funnelId` cifrado de listarFunnels o el numérico legacy.
`fecha_inicio`date opcional	Con `fecha_fin`, añade las estadísticas del período.
`fecha_fin`date opcional	Fin del período (`YYYY-MM-DD`), incluido.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/crm/opportunities?fecha_inicio=2026-08-01&fecha_fin=2026-08-18' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET'

<?php

$ch = curl_init('https://api.afer.pro/api/v1/crm/opportunities?fecha_inicio=2026-08-01&fecha_fin=2026-08-18');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: afer_tk_TU_TOKEN',
    'X-API-SECRET: afer_sk_TU_SECRET',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);

const respuesta = await fetch('https://api.afer.pro/api/v1/crm/opportunities?fecha_inicio=2026-08-01&fecha_fin=2026-08-18', {
  method: 'GET',
  headers: {
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  }
});

const resultado = await respuesta.json();

Respuesta

200 · application/json

{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "abiertas": {
            "num": 12,
            "valor": 86000
        },
        "pipeline": [
            {
                "funnelId": "aBc123XyZ…",
                "funnel": "Ventas web",
                "num": 12,
                "valor": 86000,
                "por_etapa": [
                    {
                        "etapaId": "dEf456…",
                        "etapa": "Contactado",
                        "num": 8,
                        "valor": 36000
                    },
                    {
                        "etapaId": "gHi789…",
                        "etapa": "Propuesta enviada",
                        "num": 4,
                        "valor": 50000
                    }
                ]
            }
        ],
        "periodo": {
            "fecha_inicio": "2026-08-01",
            "fecha_fin": "2026-08-18",
            "creadas": {
                "num": 10,
                "valor": 20000
            },
            "ganadas": {
                "num": 3,
                "valor": 12500
            },
            "perdidas": {
                "num": 1,
                "valor": 4000
            },
            "win_rate_pct": 75
        }
    }
}

Notas

El valor de cada oportunidad es su valor de cierre configurado en el CRM; las oportunidades sin valor cuentan como 0.
win_rate_pct llega null si no se cerró ninguna oportunidad en el período.