Guía de integración WorkMeter · Factorial (OAuth) 🔗

Para quién es esta guía: administradores de empresa que quieren conectar su cuenta de Factorial con WorkMeter para sincronizar automáticamente empleados, calendarios, festivos y ausencias.

1. Qué hace la integración 🔗

WorkMeter y Factorial cubren áreas complementarias del ciclo de vida del empleado. Factorial gestiona RRHH (altas/bajas, calendarios, vacaciones y ausencias) y WorkMeter mide la actividad y el tiempo de trabajo. Conectarlos evita la doble entrada de datos y mejora la calidad de la información operativa.

En esta fase, el flujo de datos es unidireccional: Factorial → WorkMeter. Una vez conectada la integración, WorkMeter recibe automáticamente:

Dato	Detalle
👤 Altas y bajas de empleados	La plantilla de WorkMeter se mantiene alineada con Factorial.
📅 Calendarios y festivos	Días laborables y festivos por empleado.
🌴 Ausencias	Vacaciones, bajas médicas y permisos. Es clave para que WorkMeter calcule correctamente el tiempo esperado.

La sincronización se realiza en tiempo real (mediante webhooks de Factorial ante cada cambio) y se complementa con una reconciliación nocturna que garantiza la consistencia.

🔒 Seguridad. La conexión usa el estándar OAuth 2.0: WorkMeter nunca conoce las contraseñas de tus usuarios de Factorial, solo recibe un token revocable y con permisos acotados (mínimo privilegio). Toda la comunicación viaja cifrada por HTTPS y puedes revocar el acceso en cualquier momento desde Factorial o desde WorkMeter.

2. Antes de empezar (requisitos) 🔗

Comprueba que cumples estos requisitos:

• Tu cuenta de WorkMeter tiene la función time@work (control horario). La tarjeta de Factorial solo aparece en cuentas con esta función.
• Eres administrador en WorkMeter.
• Eres administrador en Factorial (solo los administradores pueden crear aplicaciones OAuth).
• Tienes acceso al panel de Factorial de producción.

Durante el proceso vas a manejar tres datos. Anótalos en un sitio seguro:

Dato	De dónde sale	Para qué sirve
URI de redirección	Te la da WorkMeter (es siempre la misma, ver más abajo)	Se registra en Factorial al crear la app
Client ID	Lo genera Factorial al crear la app	Se introduce en WorkMeter
Client secret	Lo genera Factorial al crear la app	Se introduce en WorkMeter

📌 La URI de redirección de WorkMeter (producción) es:

> https://timework.workmeter.com/api/Integration/factorial/Callback

Es idéntica para todos los clientes. También puedes copiarla directamente desde el asistente de WorkMeter (Paso 4, pantalla Credenciales, con el botón de copiar 📋).

3. Resumen del proceso 🔗

1. Inicia sesión en Factorial (en Factorial)
2. Crea la aplicación OAuth en Factorial (en Factorial) — te da el Client ID y el Client secret, y registras en ella la URI de redirección de WorkMeter
3. Abre WorkMeter → Configuración → Integraciones (en WorkMeter)
4. Conecta en el asistente y autoriza (en WorkMeter) — y a continuación enlaza los empleados y los tipos de día (ausencias)

Los pasos 1 y 2 se hacen en Factorial; los pasos 3 y 4 (y el mapeo posterior) en WorkMeter. Recomendamos tener abiertas las dos pestañas a la vez.

4. Paso 1 · Inicia sesión en Factorial 🔗

1. Abre una nueva pestaña del navegador y entra en tu cuenta de Factorial: https://app.factorialhr.com
2. Inicia sesión con un usuario administrador.

📸

5. Paso 2 · Crea una aplicación OAuth en Factorial 🔗

La aplicación OAuth es la que autoriza a WorkMeter a leer los datos de Factorial.

1. Con la sesión de administrador iniciada, ve al repositorio de aplicaciones OAuth de producción:

   https://api.factorialhr.com/oauth/applications
   

1. Haz clic en «New application» (Nueva aplicación).
2. Rellena el formulario:

Campo	Qué poner
Name (Nombre)	`WorkMeter` (o el nombre que prefieras para identificarla)
Redirect URI	`https://timework.workmeter.com/api/Integration/factorial/Callback`
Confidentiality (Confidencialidad)	Aplicación segura / confidential (WorkMeter es una aplicación de servidor que protege el secreto).
Scopes (Permisos)	Marca: `Employees`, `Time off`, `Time tracking` y `Company holidays`

Qué concede cada permiso:

