Guía paso a paso para la venta de seguros del riesgo del trabajo
Venta de seguros de riesgos del trabajo
Gestión y comercialización de seguros de riesgos del trabajo, que permiten automatizar el proceso de venta, garantizando agilidad y una experiencia eficiente para el cliente.
Esta página te ofrece una guía paso a paso para realizar la venta de seguros de riesgos del trabajo. 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
Proceso de cotización
Proceso de emisión
Proceso de pago
Envío de documentación
Consideraciones generales
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.
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.
Completar el "Cuestionario de Requisitos Técnicos de Seguridad" para el uso del API de la Plataforma Pago. Llave pública para encriptado de los datos de la tarjeta el cual es proporcionado por el Grupo INS con previa gestión por parte del ejecutivo ante el Departamento de Cobros. Registro de afiliados ante los procesadores gestionado por parte del Grupo INS con previa gestión por parte del ejecutivo ante el Departamento de Cobros.
Para poder cotizar se requiere una autorización por parte del Departamento de Seguros Obligatorios.
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 para Desarrolladores del Grupo INS.
API:
POST: https://apiintegracion.grupoins.com/connect/v1/token (Pruebas)
POST: https://apiproduccion.grupoins.com/connect/v1/token (Producción)
2
Proceso de cotización
Recurso que permite el procesamiento de una cotización de póliza de riesgos del trabajo.
Especificación API:
POST: /polizas/v1/riesgosdeltrabajo/consecutivocotizacion/generacion
3
Proceso de emisión
Permite remitir la solicitud de un endoso de cancelación de una póliza de seguros generales.
Especificación API:
4.a
Proceso de pago
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.
Especificación 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 campo consecutivoPago, dato indispensable para continuar con la confirmación del pago. La llave pública de encriptación varía según el ambiente, para lo cual, deben ser previamente gestionados con el Grupo INS.
4.b
Proceso de pago
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.
Especificación API:
POST: /comercioelectronico/v1/deudas/aplicacion
Notas clave: Se debe invocar el recurso /deudas/aplicacion para confirmar el pago. Se utiliza el dato consecutivoPago obtenido del proceso anterior, para completar el proceso y actualizar el estado de la deuda a Aplicado.
4.c
Proceso de pago
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.
Especificación 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.
5
Proceso de envío de condiciones
Realiza el envío de las condiciones particulares de una póliza.
Especificación API:
POST: /polizas/v1/condiciones/envio
Notas clave: El campo "codigoReporte" en el arreglo "reportes" siempre debe llevar el valor "CPART" para las condiciones particulares y el campo "indicadorCondicionesGenerales" en true.
El campo "codigoSistema" en el arreglo "filtros" siempre debe llevar el valor "RITR".
6
Proceso de envío de condiciones
En casos particulares, se requerirá el envío de documentos referentes al seguro que se está emitiendo.
Especificación 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, entre otros) al Expediente Electrónico según así lo requieran.
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.
Copyright ©2026 Grupo INS