Factorial HR Component

Factorial HR Component conecta tu flujo con tu cuenta de Factorial, la herramienta de recursos humanos. Con un solo componente puedes llegar a casi todas las áreas de Factorial: ausencias y vacaciones, fichajes y turnos, procesos de selección, contratos, gastos, proyectos, documentos y la configuración de la empresa.

Es útil para automatizar tareas de personal que hoy se hacen a mano, como registrar una ausencia que llega por correo, preparar un informe de fichajes o dar de alta a un candidato que se ha inscrito en tu web.

Cuándo usarlo

Un empleado pide vacaciones por chat y quieres registrar la solicitud en Factorial.
Quieres un informe semanal con las horas trabajadas o las ausencias del equipo.
Los candidatos se inscriben en un formulario de tu web y quieres crearlos en el proceso de selección de Factorial.
Un agente de IA responde a las dudas de la plantilla y necesita consultar políticas de ausencias o calendarios de trabajo.

Configuración

Necesitas una credencial Factorial Task API con una clave de API de tu cuenta de Factorial. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Factorial Task API con la que se accede a tu cuenta.
Resource	El área de Factorial con la que trabajas. Ver Recursos.
Operation	Lo que haces en esa área. La lista cambia según el Resource elegido.

Al elegir el recurso y la operación, el componente muestra solo los campos que esa operación necesita, con su nombre y una breve ayuda. Los obligatorios están marcados en el editor.

Las operaciones siguen casi siempre el mismo patrón para cada tipo de dato del área: List all… (traer todos), Get… (traer uno por su identificador), Create… (crear), Update… (cambiar) y Delete… (eliminar). Por ejemplo, en Timeoff encontrarás List all leaves, Get leave, Create leave, Update leave y Delete leave para las solicitudes de ausencia. La lista solo ofrece lo que permite la API de Factorial, así que algunos tipos de dato solo se pueden consultar (por ejemplo los gastos, los puestos y niveles, o los cambios de los empleados).

Recursos

Recurso	Qué gestiona
`Employees`	Los empleados: listarlos, consultar uno, darlo de alta con su contrato, cambiar su nombre, invitarlo a Factorial, y darlo de baja o readmitirlo. Dar de alta e invitar piden el identificador de tu empresa en Factorial, y dar de baja pide el último día con el formato `2026-10-31`.
`EmployeeUpdates`	Los cambios en la vida laboral de cada empleado: altas, bajas, ausencias, cambios de contrato y cambios de datos personales. Cada `Get…` devuelve los cambios de ese tipo del empleado indicado; Factorial los registra solo, así que aquí no se pueden crear.
`Documents`	Las carpetas de documentos y sus enlaces de descarga.
`Expenses`	Los gastos, el kilometraje y las dietas.
`Companies`	Las entidades legales de la empresa.
`JobCatalog`	Los puestos y niveles profesionales.
`Contracts`	Las compensaciones, las plantillas y versiones de contrato, y los datos de contratación propios de cada país (tipos de contrato, categorías profesionales, niveles de estudios, tipos de jornada).
`Payroll`	Las situaciones familiares, los periodos y los complementos de nómina.
`PayrollIntegrationsBase`	Los códigos que conectan Factorial con tu programa de nóminas.
`PayrollEmployees`	Los identificadores de nómina de los empleados.
`ATS`	Los procesos de selección: ofertas, candidatos, candidaturas, fases, preguntas, valoraciones, mensajes y motivos de rechazo.
`Locations`	Los centros de trabajo y sus áreas.
`ProjectManagement`	Los proyectos, subproyectos, tareas y personas asignadas, y el tiempo y los gastos imputados.
`Tasks`	Las tareas de Factorial y sus archivos.
`Posts`	Las publicaciones, grupos y comentarios del muro de la empresa.
`Finance`	Las cuentas, contactos, centros de coste, documentos financieros, asientos e impuestos.
`Attendance`	Los fichajes: tiempo trabajado, turnos, turnos libres, horas extra, solicitudes de corrección y pausas.
`TimePlanning`	La planificación de turnos y sus pausas.
`WorkSchedule`	Los horarios de trabajo y su configuración por día.
`ShiftManagement`	Los turnos.
`TimeSettings`	La configuración de las pausas.
`Timeoff`	Las ausencias y vacaciones: solicitudes, tipos de ausencia, políticas, saldos disponibles y periodos bloqueados.
`CustomFields`	Los campos personalizados que tu empresa ha añadido en Factorial, sus opciones y sus valores.
`Marketplace`	Los ajustes de las aplicaciones instaladas desde el marketplace de Factorial.

Resultado

La salida Response devuelve en texto la respuesta de Factorial: los datos del elemento con el que has trabajado, la lista de elementos en las operaciones List all…, o una confirmación en las que eliminan.

Puedes conectar el resultado a un agente para que lo resuma o lo interprete, o a un componente que extraiga los datos que necesites. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.

Ejemplo

Una empresa quiere que las solicitudes de vacaciones que llegan por correo queden registradas en Factorial.

El correo llega al flujo y un agente extrae el empleado, las fechas y el número de días.
Añade Factorial HR Component con el recurso Timeoff y la operación Create leave.
Rellena Employee ID, Leave Type ID (el tipo “Vacaciones”, que puedes consultar con List all leave types), y Start Date y End Date con el formato 2026-07-01. Factorial calcula los días a partir de las fechas.
Conecta Response a un componente de correo que confirme al empleado que su solicitud está registrada.

Buenas prácticas

Los identificadores de empleados, tipos de ausencia, centros o proyectos se consultan con las operaciones List all… del recurso correspondiente. Guárdalos para no buscarlos en cada ejecución.
Prueba primero las operaciones que crean, cambian o eliminan datos con un empleado o un registro de prueba.

Componentes relacionados

Holded Team Component: empleados y fichajes en Holded.