Guía paso a paso para la venta de seguros autoexpedibles
.png)
Gestión y comercialización de seguros autoexpedibles que permiten automatizar el proceso de venta, garantizando agilidad y una experiencia eficiente para el cliente.
Esta página le ofrece una guía paso a paso para realizar la venta de seguros autoexpedibles. 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í puedes visualizar el recorrido completo del proceso, representado paso a paso con un resumen gráfico del proceso para una rápida comprensión.
Autentificación
Proceso de Comisión
Proceso de Emisión
Proceso de Pago
Envío de Documentación
Consideraciones generales
No modificar las estructuras de los paquetes de cotización y emisión entregadas por el INS. Los paquetes de cotización y emisión podrán presentar variaciones como resultado de ajustes en los seguros. En dichos casos, el socio comercial deberá aplicar las modificaciones correspondientes en sus desarrollos, conforme a las indicaciones que sean comunicadas oportunamente por parte del ejecutivo del INS.
En relación con la consulta a los padrones, no es posible realizar consultas para los tipos de identificación “Pasaporte”, “Cuerpos Diplomáticos” y “Personas Jurídicas Extranjeras”, debido a que no se cuenta con fuentes oficiales disponibles para dichos registros.
El envío de condiciones y la factura electrónica está sujeta a la aplicación de la deuda.
El pago está habilitado exclusivamente para tarjetas Visa y MasterCard.
El envío de las condiciones particulares y generales, así como la factura electrónica, serán enviadas a la dirección de correo electrónico previamente validada por parte del cliente en el proceso de emisión del seguro. Adicionalmente, el INS conserva información del cliente, incluido el correo electrónico registrado en sus sistemas, al cual también se enviará la documentación correspondiente. En caso de que el correo validado durante la emisión coincida con el correo registrado en el INS, se utilizará únicamente esa dirección para el envío.
Como parte del proceso de pago, el INS realiza de manera automática el envío de las condiciones generales, las condiciones particulares del seguro, o bien la oferta de seguro o el certificado de póliza, según corresponda.
Requisitos previos
Credenciales en ambos ambientes "Integración y Producción" (client-id, client-secret y suscription key)
Documentación de la especificación OPEN API de los recursos previamente gestionados y autorizados por el INS.
Documentación técnica de los paquetes de cada producto (consecutivos distintos en ambos ambientes). Existen seguros que podrían necesitar requisitos adicionales, los cuales deberán ser gestionados y coordinados con el ejecutivo del INS correspondiente.
Cuestionario de Requisitos Técnicos de Seguridad para el uso de API Plataforma Pago. Llave pública para encriptado de los datos de la tarjeta el cual es proporcionado por el INS con previa gestión por parte del ejecutivo ante el Departamento de Cobros. Registro de afiliados en el BNCR gestionado por parte del INS con previa gestión por parte del ejecutivo ante el Departamento de Cobros.
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
Proceso de cotización
Permite la cotización del seguro.
API:
POST: /comercioelectronico/v1/polizas/cotizacion
GET: /clientes/v1/consultas/padrones
Notas clave: los consecutivos de configuración varian según el seguro y la moneda. Los valores de los catálogos entregados por el INS, deben enviarse en la trama tal y como fueron definidos. Si no posee los datos del cliente, puede utilizar el API /clientes/v1/consultas/padrones (Opcional).
1
Proceso de autentificación
Las Apis del 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 INS.
API:
POST: https://apiintegracion.grupoins.com/connect/v1/token (Pruebas)
POST: https://apiproduccion.grupoins.com/connect/v1/token (Producción)
4.a
Pago del seguro
Permite el pago y el envío de las condiciones generales y particulares del seguro, certificados de póliza, así como el envío de la factura electrónica.
API:
POST: /comercioelectronico/v1/pagos/cargotarjeta
Notas clave: El proceso inicia utilizando el recurso /pagos/cargotarjeta, encargado de efectuar el cargo a la tarjeta del cliente. Este recurso devuelve el consecutivoPago, dato indispensable para continuar con la confirmación del pago.
3
Proceso de emisión
Permite la emisión del seguro.
API:
POST: /comercioelectronico/v1/polizas/emision
GET: /clientes/v1/consultas/padrones
Notas clave: los consecutivos de configuración varian según el seguro y la moneda. Los valores de los catálogos entregados por el INS, deben enviarse en la trama tal y como fueron definidos. Si no posee los datos del cliente, puede utilizar el API /clientes/v1/consultas/padrones (Opcional).
4.c
Proceso de pago
Este servicio permite realizar el pago y el envío de las condiciones generales y particulares del seguro, así como de la factura electrónica.
API:
GET: /comercioelectronico/v1/deudas/estado
Notas clave:
el uso del recurso para obtener el estado de la deuda es opcional y se podrá utilizar hasta 10 minutos posterior a la aplicación de la deuda. Este servicio podrá ser utilizado como parte de los procesos internos de control, el cual permite verificar si la deuda fue aplicada. La llave pública de encriptación varía según el ambiente, para lo cual, deben ser previamente gestionados con el INS.
4.b
Proceso de pago
Este servicio permite realizar el pago y el envío de las condiciones generales y particulares del seguro, así como de la factura electrónica.
API:
POST: /comercioelectronico/v1/deudas/aplicacion
Notas clave:
Se debe invocar el recurso /deudas/aplicacion, utilizando el consecutivoPago para completar el proceso y actualizar el estado de la deuda a Aplicado.
En cuanto al envío de las condiciones del seguro y de la factura electrónica, el INS ejecuta este proceso internamente utilizando los correos electrónicos proporcionados durante la emisión, así como aquellos registrados previamente en sus sistemas. Cuando ambos correos coinciden, el envío se realiza únicamente a esa dirección.
5
Proceso de envío de documentos al expediente electrónico
En determinados casos, será necesario enviar documentación relacionada con el seguro que se está emitiendo. Cuando esto aplique, el ejecutivo del INS, informará cuáles seguros requieren el envío de dichos documentos.
API:
POST: /clientes/v1/expedienteelectronico/documentos/inclusion
Notas clave:
El socio comercial recibe como requisito de aseguramiento la instrucción de remitir, mediante la API correspondiente, los documentos necesarios según el tipo de seguro (como facturas, fotografías, avalúos, entre otros) al Expediente Electrónico según los seguros que así lo requieran.Solo se podrán cargar archivos de hasta 3 MB.
Acerca del Portal para Desarrolladores
Acceda a nuestras APIs, herramientas y documentación para integrar los servicios del INS en sus soluciones de forma rápida y segura.
