Guía paso a paso para la gestión de reportes de planillas
Gestión de reporte de planillas
Gestión de seguros de riesgos del trabajo, que permiten automatizar el proceso de presentación de planillas, garantizando agilidad y una experiencia eficiente para el cliente.
Esta página te ofrece una guía paso a paso para realizar la presentación de planillas. 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 incio
Proceso de inclusión
Proceso de fin
Consideraciones generales
Este proceso puede ser utilizado tanto por patronos, así como por intermediarios que gestionan pólizas de sus clientes.
No se cuenta con un ambiente de desarrollo de RT Virtual (sandbox) donde se pueda confirmar la inclusión de las planillas.
Para realizar pruebas del envío de planillas en el ambiente de integración, debe de ajustarse al período vigente, de la misma forma que se haría en el ambiente de producción.
El patrón debe tener el control de no enviar la planilla dos veces o más.
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.
Requiere la previa gestión con el Departamento de Riesgos del Trabajo.
Se debe contar con el usuario autorizado (documento de identificación) en el sistema RT Virtual, con el rol correcto para realizar la inclusión de planillas.
No se deben presentar planillas con cero trabajadores.
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 inicio
Recurso que permite al cliente realizar el envío de la información general para el envío de una planilla.
Especificación API:
POST: /polizas/v1/planillas/recepcion/bloque/inicio
Notas clave: Se permite el envío máximo de 3000 trabajadores por bloque. La cantidad de bloques que se desea enviar se debe definir en el campo "numeroEnvios".
En el campo "codigoUsuario", se debe enviar el usuario autorizado en RT Virtual.
3
Proceso de inclusión
Recurso que permite al cliente realizar el envío de bloques de trabajadores para el envío a una planilla.
Especificación API:
POST: /polizas/v1/planillas/recepcion/bloque/inclusion
Notas clave: El campo "consecutivoPlanilla" se obtiene del api del proceso de inicio.
4
Proceso de fin
Recurso que permite al cliente realizar el envío de la señal de finalización del envío de una planilla.
Especificación API:
POST: /polizas/v1/planillas/recepcion/bloque/fin
Notas clave: El campo "consecutivoPlanilla" se obtiene del api del proceso de inicio.
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