¿Qué es API Universal?
Es una herramienta que permite a nuestros clientes registrar candidatos, consultar paquetes y obtener información de los procesos de forma automatizada, integrándose de manera sencilla con sus sistemas actuales.
Nuestra nueva API Universal es una actualización clave que nos permitirá atraer a nuevos clientes y crecer nuestra oferta tecnológica en el mercado.
¿cómo funciona API Universal?
Registro de Candidatos:
Los usuarios podrán registrar candidatos de manera automatizada después de autenticarse a través de la API.
Se podrán registrar CURPs previamente utilizados.
Métodos de Registro:
El registro por nombre requiere:
- Nombre completo (nombre, apellido paterno y materno)
- Fecha de nacimiento
- Sexo
- Estado
Registro por National ID:
Permite el registro utilizando el CURP como identificador único.
También se podrá solicitar campos adicionales dependiendo del paquete seleccionado por el cliente y de los procesos incluidos, como:
- Número de Celular
- Correo Electrónico
- NSS
- RFC
Consulta de Paquetes y Procesos
Al consultar un paquete, los usuarios podrán visualizar:
Datos del Candidato: Información completa del candidato.
Nombre del Paquete: Detalles del paquete asignado.
Resultado Global y Estatus Global: Información actualizada del proceso.
Resultado Global del Paquete:
Recomendado
Recomendado con reserva
No recomendado
Pendiente
No completado
Fecha de Finalización Global
Estatus Global del Paquete:
Finalizado
Validando
En proceso
Expirado
Procesos Individuales del Paquete:
Estatus del Proceso
Resultado del Proceso
Fecha de Finalización
Consentimiento
Dependiendo de quién sea el responsable del consentimiento, se solicitarán distintos campos obligatorios:
Cuando el Cliente es Responsable del Consentimiento:
NIP (cuatro dígitos del año de nacimiento del candidato).
Timestamp de Consentimiento.
Timestamp de Términos y Condiciones.
Cuando BlackTrust es Responsable del Consentimiento:
Correo electrónico del candidato.
Niveles de visibilidad
BGC Legal
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Si encuentra juicios:
Fuentes consultadas
Detalle de la evaluación (por registro):
Actor
Demandado
Tipo
Expediente
Federal
Estado
Órgano jurisdiccional
Juicio
Delito
Materia
Información adicional
Registros encontrados
Si no encuentra juicios:
Fuentes consultadas
Nivel 4
Mayor detalle
Si encuentra juicios:
Registros encontrados:
Actor
Demandado
Tipo
Expediente
Federal
Estado
Órgano jurisdiccional
BGC News
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Si encuentra noticias:
Fuentes consultadas
Resumen general
Detalle de la evaluación (por enlace):
Tipo de noticia
URL
Tipo de delito
Comentarios de la evaluación
Registros encontrados
Si encuentra noticias y es resultado automático:
Fuentes consultadas
Registros encontrados
Noticias adversas
URL
Noticias generales
URL
Si no encuentra juicios:
Fuentes consultadas
Nivel 4
Mayor detalle
Si encuentra noticias:
Registros encontrados
Noticias adversas
URL
Noticias generales
URL
Global Watchlist
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Si encuentran en listas y es automático:
Fuentes consultadas
Detalle de la evaluación (por lista)
Lista
País
Nombre
Nacimiento
Nacionalidad
Detalle adicional
URL
Si encuentran en listas y llega a QC:
Fuentes consultadas
Detalle de la evaluación (por lista)
Lista
País
Nombre
Nacimiento
Nacionalidad
Detalle adicional
URL
Comentarios de la evaluación
Si no encuentran en listas:
Fuentes consultadas
PEPs
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Si se encuentran puestos:
Puestos encontrados (por puesto)
Puesto
Área
Dependencia
Disposición
Inicio – Fin del cargo
Entidad
Ingresos
RFC
Estatus
Personas relacionadas
Nombre
Parentesco
Puesto
National ID
Estatus
Si no encuentra juicios:
Puestos encontrados: No se encontró información del candidato.
Personales relacionadas: No se encontró información del candidato.
BGC Laboral
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
NNS
CURP
Fecha de emisión del reporte
Resumen IMSS
Semanas cotizadas
Semanas descontadas
Total de semanas cotizadas
Información generada por BlackTrust
Total de razones sociales
Total de empleos
Semanas promedio por empleo
Total de años laborando
Fuente consultada
Detalle de empleo
Nivel 4
Mayor detalle
Detalle de empleo
Empresa
RFC empresa
Dirección
Fecha de Alta
Fecha de Baja
Semanas laboradas
Salario Base de Cotización
BTrust
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Reporte BTrust
National ID
Perfil
Inicio
Fin
Duración
Detalle por categoría del reporte BTrust
Nivel 4
Mayor detalle
Detalle por categoría del reporte BTrust
Congruencia
Porcentaje
Resultado
Nivel de riesgo
Credibilidad
Porcentaje
Riesgo
Delitos
Porcentaje
Resultado
Nivel de riesgo
Robo
Porcentaje
Resultado
Nivel de riesgo
Violencia
Porcentaje
Resultado
Nivel de riesgo
Documentos
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Detalle de proceso
Nombre del documento
Estatus documento
Resultado del documento
Obligatorio: Obligatorio/opcional
Adjuntado por:
Comentario:
Referencias Laborales
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
No. de Referencia
Nombre de referencia
Puesto del jefe directo
Nombre de la empresa
Puesto desempeñado por el candidato
Fecha Inicio
Fecha Fin
Observaciones sobre el colaborador
Referencias Personales
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
No. de Referencia
Resultado de la referencia
Nombre de referencia
Relación con el candidato
Tiempo de conocerse
Se conocieron en
Fortalezas percibidas
Áreas de oportunidad
Problema o situación con el candidato
¿Se recomienda para trabajar en una empresa?
Comentarios adicionales
Listas Negras del SAT
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Fuente consultada
Validación de situación del RFC
Resultado de la búsqueda del RFC en las lista 69B y 69
Reporte de Crédito
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Alcance
El detalle dependerá de la configuración del microservicio con alguna de las 4 opciones:
Reporte de Crédito en formato .pdf extraído directamente de la fuente consultado desde plataforma (Ya existe) o API.
BC Score en formato Json extraído desde API BC y consultado desde API btapp.
Reporte de Crédito en formato Json extraído desde API BC y consultado desde API btapp.
Reporte de Crédito en formato .pdf + BC Score puede ser consultado desde API btapp.
Geolocalización
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
URL de ubicación
Dirección proporcionada
Notas de la evaluación
Nombre del documento
Obligatorio: obligatorio u opcional
Resultado del documento
Comentarios de la evaluación
Validación de Estudios
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Nivel 3
Detalle de proceso
Ultimo grado de estudios
Estatus de grado
Institución educativa
Fecha Inicio
Fecha Fin
Profesión o carrera
Comprobante de estudios
Estatus de documento
Adjuntado por:
Comentarios de la evaluación
Proceso de consentimiento
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
Validación de Identidad (Amazon)
Nivel 1
Información del Paquete
Paquete
Resultado
Estatus
Fecha de inicio
Fecha de fin
Procesos
Nivel 2
Información del Proceso
Nombre proceso
Resultado
Estatus
Fecha de inicio proceso
Fecha de fin proceso
Tiempo de evaluación
Detalle del proceso
aPI Buró de Crédito
La API Universal también permite obtener información detallada del Reporte de Crédito, que puede configurarse en distintos formatos según las necesidades del cliente:
Reporte de Crédito en PDF:
Enlace para la descarga del reporte en formato PDF.
BC Score:
Información del BC Score con detalles clave:
- codigoScore: «002»
- valorScore: «0724»
- score: «% de probabilidad de pago»
- codigoRazon: [“001”, “004”, “008”]
- Razón: Nivel de endeudamiento, consulta reciente, aumento en cuentas con endeudamiento.
Reporte de Crédito en PDF + BC Score:
Enlace para descarga del reporte en .pdf.
Apartado con información de BC Score y su razón asociada.
Reporte de Crédito Completo en JSON:
📄 Todos los datos del Buró de Crédito en formato JSON, proporcionando un detalle exhaustivo del reporte.
‼️ Importante: El proceso de Reporte de Crédito no brinda un resultado, por consiguiente no tiene impacto en el resultado global del candidato. ‼️
Acércate a Producto si tienes alguna duda respecto a la API Universal.