Button Button
Guía paso a paso para la consulta integral del seguro
Consulta integral del seguro
Gestión de la consulta de la información integral de las pólizas de seguros. Este conjunto de APIs facilita el acceso a datos generales de la cartera de pólizas, incluyendo módulos, coberturas, riesgos, rubros, condiciones, reclamos, deudas y factor de experiencia.
Esta página te ofrece una guía paso a paso para realizar la consulta integral de un seguro. 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 la cartera
Consulta del módulo
Consulta de los riesgos
Consultas varias
Consideraciones generales
Permite a intermediarios, corredoras y comercializadoras consultar la cartera de pólizas del sistema de Point General (Seguros generales, personales y automóviles). Las pólizas de Riesgos del Trabajo y de Seguros de Vida no se incluyen en la respuesta.
Estos recursos pueden consultarse de manera independiente; sin embargo, algunos requieren parámetros específicos que deben obtenerse en el siguiente orden:
Si no se cuenta con la información del seguro, primero se puede utilizar el recurso /clientes/v1/intermediarios/cartera/consulta para obtener toda la cartera.
Los recursos /polizas/v1/riesgo/detalle/consulta, /polizas/v1/consultas/coberturas y /polizas/v1/consultas/rubros requieren el número de riesgo como parámetro, el cual puede obtenerse mediante el recurso /polizas/v1/riesgos/consulta.
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.
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)
2
Consulta de la cartera
Permite a los intermediarios, corredoras y comercializadoras consultar la cartera de sus seguros del sistema de Point General (Seguros generales, personales y automóviles)
Especificación API:
GET: /clientes/v1/intermediarios/cartera/consulta
Notas clave: Este recurso devolverá la cartera del intermediario según el rango de fechas proporcionado. (Fecha desde y fecha hasta del seguro)
3
Consulta del módulo del seguro
Permite consultar el módulo de sus seguros del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v1/modulo/consulta
Notas clave: La consulta se basa en la fecha de renovación del seguro; es decir, devuelve el módulo cuya fecha de renovación se encuentre dentro del rango especificado por el parámetro “fechaDesde”. Si el rango indicado es muy amplio y abarca varios módulos del seguro, se retornará únicamente el módulo más reciente.
4.a
Consulta de los riesgos
Permite consultar los riesgos de sus seguros del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v1/riesgos/consulta
Notas clave: El recurso /polizas/v1/riesgos/consulta se diferencia de su versión 2 (/polizas/v2/riesgos/consulta) en que la versión 1 devuelve información básica del riesgo.
4.b
Consulta de los riesgos
Permite consultar los riesgos de sus seguros del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v2/riesgos/consulta
Notas clave: El recurso /polizas/v2/riesgos/consulta se diferencia de su versión 1 (/polizas/v1/riesgos/consulta) en que la versión 2 proporciona datos más detallados del riesgo.
4.c
Consulta de los riesgos
Permite consultar los riesgos de sus seguros del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v1/riesgo/detalle/consulta
Notas clave: Para obtener aún más detalles del riesgo se debe utilizar el recurso /polizas/v1/riesgo/detalle/consulta. Es necesario consultar previamente el recurso /polizas/v1/riesgos/consulta, ya que este último permite obtener el número de riesgo requerido como parámetro.
5
Consulta de las coberturas
Permite consultar las coberturas de sus seguros del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v1/consultas/coberturas
Notas clave: El recurso permite obtener información detallada de las coberturas exclusivamente del sistema de Point General (Seguros generales, personales y automóviles). Para obtener el parámetro número de riesgo, se puede emplear el recurso /polizas/v1/riesgos/consulta.
6
Consulta de los rubros
Permite consultar los rubros de sus seguros del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v1/consultas/rubros
Notas clave: Para obtener el parámetro número de riesgo, se puede emplear el recurso /polizas/v1/riesgos/consulta.
7
Consulta de las condiciones
Permite consultar las condiciones particulares de un seguro en formato PDF del sistema de Point General (Seguros generales, personales y automóviles).
Especificación API:
8
Consulta de la deuda
Permite consultar la información de recibos generados sobre las deudas pendientes de un seguro del sistema de Point General (Seguros generales, personales y automóviles), Riesgos del Trabajo y Point Life (Seguros de vida)
Especificación API:
9
Consulta de los reclamos
Permite consultar la lista de reclamos asociados a un cliente y un seguro personal. Para confirmar cuáles seguros aplican, deberá consultarse con su ejecutivo del Grupo INS.
Especificación API:
10
Consulta del factor de experiencia
Permite consultar el factor de experiencia de un cliente.
Especificación API:
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.
