Affiliate Cloud Cómo funciona

Por qué se rechaza el lead de un afiliado

Las comprobaciones por las que pasa cada lead que envía un afiliado, en orden, con el código que recibe en cada una, y dónde mirar cuando dice que sus leads se rechazan.

Actualizado el 15 de octubre de 2026

En esta página

Para qué sirve
Quién puede usarlo
Las comprobaciones, en orden
Dónde mirarlo
Lo que conviene saber
Errores frecuentes

En resumen

Cada lead que envía un afiliado pasa, en este orden, por sus datos básicos, la elección de campaña, el duplicado y la entrega al anunciante.
Mientras no se guarda, un rechazo no deja rastro en ninguna pantalla: sólo lo recibe el afiliado, en la respuesta de la API.
El lead se guarda cuando se va a entregar. Desde ahí sale en el Directorio de Leads, con el resultado y el detalle de la entrega.
Cada rechazo lleva un code estable. Pídeselo al afiliado: dice en qué paso se quedó.

Para qué sirve

Para saber qué mirar cuando un afiliado dice que sus leads se rechazan, o cuando no ves en el Directorio un lead que dice haber enviado. El lado del programador, con la respuesta completa de la API, está en API de leads: mensajes y códigos de error.

Quién puede usarlo

Para ver los leads guardados necesitas Visualizar en la fila Directorio de Leads (Logs) de Affiliate Cloud, en tu panel de permisos; para revisar las asignaciones de una campaña, Visualizar en Campañas. La entrada Directorio Leads del menú sólo la ve un administrador; con el permiso, entra desde aquí: Directorio de Leads.

Las comprobaciones, en orden

La API responde siempre con HTTP 200, se acepte o se rechace el lead, salvo dos casos: un cuerpo que no es JSON o que no trae ningún dato (HTTP 400, invalid_json) y un fallo interno (HTTP 500, internal_error). En un rechazo, status vale error, el message va en inglés y, si el fallo es de un campo, field dice cuál.

1. Los datos básicos

Son iguales en todas las campañas y se comprueban en este orden. El primero que falla es el que recibe el afiliado.

#	Qué se comprueba	`code`	`field`
1	Que llegue un correo válido	`missing_field` o `invalid_field`	`email_lead`
2	Que llegue el token del afiliado	`unknown_affiliate`	—
3	La fecha de nacimiento, si llega: una fecha real en `AAAA-MM-DD`	`invalid_field`	`birthdate_lead`
4	El género, si llega: `M` o `F`	`invalid_field`	`gender_lead`
5	Que llegue el país, con 2 caracteres	`missing_field` o `invalid_field`	`country_lead`
6	Que llegue una IP válida	`missing_field` o `invalid_field`	`ip_lead`
7	Que llegue una fuente (`id_source`) que exista	`missing_field` o `invalid_field`	`id_source`
8	Que el correo o su dominio no estén en la lista negra	`blacklisted`	—
9	Que el token sea de un afiliado	`unknown_affiliate`	—

El estado del afiliado no se mira: uno Pendiente o Rechazado/Baneado sigue enviando mientras tenga asignaciones activas.

2. La campaña

Entre las asignaciones del afiliado sirven las que están activas, de una campaña activa, que no han llegado a su Cap Total, de la misma fuente que el lead y del mismo país. Si el lead trae id_campaign, sólo sirve esa campaña, y entonces el país no se compara.

Las asignaciones que se crean en la pantalla Asignaciones llevan la fuente 1: el afiliado tiene que mandar id_source 1.

Las que sirven se prueban en orden al azar. En cada una: si está fuera de su horario de recepción, se salta; si el lead no cumple sus requisitos, se salta; si tiene Cap Diario y ya está lleno, se salta. El lead va a la primera que pasa las tres. Cómo cuentan los topes: Cómo funcionan los topes y el reparto entre campañas.

Si no pasa ninguna, el afiliado recibe:

el primer rechazo por requisitos (missing_field o invalid_field, con field), si lo hubo: Requisitos del lead de una campaña: qué se exige y qué se rechaza;
si no, y todas estaban fuera de horario, outside_schedule, con opens_at, la próxima apertura: Horario de recepción de una campaña;
en cualquier otro caso, no_campaign_available.

3. El duplicado

Con la campaña elegida, se busca en ella un lead guardado con el mismo correo o el mismo teléfono. Si lo hay, el afiliado recibe duplicate. No se prueba otra campaña, aunque otra lo hubiera aceptado. Cuándo cuenta como duplicado lo decide la campaña: Requisitos del lead de una campaña: qué se exige y qué se rechaza.

