Referencia · 08
Bloque fuentes
Además de la recomendación, cada verificación emitida trae el bloque fuentes: todas las fuentes que se consultaron con la CURP, cómo le fue a cada una, cuántos resultados encontró y hasta 20 resultados por fuente. Sirve para que veas en qué se basó la consulta y lo que apareció alrededor de la persona, aunque no todo se pueda atribuir con certeza.
recomendacion, su sustento y cobertura_fuentes son los mismos con o sin este bloque. Solo lo marcado por_identificador o con pesa_en_recomendacion: true sostiene la recomendación; lo que coincide por nombre puede ser de otra persona y es contexto, no un hecho sobre la persona solicitante. Muestra el aviso del bloque junto a él.Dónde viene
GET /v1/verificaciones/{id} y el webhook verificacion.emitida. En GET /v1/verificaciones (listado) vale null.
Cuándo es null
Mientras está en_proceso, en no_concluyente y, rara vez, en una emitida si no se pudo armar. La verificación nunca falla por este bloque.
Tope
Hasta 20 resultados por fuente. total cuenta todos; mostrados, los que vienen.
Canal MCP
Las herramientas MCP devuelven el resumen de la recomendación; este bloque solo viene en la API.
Cómo leer la atribución
atribucion | Qué quiere decir |
|---|---|
por_identificador | Se consultó con la CURP de la persona (registro de población, certificados del SAT, cédulas). Es de ella. |
calculada | Se derivó de la CURP (el RFC) y se validó contra el SAT. |
por_nombre | Coincide con el nombre. Puede ser de otra persona con el mismo nombre. Úsalo como contexto. |
Estado de cada fuente
estado | Qué quiere decir |
|---|---|
con_resultados | La fuente respondió y encontró algo. |
sin_resultados | La fuente respondió y no encontró nada. |
no_disponible | La fuente falló o respondió algo que no se pudo interpretar. |
inexacta | El dato existe pero no se pudo confirmar (p. ej. un RFC calculado que el SAT no valida). |
no_aplica | La fuente no aplica a esta verificación. |
resumen cuenta las fuentes por estado. no_aplican lista lo que no se consulta con solo CURP (correo o teléfono, enriquecimiento digital, INE y domicilio): llegará en la versión 2.
Qué trae cada parte
registros
Registro de población (renapo: estatus de la CURP y nombre), rfc (calculado y validado contra el SAT), certificados_sat (tipo, estado y vigencia), cedulas_profesionales (profesión, institución y año) y siger_socio_empresas (razones sociales en las que aparece como socia, por_nombre). Nunca trae números de cédula ni de certificado.
listas
consultadas es cuántas listas individuales se revisaron. resultados agrupa por tipo: sanciones internacionales, personas políticamente expuestas, listas de vigilancia policial y otras, y los listados 69, 69-B y 74 del SAT. coincidencias dice en qué lista hubo coincidencia por nombre, su programa y si la lista la sigue incluyendo en su versión actual (vigencia). Sin el contenido del registro.
juzgados
Expedientes judiciales públicos que coinciden con el nombre, ordenados de mayor a menor grado. Cada uno trae juzgado, entidad, fuero, número de expediente, fecha del último acuerdo y:
categoria: tipo de asunto (arrendamiento o desahucio, mercantil, civil, penal, amparo o recurso, administrativo o fiscal, o no clasificable).violencia_en_el_hogaryobligacion_alimentariasolo aparecen cuando la persona es la parte demandada.rol:demandado,actor,quejoso_amparo_penal(promovió un amparo en materia penal;reclamodice contra qué) osin_rol.etapa:en_curso,sin_movimiento(último acuerdo hace más de 2 años, sin sentencia ni conclusión),sentencia_dictada(hay sentencia; no dice a favor de quién),concluido_sin_sentencia(archivo, sobreseimiento, desistimiento o inactividad de las partes) osin_informacion.grado: qué tan claro es que el expediente corresponde a la persona (el mismo de los factores; ver Acciones).pesa_en_recomendacion:truesi es de los expedientes que ya cuentan en la recomendación. Los demás se muestran como contexto.
Nunca vienen los nombres de las partes ni el texto de los acuerdos. Los expedientes de materias protegidas (familiares, laborales, de salud y similares) no se muestran: solo se cuentan en no_mostrados_por_privacidad. homonimia_reportada indica que la fuente reporta más de una persona con el mismo nombre.
redes_sociales, web y noticias
Resultados de búsqueda por nombre: sitio, título, liga y fecha; en redes, también la red y el perfil o página que publicó (autor). Sin extracto ni imagen. nombre_completo indica que el resultado trae el nombre completo, y menciona_entidad que además menciona la entidad de nacimiento; los que tienen ambos van primero. En noticias solo se muestran las que mencionan a la persona; si ninguna lo hace, el bloque dice motivo: ninguna_menciona_el_nombre y total conserva el conteo. Los resultados sobre temas protegidos solo se cuentan en no_mostrados_por_privacidad.
Ejemplo
Con datos ficticios y recortado:
"fuentes": {
"version": "1.0",
"aviso": "Solo lo marcado como 'por_identificador' o con pesa_en_recomendacion sostiene la recomendacion. Lo que coincide por nombre puede ser de otra persona: es contexto, no un hecho sobre la persona solicitante.",
"resumen": { "fuentes_consultadas": 16, "con_resultados": 6, "sin_resultados": 10, "no_disponibles": 0,
"no_aplican_en_esta_version": ["correo_telefono", "enriquecimiento_digital", "ine", "domicilio"] },
"registros": [
{ "fuente": "renapo", "estado": "con_resultados", "atribucion": "por_identificador",
"resultado": [{ "curp_estatus": "vigente", "curp_estatus_codigo": "RCN", "nombre": "PERSONA DE EJEMPLO", … }] },
{ "fuente": "rfc", "estado": "con_resultados", "atribucion": "calculada",
"resultado": [{ "rfc": "EJEP900101AB1", "validacion_sat": "valido", … }] }
],
"listas": { "consultadas": 89, "coincidencias": [],
"resultados": [{ "fuente": "ofac_onu_sanciones", "estado": "sin_resultados" }, …] },
"juzgados": { "estado": "con_resultados", "atribucion": "por_nombre", "total": 3, "mostrados": 2,
"no_mostrados_por_privacidad": 1, "relevantes_para_renta": 1, "homonimia_reportada": false,
"resumen_grados": { "solida": 0, "con_dudas": 1, "menor": 0, "mencion": 1 },
"resultados": [{ "juzgado": "Juzgado Primero Civil", "entidad": "Nuevo Leon", "fuero": "Comun",
"categoria": "arrendamiento_desahucio", "rol": "demandado", "reclamo": null,
"anio": 2019, "vigencia": "antiguo", "etapa": "concluido_sin_sentencia",
"expediente": "100/2019", "fecha_ultimo_acuerdo": "2019-08-20",
"grado": "con_dudas", "pesa_en_recomendacion": true }, …] },
"redes_sociales": { "estado": "con_resultados", "atribucion": "por_nombre", "total": 1, "mostrados": 1, … },
"web": { "estado": "con_resultados", "atribucion": "por_nombre", "total": 2, "mostrados": 2,
"resultados": [{ "sitio": "example.com", "titulo": "Persona de Ejemplo, nuevo gerente en Monterrey",
"liga": "https://example.com/nota-1", "fecha": "2024-05-12",
"nombre_completo": true, "menciona_entidad": true, … }] },
"noticias": { "estado": "sin_resultados", "atribucion": "por_nombre", "total": 3, "mostrados": 0,
"motivo": "ninguna_menciona_el_nombre", "resultados": [] },
"no_aplican": [{ "fuente": "ine", "motivo": "requiere_ine", "disponible_en": "v2" }, …]
}
Cómo programar contra él
- Trata
fuentescomo opcional: puede venirnully tu flujo debe seguir con la recomendación. - Programa contra los códigos (
estado,atribucion,categoria,rol,etapa); los textos (títulos, juzgados, razones sociales) son para mostrar. - Si llega un valor de catálogo que no conoces, muéstralo como «otro» en vez de fallar.
- Muestra lo
por_nombrecomo posible coincidencia, nunca como un hecho sobre la persona. La decisión es del arrendador y no debe basarse solo en este bloque.