Guía paso a paso para la consulta de los datos normativos
Consulta de los datos normativos
Gestión de la consulta de los datos normativos o política conozca su cliente.
Esta página te ofrece una guía paso a paso para realizar la consulta de vencimientos. Primero encontrará el flujo general del proceso, que muestra de forma simple cada etapa. Luego, la sección de requisitos y consideraciones con la información necesaria para consumir nuestros servicios. Finalmente, se detallan los pasos a seguir junto con las APIs requeridas y su documentación.
Flujo general del proceso
Aquí podrás visualizar el recorrido completo del proceso, representado paso a paso con un resumen gráfico del proceso para una rápida comprensión.
Obtener credenciales
Consulta de datos normativos
Consideraciones generales
Permite a los intermediarios, corredoras y sociedades agencias consultar los datos normativos de un cliente por medio de su número de identificación. Solo se consideran los siguientes tipos de identificación:
Cédula Física Nacional
Cédula Jurídica Gobierno Central
Cédula Persona Jurídica Nacional
Cédula Institución Autónoma
Documento Único (DIMEX)
Cédula Jurídica de Empresas extranjeras
Pasaporte
Cédulas de Cuerpos diplomáticos
Requisitos previos
Obtención de credenciales según el API requerido y de acuerdo al ambiente solicitado "Integración y Producción" (client-id, client-secret y suscription key), los cuales deberán ser gestionados y coordinados con el ejecutivo del Grupo INS correspondiente.
Obtención de documentación de la especificación OPEN API de los recursos previamente gestionados y autorizados por el Grupo INS.
Paso a paso para su implementación
En esta sección se detalla cada paso del proceso, junto con las APIs exactas que deben utilizarse en cada etapa.
2
Consulta de los datos normativos
Permite a los intermediarios, corredoras y sociedades agencias consultar los datos normativos de un cliente por medio de su número de identificación.
Especificación API:
GET: /clientes/v1/datosnormativos/consulta
Notas clave:
Los campos "indicadorClienteRestringidoAdquirirProductoPoliticaKyC" y "codigoClienteRestringidoAdquirirProductoInvestigaciones" señalan si el cliente cuenta con la política actualizada o si tiene requisitos pendientes. Para interpretar correctamente sus valores, se debe consultar la documentación del API, donde se detalla el significado específico de cada indicador.
1
Proceso de obtención de credenciales
Las Apis del Grupo INS utilizan el protocolo de autorización OAuth 2.0, que permite a las aplicaciones obtener un token de acceso para interactuar de forma segura con los recursos. Este token es temporal y debe renovarse al expirar.
Para más detalles sobre seguridad, buenas prácticas y políticas de uso, consultar la sección Seguridad de las APIs en el Portal del Desarrollador del Grupo INS.
API:
POST: https://apiintegracion.grupoins.com/connect/v1/token (Pruebas)
POST: https://apiproduccion.grupoins.com/connect/v1/token (Producción)
Acerca del Portal para Desarrolladores
Accedé a nuestras APIs, herramientas y documentación para integrar los servicios del Grupo INS en sus soluciones de forma rápida y segura.
