Saltar al contenido

API DE REVÍSAME. Verificación de solicitantes de arrendamiento para plataformas socias. Revísame informa; el arrendador decide.

Revísame / desarrolladores

Referencia · 07

Acciones y su significado

Cuando una verificación queda emitida, trae una recomendación: una acción sugerida para el arrendador, con el sustento documental que la respalda y los factores concretos. Revísame informa; el arrendador decide.

Las cuatro acciones

Cada acción trae un titulo fijo, pensado para mostrarse tal cual al arrendador, y un mensaje que lo desarrolla. Van en orden: de «adelante» a «espera». En no_continuar_todavia el mensaje dice el motivo: una coincidencia solida con la persona, coincidencias en señales judiciales y en listas restrictivas a la vez, o que no se pudo confirmar su identidad con el registro oficial. Muestra el texto tal cual; no programes contra él.

AccióntituloQué significaQué no significa
puede_continuarContinúaLa información consultada respalda continuar con el proceso de arrendamiento.No es una garantía sobre la persona ni sobre el pago de la renta.
continuar_con_reservasContinúa con cuidadoSe puede continuar, pero hay factores que conviene revisar antes (los que limitan): una coincidencia menor, solo por nombre, o una fuente que no se pudo consultar.No es un rechazo ni una alerta sobre la persona.
pregunta_antes_de_continuarPregunta antes de continuarHay una coincidencia a nombre de la persona que conviene aclarar con ella antes de seguir (grado con_dudas). Una conversación suele resolverlo.No es un rechazo. La coincidencia puede ser de otra persona con el mismo nombre o un asunto ya cerrado.
no_continuar_todaviaNo continúes todavíaCon la información disponible hoy no se recomienda avanzar todavía: la identidad no se confirmó, hay una coincidencia solida con la persona, o la persona coincide a la vez en señales judiciales y en listas restrictivas.No es un rechazo definitivo ni un juicio sobre la persona. La situación puede cambiar.

Hasta la versión anterior había tres acciones; pregunta_antes_de_continuar se añadió entre continuar_con_reservas y no_continuar_todavia. Si tu integración mapea acciones a pantallas, trata una acción desconocida como continuar_con_reservas y muestra su titulo y mensaje.

El socio nunca recibe el reporte crudo de las fuentes consultadas: ni texto de los acuerdos, ni documentos, ni nombres de las demás partes. Recibes la acción, el mensaje, el sustento documental, sus factores y la cobertura de fuentes y, como información adicional que no cambia la acción, el bloque fuentes. No existe ningún número que ordene solicitantes.

Sustento documental

Dice qué tan sólido es el respaldo de la recomendación, no de la persona: alto, medio o bajo. Hoy va ligado a la acción: puede_continuar sale con alto, continuar_con_reservas y pregunta_antes_de_continuar con medio, y no_continuar_todavia con bajo. Léelos como campos distintos: esa correspondencia puede cambiar en versiones futuras.

Muéstralo siempre junto con su texto fijo (microexplicacion):

“Indica qué tan completa y consistente es la información que respalda esta recomendación. No califica a la persona.”

Factores

Cada factor tiene un codigo de catálogo cerrado, un efecto (fortalece o limita) y un texto legible. Programa contra codigo; muestra texto. Los factores no suman ni restan puntos.

GrupoCódigos
IdentidadIDENTIDAD_CONFIRMADA, IDENTIDAD_NO_CONFIRMADA, IDENTIDAD_COINCIDENCIA_NOMBRE_PARCIAL, IDENTIDAD_REGISTRO_NO_LOCALIZADO
Listas restrictivasLISTAS_RESTRICTIVAS_SIN_COINCIDENCIA, LISTAS_RESTRICTIVAS_COINCIDENCIA_ATRIBUIBLE, LISTAS_RESTRICTIVAS_COINCIDENCIA_HOMONIMA, LISTAS_RESTRICTIVAS_NO_CONSULTADAS
Señales judicialesSENALES_JUDICIALES_SIN_COINCIDENCIA, SENALES_JUDICIALES_COINCIDENCIA_ATRIBUIBLE, SENALES_JUDICIALES_COINCIDENCIA_NO_ATRIBUIBLE, SENALES_JUDICIALES_NO_CONSULTADAS
CoberturaCOBERTURA_FUENTES_COMPLETA, COBERTURA_FUENTES_PARCIAL, COBERTURA_FUENTE_NO_DISPONIBLE
Documento no aplica en Ruta CURPDOCUMENTO_VIGENTE, DOCUMENTO_NO_VIGENTE, DOCUMENTO_DATOS_CONSISTENTES, DOCUMENTO_DATOS_INCONSISTENTES, DOCUMENTO_NO_PRESENTADO