• `Employees` → empleados, pertenencias y equipos.
• `Time off` → ausencias: vacaciones, bajas, permisos, tipos de ausencia y políticas.
• `Company holidays` → días festivos marcados por la Empresa (festivos locales, autonómicos, nacionales...).
• `Time tracking` → turnos, horarios y fichajes.

1. Guarda la aplicación. Factorial te mostrará el Client ID y el Client secret. Cópialos — los necesitarás en el Paso 4.

⚠️ La URI de redirección debe coincidir EXACTAMENTE con la de WorkMeter (incluidas mayúsculas/minúsculas y sin barra final). Si no coincide, la autorización fallará.

📸

📸

6. Paso 3 · Abre WorkMeter → Configuración → Integraciones 🔗

1. Entra en tu consola de WorkMeter: https://timework.workmeter.com
2. Pulsa el icono de engranaje ⚙️ (Configuración) arriba a la derecha.
3. En el menú lateral de configuración, selecciona Integraciones.
4. Localiza la tarjeta Factorial v1.0. Al principio aparece como no configurada («Configura las credenciales para empezar»).

1. Pulsa el engranaje ⚙️ de la tarjeta de Factorial (o el interruptor) para abrir el asistente de conexión.

7. Paso 4 · Conecta Factorial desde el asistente de WorkMeter 🔗

El asistente tiene tres pasos: Credenciales → Conectar → Conectado.

7.1 · Credenciales

Introduce el Client ID y el Client secret que copiaste de Factorial en el Paso 2.

ℹ️ El campo URI de redirección es de solo lectura y trae el botón de copiar 📋. Debe coincidir exactamente con el que registraste en Factorial en el Paso 2: `https://timework.workmeter.com/api/Integration/factorial/Callback`.

Pulsa Guardar. La tarjeta pasará al estado Pendiente y el asistente avanzará al paso Conectar.

7.2 · Conectar (autorización OAuth)

1. Revisa el campo URL de la API de Factorial. Por defecto es `https://api.factorialhr.com` (producción).

🌍 Clústeres regionales. Solo cambia este valor si tu cuenta de Factorial está en otra región/clúster (por ejemplo `https://api.es.factorialhr.com`). Debe ser una dirección `https` de Factorial; en caso contrario verás el error «La URL de Factorial no es válida».

1. Pulsa Conectar con Factorial. Se abrirá una ventana emergente de Factorial pidiendo tu autorización.
2. Autoriza a WorkMeter en esa ventana. Al conceder el permiso, la ventana se cierra y WorkMeter detecta la conexión automáticamente.

📸 [Captura pendiente — Pantalla de consentimiento OAuth de Factorial («Autorizar WorkMeter»)]

💡 Si tu navegador bloquea la ventana emergente, el asistente muestra el enlace «Abrir la página de autorización» para abrirla manualmente.

7.3 · Conectado

Cuando la autorización se completa, el asistente muestra el estado conectado:

Verás la fecha de conexión, el estado del token (Correcto) y el número de errores recientes.

8. Paso 5 · Enlaza los empleados 🔗

Tras conectar, hay que emparejar cada empleado de WorkMeter con su ficha en Factorial para que la sincronización sepa a quién corresponde cada dato.

Desde Configuración → Integraciones → Factorial (engranaje de la tarjeta), abre la pestaña Empleados:

• WorkMeter propone coincidencias automáticas por nombre y email cuando es posible.
• Para cada empleado, selecciona su equivalente de Factorial en el desplegable y pulsa Mapear; o usa Confirmar para aceptar la sugerencia.
• Puedes usar Confirmación masiva para aceptar de golpe todas las sugerencias con una confianza por encima de un umbral.
• El contador naranja («N por confirmar») indica cuántos empleados quedan por enlazar.

ℹ️ Un empleado de Factorial ya enlazado a otro usuario de WorkMeter aparece deshabilitado con la nota «Ya enlazado a …» para evitar duplicados.

9. Paso 6 · Enlaza los tipos de día (ausencias) 🔗

En la pestaña Tipos de día se emparejan los tipos de ausencia de Factorial (vacaciones, baja médica, etc.) con los tipos de día de WorkMeter:

Para cada tipo de ausencia de Factorial puedes:

• Mapear a WorkMeter → enlazarlo con un tipo de día existente.
• Crear en WorkMeter → si no existe el equivalente, crear uno nuevo y enlazarlo en el mismo paso:

Indica el nombre, un color y las horas esperadas por día (las horas de trabajo previstas para ese tipo de día; por ejemplo `0` para un día de vacaciones).

• Ignorar → marcar un tipo de ausencia que no quieras sincronizar.

⚠️ Mientras queden tipos de día «por mapear», esas ausencias no se sincronizarán. Revisa que todos los tipos relevantes estén confirmados.

