Button Button
Guía paso a paso para la consulta detallada del seguro
Consulta detallada del seguro
Gestión de la consulta detallada de seguros de los sistemas de Point General (Seguros generales, personales y automóviles), Point Life (Seguros de vida individual) y Riesgos del Trabajo.
Esta página te ofrece una guía paso a paso para realizar la consulta detallada 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 datos generales del seguro
Consulta de seguros indiviuales
Consulta información básica del seguro
Consultas varias
Consideraciones generales
El recurso /polizas/v1/estado/consulta solo puede consultar pólizas del seguro 78B Plenisalud.
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 general del seguro
Permite a los intermediarios, corredoras y sociedades agencias consultar los datos de los seguros de los sistemas de Point General (Seguros generales, personales y automóviles), Point Life (Seguros de vida individual) y Riesgos del Trabajo.
Especificación API:
GET: /polizas/v2/general/consulta
Notas clave: Si la consulta se realiza por identificación, el resultado puede contener múltiples seguros, mientras que, si se realiza por número de póliza, se obtendrá una colección de un solo elemento.
3
Consulta seguros individuales
Permite a los intermediarios, corredoras y sociedades agencias consultar lo seguros individuales (pólizas hijas) asociadas a un seguro colectiva del sistema Point General (Seguros generales, personales y automóviles).
Especificación API:
GET: /polizas/v1/individuales/consulta
Notas clave: Si el parámetro de entrada "codigoEstadoPoliza" no se envía, se devolverán los seguros de todos los estados: Vigente, Pendiente y Cancelada.
4
Consulta información básica
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de un seguro del sistema Point General (Seguros generales, personales y automóviles).
Especificación API:
5.a
Consulta de seguros personales
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de seguros personales del sistema Point General.
Especificación API:
GET: /polizas/v1/estado/consulta
Notas clave: Consulta si un cliente posee seguros de un producto específico. Actualmente solo permite consultar el producto 78B, asociado a plenisalud.
5.b
Consulta de seguros personales
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de seguros personales del sistema Point General.
Especificación API:
GET: /polizas/v1/consultas/segurospersonales
Notas clave: Este recurso permite obtener los seguros personales a partir de una identificación. Proporciona la información necesaria de cada seguros en los campos codigoSede, simbolo, poliza, modulo y unidad, los cuales son requeridos para consultar los recursos:
/polizas/v1/consultas/segurospersonales/detalle
/polizas/v1/consultas/segurospersonales/coberturas
5.c
Consulta de seguros personales
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de seguros personales del sistema Point General.
Especificación API:
GET: /polizas/v1/consultas/segurospersonales/detalle
Notas clave: Consulta el detalle del seguro personal.
5.d
Consulta de seguros personales
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de seguros personales del sistema Point General.
Especificación API:
GET: /polizas/v1/consultas/segurospersonales/coberturas
Notas clave: Consulta las coberturas del seguro personal.
6.a
Consulta de seguros automóviles
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de un seguro de automóviles registrada en el sistema Point General.
Especificación API:
GET: /polizas/v1/consultas/automoviles/basica
Notas clave: Consulta básica de seguros de automóviles.
6.b
Consulta de seguros automóviles
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de un seguro de automóviles registrada en el sistema Point General.
Especificación API:
GET: /polizas/v1/consultas/automoviles/detallada
Notas clave: Obtiene el detalle de una póliza de automóviles en base al número de póliza.
7.a
Consulta de seguros de riesgos del trabajo
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de un seguro del sistema Riesgos del Trabajo.
Especificación API:
GET: /polizas/v1/consultas/riesgosdeltrabajo
Notas clave: Los recursos /polizas/v1/consultas/riesgosdeltrabajo y /polizas/v2/riesgosdeltrabajo/consulta proporcionan información básica de la póliza. Se recomienda revisar la documentación correspondiente para determinar cuál de las dos opciones se ajusta mejor a sus necesidades.
7.b
Consulta de seguros de riesgos del trabajo
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de un seguro del sistema Riesgos del Trabajo.
Especificación API:
GET: /polizas/v2/riesgosdeltrabajo/consulta
Notas clave: Este recurso puede devolver dos tipos de respuesta según el parámetro de entrada utilizado:
Consulta por póliza: se retorna un único objeto que representa el seguro solicitada.
Consulta por identificación: si el cliente posee más de un seguro, se devuelve un arreglo que contiene todas los seguros asociadas a dicha identificación.
7.c
Consulta de seguros de riesgos del trabajo
Permite a los intermediarios, corredoras y sociedades agencias consultar la información básica de un seguro del sistema Riesgos del Trabajo.
Especificación API:
GET: /polizas/v1/certificacion/riesgosdeltrabajo
Notas clave: Consulta de certificaciones asociadas al seguro de Riesgos del Trabajo.
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.
