Guía de integración con AFAS
Descubre cómo conectar los datos de empleados y de la organización entre AFAS y THAR.
Resumen
AFAS es una plataforma de RR. HH. y nóminas muy utilizada en los Países Bajos. La integración entre THAR y AFAS permite a las organizaciones sincronizar automáticamente los datos de los empleados, los departamentos y la estructura organizativa entre ambos sistemas.
En esta guía verás cómo configurar la integración, asignar los campos clave, definir la frecuencia de sincronización y resolver los problemas de configuración más habituales para que el día a día funcione sin interrupciones.
Qué hace esta integración
- • Importación automática de empleados: Trae los registros de personal activo directamente de AFAS a la base de datos de THAR.
- • Estructura organizativa alineada: Replica departamentos y equipos para que los itinerarios formativos encajen con tu organización.
- • Sincronización de todo el ciclo de vida: Detecta automáticamente nuevas incorporaciones, bajas y cambios de puesto.
- • Prevención de errores: Estandariza la entrada de datos y evita errores tipográficos o campos de certificación vacíos.
- • Activadores flexibles: Se ejecuta automáticamente según la planificación o al instante con el botón manual "Sincronizar ahora" para administradores.
Requisitos
Antes de empezar la configuración, asegúrate de tener preparadas todas las conexiones de red y credenciales de autenticación que se indican a continuación.
Lista de requisitos previos
- • Un entorno AFAS activo con acceso a App Connector / API habilitado
- • Una cuenta de administrador de THAR con permisos de integración
- • Tu archivo XML de token de AFAS con el token de API generado
- • Conectividad de red entre tu entorno AFAS y los endpoints de la API de THAR
Instrucciones de configuración
Genera un token de API en AFAS
Inicia sesión en tu entorno AFAS Profit con permisos de administrador. Ve a General > Gestión de Profit > Generar token. Comprueba que estén marcados los permisos adecuados para los perfiles de usuario. Copia el token XML generado: lo necesitarás en el paso 3.
Abre los ajustes de integración de THAR
Accede a tu portal de THAR como administrador. En el menú lateral, ve a Ajustes > Integraciones > AFAS. Selecciona 'Configurar integración'.
Introduce tus credenciales de AFAS
Pega tu token de API de AFAS en el campo del token. Introduce la URL verificada de tu entorno AFAS. Haz clic en 'Probar conexión' para comprobar la conexión.
Configura la asignación de datos
Asigna los datos relevantes de los empleados. Revisa la tabla de asignación recomendada y ajusta los campos opcionales, como tipo de contrato, puesto y datos de teléfono.
Define la planificación de sincronización
Decide con qué frecuencia se actualizan los datos: cada hora, cada cuatro horas, una vez al día o solo de forma manual cuando lo necesites.
Activa la integración
Revisa todos los datos, repasa tu lista de comprobación y haz clic en 'Activar integración'. Tras confirmar, se inicia de inmediato una primera sincronización completa.
Configuración
Asignación de campos
Campo de AFAS
Campo de THAR
Estado
Medewerker naam
Nombre del empleado
E-mailadres
Correo electrónico
Afdeling
Departamento
Functie
Rol / puesto
Startdatum
Fecha de inicio
Contracttype
Tipo de contrato
Frecuencia de sincronización recomendada
Frecuencia
Recomendado para
Cada hora
Organizaciones muy dinámicas con varios cambios de turno de personal externo cada hora.
Cada 4 horas
Configuración estándar. Recoge los cambios de turno de mañana y tarde con una carga mínima en la API.
Diaria
Organizaciones estables con pocas incorporaciones nuevas por semana.
Solución de problemas
Problema 01
Problema: error 'Conexión fallida' al probar la conexión.
Solución: Revisa la sintaxis de tu endpoint y comprueba que tu token de AFAS App Connector no se haya revocado. Confirma también que los cortafuegos externos permiten el tráfico entrante desde las IP de producción de THAR.
Problema 02
Problema: los datos de los empleados no se sincronizan con la base de datos de THAR.
Solución: Comprueba que el contrato activo del empleado en AFAS cumple los criterios del perfil de filtro. Los contratos desactivados, en borrador o pendientes se excluyen por defecto de la sincronización diaria.
Problema 03
Problema: la estructura de departamentos no coincide.
Solución: Los códigos de departamento deben coincidir exactamente. Si la estructura es distinta, define correspondencias manuales en el Advanced Fields Editor de THAR.
¿Necesitas ayuda para configurar esta integración?
¿No encuentras la respuesta o tienes problemas de configuración? Ponte en contacto con el equipo de THAR. Nuestros especialistas están listos para ayudarte.
Contactar con soporte