Listar motivos de pérdida

GET https://api.afer.pro/api/v1/crm/loss-reasons

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

Los motivos de pérdida de tu CRM y, opcionalmente, cuánto se usa cada uno en un funnel concreto.

El catálogo de motivos con los que se cierra una oportunidad perdida. Los motivoId cifrados son los que espera cerrarOportunidad.

El catálogo es por cuenta (los mismos motivos sirven en todos los embudos). Si envías funnel_fk, cada motivo llega además con su uso en ese funnel — oportunidades perdidas e importe — y se añade el bloque sin_motivo con las pérdidas sin motivo asignado.

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_fkstring|int

opcional

Funnel del que medir el uso de cada motivo: el funnelId cifrado de listarFunnels o el numérico legacy. Sin él, solo se devuelve el catálogo.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/crm/loss-reasons?funnel_fk=aBc123XyZ%E2%80%A6' \
  -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/loss-reasons?funnel_fk=aBc123XyZ%E2%80%A6');
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/loss-reasons?funnel_fk=aBc123XyZ%E2%80%A6', {
  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": {
        "motivos": [
            {
                "motivoId": "dEf456…",
                "motivo": "Precio",
                "uso_funnel": {
                    "perdidas": 14,
                    "valor": 46000
                }
            },
            {
                "motivoId": "gHi789…",
                "motivo": "Sin presupuesto",
                "uso_funnel": {
                    "perdidas": 3,
                    "valor": 8200
                }
            }
        ],
        "funnel": {
            "funnelId": "aBc123XyZ…",
            "funnel": "Ventas web"
        },
        "sin_motivo": {
            "perdidas": 5,
            "valor": 11000
        }
    }
}

Errores

Caso	Resultado
Sin credenciales de API key	`errorCode` 401.
`funnel_fk` no existe en tu cuenta	`errorCode` 404.