Que datos conviene sincronizar entre Visma y Humand
No hace falta sincronizar absolutamente todo el legajo. En la practica, la integracion suele limitarse a los campos que Humand necesita para mantener actualizados el organigrama, los permisos y las comunicaciones segmentadas:
Identificador unico del colaborador (legajo o documento, segun el criterio que se defina como clave de cruce entre ambos sistemas).
Datos basicos: nombre, apellido, email corporativo.
Fecha de ingreso y fecha de baja.
Puesto o categoria.
Area, sucursal o centro de costos.
Jefe directo (para que el organigrama se arme solo).
Estado: activo, en licencia, dado de baja.
Dos formas de integrar los sistemas
Visma y Humand no se conectan entre si de forma nativa: hace falta una capa intermedia que traduzca eventos de uno al formato que espera el otro. Hay dos patrones habituales, y no son excluyentes:
Sincronizacion programada (batch)
Un proceso corre cada cierto tiempo (por ejemplo, cada hora o una vez por dia), compara el estado actual de Visma contra el ultimo estado conocido, calcula las diferencias (altas, bajas, cambios) y las aplica en Humand a traves de su API. Es la opcion mas simple de implementar y suele alcanzar para la mayoria de las empresas, sobre todo si los cambios de plantilla no son constantes durante el dia.
Integracion orientada a eventos (near real time)
Cuando Visma expone webhooks o algun mecanismo de notificacion de cambios, se puede reaccionar apenas ocurre el evento: en el momento en que se registra un alta o una baja, el middleware la procesa y actualiza Humand en minutos en lugar de horas. Tiene mas sentido en organizaciones con alta rotacion o con necesidades puntuales, como dar de baja el acceso a Humand el mismo dia en que una persona deja de trabajar en la empresa.
Casos de uso que se resuelven con esta integracion
Alta automatica: al crear el colaborador en Visma, aparece en Humand con su equipo, jefatura y permisos correctos, sin que RRHH tenga que cargarlo de nuevo.
Baja automatica: al dar de baja en Visma, se desactiva el acceso en Humand el mismo dia, cerrando una brecha de seguridad habitual (ex empleados con accesos activos).
Reorganizaciones: cambios de puesto, sucursal o jefatura se reflejan solos en el organigrama de Humand, sin planillas paralelas para mantener actualizadas a mano.
Segmentacion de comunicaciones: si Humand usa area o sucursal para segmentar noticias y encuestas, esa segmentacion queda siempre alineada con la estructura real de la empresa.
Errores comunes al integrar Visma con Humand
Usar un identificador inestable como clave de cruce (por ejemplo, el nombre completo) en lugar de un ID unico que no cambie.
No contemplar las bajas como un evento de primera clase: muchas integraciones solo manejan altas y dejan usuarios activos en Humand despues del egreso.
No dejar trazabilidad de que se sincronizo y cuando, lo que hace muy dificil auditar diferencias cuando algo no coincide.
Tratar la integracion como un proyecto de una sola vez, sin monitoreo de errores ni reintentos ante caidas puntuales de alguna de las dos APIs.
Que necesitas antes de arrancar el proyecto
Acceso tecnico (API o mecanismo de exportacion) a la instancia de Visma que usa la empresa.
Una cuenta de administrador en Humand con API key habilitada.
Un mapeo de campos acordado entre RRHH e IT: que campo de Visma corresponde a que campo de Humand.
Un ambiente de pruebas donde validar altas, bajas y cambios antes de activar la integracion en produccion.
En Granweb desarrollamos este tipo de integraciones a medida entre Visma, Humand y otros sistemas de RRHH, incluyendo la logica de sincronizacion, el manejo de errores y el monitoreo para que la integracion siga funcionando sola despues de la puesta en marcha.
