Sincronización de integraciones
Trae empleados, contratos y unidades organizativas de cada integración activada (Entra ID, SHR, Visma OM, Intega Løn…).
Cómo funciona
La sincronización de integraciones es una única tarea que gestiona todas las integraciones con capacidad de sincronización:
- Carga las integraciones activas: solo se procesan las integraciones activadas para el espacio de trabajo; las desactivadas o sin configurar se omiten
- Obtiene los datos: pide sus datos al sistema externo indicando la hora de la última sincronización correcta, para que los sistemas que lo admiten solo devuelvan lo que ha cambiado
- Actualiza mTime: crea registros nuevos, actualiza los modificados e informa de lo que ha omitido (p. ej., registros no válidos en el sistema externo)
- Actualiza el estado de la sincronización: si va bien, registra la hora de inicio de esta ejecución como
last_sync_at; si falla, el mensaje de error. Registrar la hora de inicio (y no la de finalización) hace que los cambios hechos en el sistema externo durante la obtención se recojan en la siguiente ejecución
Cuándo se ejecuta
La tarea se ejecuta automáticamente y solo se lanza cuando al menos una integración con capacidad de sincronización está activada en el espacio de trabajo.
Parámetros
| Parámetro | Descripción |
|---|---|
| Integración | Opcional. El ID de una integración concreta (p. ej., entraid, shr, vom, integahr). Déjalo vacío para sincronizar todas las integraciones activadas |
| Simulación | Si está activada, obtiene los datos e informa de los recuentos sin cambiar nada en mTime. Útil para comprobar las credenciales o ver qué haría una integración |
Resultados de la tarea
Al sincronizar una sola integración, los resultados son planos:
| Métrica | Descripción |
|---|---|
employees (con created, updated, skipped) | Recuentos por grupo de empleados |
employments (con created, updated, skipped) | Recuentos por grupo de contratos |
org_units (con created, updated) | Recuentos por grupo de unidades organizativas |
errors | Errores que ha comunicado el sistema externo al obtener o actualizar |
Al sincronizar todas las integraciones, los resultados aparecen anidados bajo el ID de cada integración.
Los resultados de una simulación muestran el número de elementos obtenidos (employees, employments, org_units) y un indicador dry_run: true.
Cuando una ejecución se omite porque la integración está desactivada o sin configurar, verás skipped: true con un reason.
Estado de la tarea
Una ejecución que termina con filas omitidas o errores en algunos elementos finaliza con el estado advertencia en lugar de completada. Los datos que sí se sincronizaron se guardan; las advertencias llaman la atención sobre el resto.
Relacionado
- Resumen de integraciones: configura cada integración
- Estado de las integraciones: consulta la hora de la última sincronización y el error de cada integración