Integración con GeoVictoria

El aplicativo y GeoVictoria realizan un intercambio bidireccional de datos que pueden estar relacionados a usuarios, licencias, vacaciones y novedades. A continuación se describen los procesos de transferencia de datos.

Datos Transferidos de Visma Latam a GeoVictoria

Las primeras tareas programadas consultarán los endpoint entregados por Visma mediante API. En caso de encontrar indicación de modificación de un campo, la tarea programada buscará dichos datos nuevos y los transferirá a Geovictoria. Esto se hará cada 5 y 20 minutos (alta/bajas y detalle de usuario, respectivamente).

Tarea Programada 1: Alta y Baja de Usuarios

Esta tarea se ejecutará cada cinco minutos y no se procesará una nueva instancia de esta hasta que finalice la anterior. Si la tarea se ejecuta por más de treinta minutos, se detendrá y se comenzará una nueva instancia.

Utiliza el endpoint “/webapi/employees” para obtener:

Usuarios:

ID RAET
Nombres
Activo

Luego, con el endpoint “/webapi/employees/rh-{id}”

Usuarios:

ID RAET
RUT
Mail
Nombres
Fecha de Nacimiento
Sexo
Estado Civil

Tarea Programada 2: Actualización y Detalle de Usuarios

Esta parte de la sincronización realiza la actualización de diferentes datos de un usuario. Utiliza el endpoint “/webapi/sync” para obtener los últimos cambios en usuarios y puede llegar a variar en tiempo dependiendo la cantidad de datos que se verán afectados.

Los datos que se obtienen mediante esta parte de la sincronización son rescatados desde Visma y almacenados en GeoVictoria para su posterior uso en el sistema y pueden ser los siguientes:

Usuarios:

Mail
Nombres
Fecha de Nacimiento
Sexo
Estado Civil
Razón Social (estructura ID 10)
Fecha Contrato (Fecha de última Alta)
Horas Contrato (estructura ID 1939)
Cargo (estructura ID 1934)
Jornada (estructura ID 1937)
Tipo de Jornada (estructura ID 1938)
Sindicato (estructura ID 1944)
Grupo de Horarios (estructura ID 1965)
Cambio de Ropa (estructura ID 1940)
Centro de Costo (estructura ID 5)
Control de Asistencia (estructura ID 1935)
Permiso de Lactancia (estructura ID 1963) considerando fecha inicio y fecha fin

Grupos:

No se realiza sincronización de Grupos. Los usuarios creados serán asignados al grupo “Por Enrolar”.

Tarea Programada 3: Licencias Médicas

En GeoVictoria, la justificación de inasistencia por licencia médica se realiza mediante permisos. Estos se obtendrán desde Visma mediante el endpoint “/webapi/leaves”.

Permisos:

Rut
Fecha Inicio
Fecha Fin
Tipo de Permiso

El tipo de licencia que proviene desde Visma, es conocido en GeoVictoria como el tipo de permiso que se asignará. Si en GeoVictoria no existe ningún tipo de permiso con la descripción indicada en el aplicativo, la integración lo creará.

Para verificar los tipos de licencia que existen en el aplicativo, seguir la ruta: HR Core / Licencias / Configuración / Tipos de Licencia.

Tarea Programada 4: Vacaciones

Se debe obtener la cantidad de días de vacaciones para cada usuario existente en GeoVictoria. Este valor se actualiza diariamente a las 00:00 hrs. Las vacaciones obtenidas desde el aplicativo se encuentran divididas por período. GeoVictoria almacenará separado por período los contadores de días disponibles para vacaciones que serán utilizados para feriado legal y para feriados progresivos dentro de una estructura similar por usuario, período, y concepto. Por ejemplo:

Usuario	Período	Concepto	Días
12345678K	2019	Legal	2
12345678K	2020	Legal	8
159753145	2020	Progresivo	1

Las vacaciones se obtienen desde el endpoint “webapi/leaves/holidays”.

Datos Transferidos de GeoVictoria a Visma Latam

Esta será la segunda parte de la integración, en donde se subirán tres archivos .csv al directorio SFTP de Visma. Los tres archivos consisten en Novedades, Vacaciones, y Licencias Médicas & Ausencias.

La iteración de cada archivo puede ser de una de las siguientes maneras:

1. Por Período: la información entregada puede ir en base al período, en donde se debe leer desde base de datos, los días de inicio y fin del período. Con estos días, se obtiene la información desde GeoVictoria que será transferida a Visma.

2. Por Solicitud: En los casos donde la información debe ir de forma más frecuente, para lograr un reflejo automático de la información, se buscará cada 10 minutos en GeoVictoria si es que existe un nuevo dato para informar a Visma. En caso de que sea así, se generará el archivo y realizará la carga correspondiente.

Archivo 1: Novedades

La planilla por donde se cargarán las horas trabajadas, atrasos, HHEE, asignación domingo festivo, bono domingo festivo e inconsistencia, será la “Interfaz novedades 354”. Se consideran los atrasos y adelantos no justificados.

Esta información es en relación al período indicado por el cliente, por lo tanto, se carga una vez por período y con la información correspondiente a este.

Las columnas dentro del archivo son:

Legajo
Concepto
Parámetros
Monto
Fecha Desde
Fecha Hasta

Archivo 2: Licencias Médicas y Ausencias

En este archivo se informa a Visma los datos provenientes de los permisos solicitados (workflow de permisos, con excepción de feriado legal y progresivo). Esto se realiza por solicitud, es decir, cada 10 minutos el sistema revisará si hay una nueva solicitud por informar a Visma, para luego generar el archivo y cargarlo.

Además, existe una segunda ejecución de la carga en donde se debe generar un archivo una vez por período que incluya las inasistencias no justificadas.

Las columnas dentro del archivo son:

Legajo
Tipo de Ausencia
Sub Tipo (vacío)
Fecha Desde
Fecha Hasta
Dia Completo
Hora desde(vacío)
Hora hasta(vacío)
Cantidad de Horas (siempre en 0)
Días Hábiles(vacío)
Días Feriados(vacío)
Estado
Número de Folio
Fecha de Folio
Tipo de Riesgo (vacío)
Secuela (vacío)

Archivo 3: Vacaciones

Para vacaciones, Visma recibirá la información de los feriados legales y progresivos solicitados y aprobados mediante el workflow Permisos. La frecuencia de la carga del archivo es por solicitud, es decir, el sistema cada 10 minutos revisará si existe nueva información por informar a Visma, en el caso de ser así, se generará el archivo y se transferirá.

Esto se realizará con la siguiente planilla “Interfaz 298 Vacaciones”:

Las columnas dentro del archivo son:

Legajo
Fecha Desde
Fecha Hasta
Día Completo
Hora desde
Hora hasta
Cantidad de Horas
Cantidad de Días
Estado
Año Período (esto es validado mediante el workflow de permisos)
Tipo de Período
Tipo Día
Tipo Origen Vacación

Véase:

Integración del Aplicativo con Otras Aplicaciones

Ir arriba ↑