Hasta aquí no se guarda el lead ni se gasta ningún tope.

4. La entrega

Ahora el lead se guarda y se entrega al anunciante. Desde este momento sale en el Directorio de Leads.

Resultado	Qué recibe el afiliado	`code`	Qué ves en el inspector
El anunciante lo acepta	`status` `success` y `Lead successfully registered.`	—	La respuesta del anunciante
El anunciante lo rechaza	`Lead rejected by the advertiser.`, a veces con su motivo	`rejected_by_advertiser`	La respuesta del anunciante
Falta algo en la configuración de la campaña o en su autenticación OAuth2, o, en una campaña con OAuth2, el anunciante no responde	`This campaign is not ready to receive leads yet. Please contact your account manager.`	`campaign_not_ready`	Un motivo que empieza por un código entre corchetes, como `[configuracion]`, `[auth_config]`, `[entorno_pruebas]`, `[token_red]`, `[conexion]`, `[timeout]` o `[401]`
El anunciante no responde, en una campaña sin OAuth2, o falla el envío por correo	`The advertiser could not be reached. The lead has not been delivered.`	`advertiser_unreachable`	Un motivo que empieza por `[red]` o `[smtp]`

Cuándo se da por aceptado lo explica Cómo se decide si el anunciante aceptó el lead (Mapeo de Respuestas). Sólo una venta aceptada cuenta en los topes de la asignación.

Dónde mirarlo

En Directorio de Leads, la columna API Status ② dice si la entrega fue bien (success) o no (error). El filtro de estados ① tiene Rechazados (Error). La pantalla abre con el mes en curso: amplía Desde: si buscas algo anterior.

Directorio de Leads filtrado por el estado «Rechazados (Error)» (1): las primeras filas, con su afiliado y anunciante, la campaña, el correo y el nombre con asteriscos y, en la columna «API Status» (2), «error».

El botón Log de cada fila abre el inspector: Payload Enviado (Request) ③ es lo que se mandó al anunciante y Respuesta del Cliente (Response) ④, lo que respondió o el motivo del fallo. Los datos personales salen con asteriscos: Por qué los datos personales de los leads salen con asteriscos.

Inspector de la entrega de un lead que no llegó al anunciante: arriba el resultado ERROR y la hora; lo enviado, con el nombre, el teléfono, el correo y la IP con asteriscos (3), y la respuesta, con el motivo que empieza por «[red]» (4).

Un rechazo de los pasos 1 a 3 no está en el Directorio ni en ninguna otra pantalla. Para saber qué pasó, pídele al afiliado el code y el field que recibió.

Lo que conviene saber

El motivo de requisitos puede cambiar de un intento a otro: con varias campañas, el orden es al azar y el afiliado recibe el primer rechazo.
Una entrega que falla no se repite. Si la entrega falla, el lead queda guardado, y reenviarlo a la misma campaña suele dar duplicate. La guía del afiliado le pide que no lo reenvíe y que contacte con su gestor.
Una venta anulada en el Directorio sigue contando como duplicado y en el Cap Total.
No se comprueba que la IP sea del país del lead.
Los Canales de Tráfico Permitidos de la campaña son informativos: no rechazan ningún lead.
La lista negra no se ve ni se cambia desde ninguna pantalla.

Errores frecuentes

Lo que ves	Qué significa	Qué hacer
El afiliado recibe `no_campaign_available`	Ninguna asignación sirve: inactiva, campaña pausada, Cap Total o Cap Diario alcanzados, otro país, otra fuente o un `id_campaign` que no tiene asignado	Revisa sus asignaciones en la campaña y que mande `id_source` `1`
El afiliado recibe `unknown_affiliate`	Falta el token o no es de ningún afiliado de la red	Comprueba el token en su guía (API Manual)
El afiliado recibe `outside_schedule`	La campaña está fuera de su horario de recepción	Que lo reenvíe a partir de `opens_at`
El afiliado recibe `duplicate`	Esa campaña ya tiene un lead con ese correo o ese teléfono	Ese contacto no entra en esa campaña
El afiliado recibe `campaign_not_ready`	La campaña no puede entregar	Abre el Log del lead y revisa la pestaña Integración de la campaña
El afiliado recibe `advertiser_unreachable`	El anunciante no respondió, o no salió el correo	Mira el Log; el lead está guardado: no lo reenvíes
Un lead que el afiliado envió no sale en el Directorio	Se rechazó antes de guardarse, o es de fuera de las fechas del filtro	Pídele el `code`, o amplía las fechas