Catálogo de factores versión 1.0.0. Trata un código desconocido como informativo y muestra su texto: el catálogo puede crecer.

Explicación de cada factor

Además de codigo, efecto y texto, cada factor trae tres campos opcionales para mostrar al arrendador:

  • fuente: de qué fuente sale (registro_oficial, listas_restrictivas, senales_judiciales, documento_presentado, o null en los de cobertura).
  • que_se_reviso: qué se consultó, en una frase.
  • que_significa: qué quiere decir el resultado para la decisión.

Nunca incluyen el contenido de un registro (materia, número, fechas ni datos de terceros): describen el tipo de revisión, no el hallazgo.

Grado de la coincidencia

Los factores de coincidencia (LISTAS_RESTRICTIVAS_COINCIDENCIA_* y SENALES_JUDICIALES_COINCIDENCIA_*) traen además grado. Dice qué tan claro es que el registro corresponde a la persona y qué tanto pesa para la renta; el resto de los factores lo traen en null.

gradoQué significaAcción que suele producir
solidaLa lista trae un dato que identifica a la persona, no solo su nombre; o, en la fuente judicial, el registro coincide con su nombre completo como parte demandada, es reciente y es de un tipo que suele ser relevante para rentar.no_continuar_todavia
con_dudasCoincide el nombre completo como parte demandada, pero el registro es antiguo, es de un tipo poco relevante para rentar, o hay otras personas con el mismo nombre.pregunta_antes_de_continuar
menorCoincide el nombre completo, pero el registro no le atañe como parte principal (por ejemplo, ella inició el proceso).continuar_con_reservas
mencionSolo coincide parte del nombre o la coincidencia es de un tercero. Es informativo: no cambia la acción.ninguna

Las coincidencias que solo pueden ser de un homónimo (*_COINCIDENCIA_HOMONIMA) no traen grado y producen continuar_con_reservas.

El grado nunca revela el contenido del registro: no dice de qué asunto se trata, ni su fecha, ni quién más aparece. Solo describe qué tan clara es la coincidencia (por ejemplo, si el registro es reciente o antiguo) y si suele pesar para rentar. Solo cuentan los asuntos relevantes para rentar: arrendamiento o desahucio, deudas mercantiles y laborales en los que la persona es la parte demandada, y causas penales en las que la persona figura como imputada. Un asunto laboral o penal nunca lleva por sí solo a más que pregunta_antes_de_continuar. Los asuntos de materia protegida y los que no se pueden clasificar nunca cuentan ni se muestran.

Por qué ese nivel

sustento_documental.por_que_este_nivel explica el nivel con un texto fijo por caso (explicacion) y la lista determinantes: los factores de factores que explican ese nivel (en bajo, los que por sí solos bastan para ese nivel; en medio, los que limitan; vacía si ninguno en particular). Todos los códigos de determinantes están también en factores.

Siguientes pasos

recomendacion.siguientes_pasos es una lista de {codigo, texto} de un catálogo cerrado:

CódigoCuándo aparece
CONFIRMAR_IDENTIDAD_EN_PERSONALa identidad no se confirmó o coincide solo en parte.
SOLICITAR_DOCUMENTACION_ACLARATORIAHay una coincidencia en listas o en la fuente judicial que conviene aclarar.
REPETIR_VERIFICACION_MAS_TARDEAlguna fuente no se pudo consultar.
CONTINUAR_PROCESO_HABITUALNada limita el sustento.
DECISION_DEL_ARRENDADORSiempre, al final: la decisión es del arrendador.

Programa contra codigo y muestra texto. Como en los factores, trata un código desconocido como informativo.

Cobertura de fuentes

cobertura_fuentes dice cuántas de las fuentes que se intentaron consultar se pudieron consultar (consultadas de disponibles), con su detalle. En la Ruta CURP intervienen tres fuentes (identidad, listas restrictivas y señales judiciales); la fuente de documento no aplica. La cobertura es un eje distinto del sustento documental.

Cómo presentarlo al arrendador

  • Muestra la acción con un lenguaje neutro (“Revísame sugiere: continuar con reservas”), el mensaje, el nivel de sustento con su microexplicación y los factores.
  • Evita colores o íconos que sugieran que se está evaluando a la persona (semáforos, estrellas, puntajes).
  • Deja claro que la decisión es del arrendador y que la recomendación refleja consultas de un momento: respeta vigencia_hasta.
  • No muestres la recomendación al solicitante como un rechazo; si tu flujo lo informa, explica que puede actualizar su información.