10. Sincronización: qué, cuándo y cómo forzarla 🔗

• En tiempo real: cualquier cambio en Factorial (alta/baja de empleado, nueva ausencia, festivo…) llega a WorkMeter en segundos mediante webhooks.
• Reconciliación nocturna: cada noche WorkMeter contrasta el calendario para garantizar que no se ha perdido nada.
• Sincronización manual: si acabas de enlazar empleados o tipos de día y no quieres esperar al proceso automático, pulsa Sincronizar ahora en la pantalla de configuración de Factorial. Solo afecta a los empleados ya enlazados y puede tardar unos minutos.

🛡️ Tus ediciones manuales se respetan. Si modificas a mano el calendario de un empleado en WorkMeter, la reconciliación nocturna no sobrescribirá ese cambio: solo gestiona los días que provienen de Factorial.

11. Verificar que todo funciona 🔗

En Configuración → Integraciones, la tarjeta de Factorial debe mostrar el estado Conectado, con Token: Correcto y Errores (7d): 0:

Si el estado del token muestra otra cosa, consulta la siguiente sección.

12. Gestionar o desconectar la integración 🔗

Desde la pantalla de configuración de Factorial dispones de:

• Reemplazar credenciales — para introducir un nuevo Client ID / Secret (por ejemplo, si rotaste el secreto en Factorial). Requiere volver a autorizar la conexión.
• Desconectar — corta la integración: WorkMeter deja de recibir datos de Factorial y se eliminan los webhooks, los tokens y las credenciales OAuth guardadas.

ℹ️ Al desconectar, los datos ya sincronizados y los enlaces (mapeos) de empleados y tipos de día se conservan en WorkMeter; simplemente dejan de intercambiarse datos nuevos. Lo que sí se elimina son las credenciales OAuth (Client ID/Secret), de modo que si más adelante vuelves a conectar tendrás que introducirlas de nuevo y volver a autorizar WorkMeter en Factorial.

13. Resolución de problemas 🔗

Mensaje / síntoma	Causa	Solución
«La URL de Factorial no es válida»	El host introducido en Conectar no es una dirección válida de Factorial.	Usa `https://api.factorialhr.com` (o tu clúster regional `https://api..factorialhr.com`).
«Factorial ya está conectado. Desconecta primero…»	Ya existe una conexión activa para tu cuenta.	Desconecta la integración actual antes de iniciar una nueva.
«El navegador ha bloqueado la ventana emergente»	El bloqueador de pop-ups impidió abrir la autorización.	Usa el enlace «Abrir la página de autorización» o permite las ventanas emergentes para `timework.workmeter.com`.
«La autorización ha caducado» / «La ventana … se cerró antes de completarse»	Se cerró la ventana de Factorial o se agotó el tiempo.	Vuelve a pulsar Conectar con Factorial y completa la autorización.
Estado del token: «Se recomienda refrescar» / «Inválido o expirado» o aviso «La conexión con Factorial ha caducado»	El token de acceso dejó de ser válido (por ejemplo, tras reiniciarse el servicio).	Desconecta y vuelve a conectar la integración para renovarlo de forma duradera.
El error indica que falta registrar la URI de redirección / no coincide	La Redirect URI registrada en Factorial no es exactamente la de WorkMeter.	Revisa que en Factorial figure `https://timework.workmeter.com/api/Integration/factorial/Callback`, sin barra final ni diferencias de mayúsculas.
La tarjeta de Factorial no aparece	La cuenta no tiene la función time@work.	Contacta con tu responsable de cuenta de WorkMeter.

Si el problema persiste, contacta con el soporte de WorkMeter en https://help.workmeter.com.

14. Preguntas frecuentes 🔗

¿WorkMeter puede modificar datos en Factorial?
No. En esta fase la integración es de solo lectura desde Factorial: los datos viajan únicamente de Factorial a WorkMeter.

¿Qué pasa con las contraseñas de mis usuarios?
WorkMeter no las conoce en ningún momento. La autorización OAuth entrega un token revocable; nunca credenciales de usuario.

¿Puedo revocar el acceso?
Sí, en cualquier momento: desde WorkMeter con Desconectar, o desde Factorial eliminando/revocando la aplicación OAuth.

¿Tengo que crear la app OAuth de Factorial cada vez?
No. Se crea una sola vez. Si rotas el client secret en Factorial, usa Reemplazar credenciales en WorkMeter.

¿Afecta a los datos de actividad que ya mide WorkMeter?
No. La integración solo aporta calendario, festivos y ausencias para que el cálculo de tiempo esperado sea más preciso; la medición de actividad sigue funcionando igual.