Ir al contenido

RRHH & personas – plataforma para desarrolladores de Flowtly

Usa esta instantánea curada del esquema OpenAPI de Flowtly para planear integraciones, automatizar procesos y sincronizar los datos críticos.

Estado de la documentación

Última sincronización: 2026-04-03 18:31 (versión de la app 2.0.0)

Solo exponemos un conjunto limitado de entidades. Ejecuta ambos comandos de sincronización cuando Flowtly lance novedades para actualizar los datos.

RRHH & personas

Perfiles de empleados, departamentos, puestos, beneficios y estructura organizacional.

Resumen de la entidad

Empleado

Crea y gestiona empleados para asignaciones, aprobaciones y acceso.

Endpoints

GET https://api.flowtly.eu/employees

Listar empleados

Recupera perfiles de empleados con paginación y filtros.

POST https://api.flowtly.eu/employees

Crear empleado

Añade un empleado con nombre, email y avatar opcional.

GET https://api.flowtly.eu/employees/me

Listarme

Recupera la colección de recursos de Empleado.

GET https://api.flowtly.eu/employees/preview

Vista previa de la lista

Recupera la colección de recursos de Empleado.

GET https://api.flowtly.eu/employees/search

Buscar en la lista

Recupera la colección de recursos de Empleado.

GET https://api.flowtly.eu/employees/{id}

Obtener empleado por ID

Consulta un perfil de empleado concreto.

DELETE https://api.flowtly.eu/employees/{id}

Eliminar empleado

Elimina un perfil de empleado.

PATCH https://api.flowtly.eu/employees/{id}

Actualizar empleado

Actualiza datos como nombre o email del empleado.

GET https://api.flowtly.eu/employees/{id}/documents

Obtener empleado por ID

Consulta un perfil de empleado concreto.

GET https://api.flowtly.eu/employees/{id}/feedback-suggestion

Obtener empleado por ID

Consulta un perfil de empleado concreto.

GET https://api.flowtly.eu/employees/{id}/project-rates

Obtener empleado por ID

Consulta un perfil de empleado concreto.

POST https://api.flowtly.eu/employees/{id}/user

Crea un recurso de Empleado.

Crea un recurso de Empleado.

DELETE https://api.flowtly.eu/employees/{id}/user

Eliminar empleado

Elimina un perfil de empleado.

GET https://api.flowtly.eu/employees/{id}/working-hours-stats/{date}

Obtener empleado por ID

Consulta un perfil de empleado concreto.

Casos de uso

Aprovisione nuevos empleados desde su HRIS para que aparezcan en Flowtly desde el primer día.
Sincronice los cambios del organigrama para mantener actualizadas la dotación de personal de proyectos y las cadenas de aprobación.

Campos del esquema

Employee-employee.read_employee.detail
Campo Tipo Descripción
id integer Identificador interno del empleado.
userId integer Campo userId.
companyEmail string Campo companyEmail.
contactEmail string Campo contactEmail.
contactPhone string Campo contactPhone.
birthday string Campo birthday.
firstname string Nombre del empleado.
lastname string Apellidos del empleado.
roles array Campo roles.
phoneTextAllowed boolean Campo phoneTextAllowed.
department string Campo department.
reportsTo string Campo reportsTo.
directReports array Campo directReports.
departments array Campo departments.
activeAgreement string Campo activeAgreement.

Resumen de la entidad

Departamento

Gestionar la jerarquía de departamentos para impulsar el control de acceso, la asignación de presupuestos y la elaboración de informes de personal.

Endpoints

GET https://api.flowtly.eu/departments

Listar departamentos

Recupera la colección de recursos de Departamento.

POST https://api.flowtly.eu/departments

Crear departamento

Crea un recurso de Departamento.

GET https://api.flowtly.eu/departments/{id}

Obtener departamento por ID

Recupera un único recurso por su identificador.

PATCH https://api.flowtly.eu/departments/{id}

Actualizar departamento

Actualiza los campos del recurso utilizando JSON Merge Patch.

Casos de uso

Refleja tu árbol de departamentos HRIS en Flowtly para informes organizacionales unificados.
Crea departamentos para segmentar presupuestos y paneles de utilización.

Campos del esquema

Department-department.read_employee.preview
Campo Tipo Descripción
id integer Campo de ID.
name string Campo de nombre.
code string | null Campo de código.
manager object Campo de gestor.

Resumen de la entidad

Puesto

Defina puestos estandarizados para impulsar la asignación basada en roles, las plantillas de acuerdos y la planificación de personal.

Endpoints

GET https://api.flowtly.eu/positions

Listar puestos

Recupera la colección de recursos Position.

POST https://api.flowtly.eu/positions

Crear puesto

Crea un recurso Position.

GET https://api.flowtly.eu/positions/{id}

Obtener puesto por ID

Recuperar un único recurso por su identificador.

DELETE https://api.flowtly.eu/positions/{id}

Eliminar puesto

Eliminar el recurso.

PATCH https://api.flowtly.eu/positions/{id}

Actualizar puesto

Actualizar campos de recursos usando JSON Merge Patch.

Casos de uso

Sincroniza los puestos vacantes de tu ATS para seguir el proceso de contratación dentro de Flowtly.
Asigna puestos a las tasas de coste para cálculos automatizados de la rentabilidad del proyecto.

Campos del esquema

Position-position.read_responsibility.read
Campo Tipo Descripción
id string campo id.
name string campo de nombre.
roles array campo de roles.
responsibilities object campo de responsabilidades.

Resumen de la entidad

Beneficio

Gestionar el catálogo de beneficios, precios e inscripción por empleado para mantener sincronizados los datos de compensación de RRHH.

Endpoints

GET https://api.flowtly.eu/benefits

Listar beneficios

Recupera la colección de recursos EmployeeBenefit.

POST https://api.flowtly.eu/benefits

Crear beneficio

Crea un recurso EmployeeBenefit.

GET https://api.flowtly.eu/benefits/{id}

Obtener beneficio por ID

Recuperar un único recurso por su identificador.

PATCH https://api.flowtly.eu/benefits/{id}

Actualizar beneficio

Actualizar campos de recursos usando JSON Merge Patch.

POST https://api.flowtly.eu/benefit-prices

Crear beneficio

Crea un recurso EmployeeBenefit.

GET https://api.flowtly.eu/benefit-prices/{id}

Obtener beneficio por ID

Recuperar un único recurso por su identificador.

DELETE https://api.flowtly.eu/benefit-prices/{id}

Eliminar beneficio

Eliminar el recurso.

PATCH https://api.flowtly.eu/benefit-prices/{id}

Actualizar beneficio

Actualizar campos de recursos usando JSON Merge Patch.

GET https://api.flowtly.eu/employee-benefits

Listar beneficios

Recupera la colección de recursos EmployeeBenefit.

POST https://api.flowtly.eu/employee-benefits

Crear beneficio

Crea un recurso EmployeeBenefit.

GET https://api.flowtly.eu/employee-benefits/{id}

Obtener beneficio por ID

Recuperar un único recurso por su identificador.

PATCH https://api.flowtly.eu/employee-benefits/{id}

Actualizar beneficio

Actualizar campos de recursos usando JSON Merge Patch.

Casos de uso

Importar planes de beneficios de tu corredor y auto-inscribir a los empleados elegibles.
Rastrear los costos de beneficios por empleado para informes de compensación total.

Campos del esquema

BenefitPrice-benefit.read_benefit_price.read
Campo Tipo Descripción
id integer Campo id.
validFrom string Campo validFrom.
validTo string | null Campo validTo.
price number Campo price.
taxPercent number Campo taxPercent.
defaultCompanyCoverageAmount number Campo defaultCompanyCoverageAmount.

Resumen de la entidad

Nota del empleado

Almacenar y recuperar notas de RRHH para evaluaciones de desempeño, estado de incorporación y memorándums internos.

Endpoints

GET https://api.flowtly.eu/employee-notes

Listar notas del empleado

Recupera la colección de recursos EmployeeNote.

POST https://api.flowtly.eu/employee-notes

Crear nota del empleado

Crea un recurso EmployeeNote.

GET https://api.flowtly.eu/employee-notes/{id}

Obtener nota del empleado por ID

Recupera un único recurso por su identificador.

DELETE https://api.flowtly.eu/employee-notes/{id}

Eliminar nota del empleado

Eliminar el recurso.

PATCH https://api.flowtly.eu/employee-notes/{id}

Actualizar nota del empleado

Actualiza los campos del recurso utilizando JSON Merge Patch.

Casos de uso

Introduce los comentarios del gerente de tu herramienta 1:1 en los registros de empleados de Flowtly.
Adjuntar notas de cumplimiento o de verificación de antecedentes a los perfiles de los empleados.

Campos del esquema

EmployeeNote-employee_note.read
Campo Tipo Descripción
id string Campo id.
employee string Campo employee.
author string Campo author.
note string Campo note.
createdAt string Campo createdAt.

Resumen de la entidad

Salud y seguridad del empleado

Rastree las certificaciones de capacitación obligatorias en seguridad y salud ocupacional (BHP), las fechas de vencimiento y el estado de cumplimiento.

Endpoints

GET https://api.flowtly.eu/employee-bhps

Listar salud y seguridad del empleado

Recupera la colección de recursos EmployeeBhp.

POST https://api.flowtly.eu/employee-bhps

Crear salud y seguridad del empleado

Crea un recurso EmployeeBhp.

GET https://api.flowtly.eu/employee-bhps/{id}

Obtener salud y seguridad del empleado por ID

Recupera un único recurso por su identificador.

PATCH https://api.flowtly.eu/employee-bhps/{id}

Actualizar salud y seguridad del empleado

Actualiza los campos del recurso utilizando JSON Merge Patch.

Casos de uso

Sincroniza las finalizaciones de capacitación en seguridad de tu LMS a Flowtly.
Alertar a los gerentes cuando la certificación de OHS de un empleado esté a punto de expirar.

Campos del esquema

EmployeeBhp-employee_bhp.read
Campo Tipo Descripción
id integer Campo id.
employee string | null Campo employee.
dateFrom string Campo dateFrom.
dateTo string | null Campo dateTo.
note string | null Campo note.

Resumen de la entidad

Responsabilidad

Define responsabilidades, agrúpalas y asígnalas a empleados o puestos para una rendición de cuentas estructurada.

Endpoints

GET https://api.flowtly.eu/position-responsibilities

Listar responsabilidades

Recupera la colección de recursos ResponsibilityGroup.

POST https://api.flowtly.eu/position-responsibilities

Crear responsabilidad

Crea un recurso ResponsibilityGroup.

GET https://api.flowtly.eu/position-responsibilities/{id}

Obtener responsabilidad por ID

Recupera un solo recurso por su identificador.

DELETE https://api.flowtly.eu/position-responsibilities/{id}

Eliminar responsabilidad

Eliminar el recurso.

GET https://api.flowtly.eu/responsibilities

Listar responsabilidades

Recupera la colección de recursos ResponsibilityGroup.

POST https://api.flowtly.eu/responsibilities

Crear responsabilidad

Crea un recurso ResponsibilityGroup.

GET https://api.flowtly.eu/responsibilities/{id}

Obtener responsabilidad por ID

Recupera un solo recurso por su identificador.

PATCH https://api.flowtly.eu/responsibilities/{id}

Actualizar responsabilidad

Actualiza los campos del recurso usando JSON Merge Patch.

GET https://api.flowtly.eu/responsibility-employees

Listar responsabilidades

Recupera la colección de recursos ResponsibilityGroup.

POST https://api.flowtly.eu/responsibility-employees

Crear responsabilidad

Crea un recurso ResponsibilityGroup.

GET https://api.flowtly.eu/responsibility-employees/{id}

Obtener responsabilidad por ID

Recupera un solo recurso por su identificador.

DELETE https://api.flowtly.eu/responsibility-employees/{id}

Eliminar responsabilidad

Eliminar el recurso.

PATCH https://api.flowtly.eu/responsibility-employees/{id}

Actualizar responsabilidad

Actualiza los campos del recurso usando JSON Merge Patch.

GET https://api.flowtly.eu/responsibility-groups

Listar responsabilidades

Recupera la colección de recursos ResponsibilityGroup.

POST https://api.flowtly.eu/responsibility-groups

Crear responsabilidad

Crea un recurso ResponsibilityGroup.

GET https://api.flowtly.eu/responsibility-groups/{id}

Obtener responsabilidad por ID

Recupera un solo recurso por su identificador.

PATCH https://api.flowtly.eu/responsibility-groups/{id}

Actualizar responsabilidad

Actualiza los campos del recurso usando JSON Merge Patch.

Casos de uso

Mapea las tareas de cumplimiento a los roles para que las herramientas de auditoría puedan verificar la cobertura.
Crea una matriz RACI sincronizando las responsabilidades con tu herramienta de gestión de proyectos.

Campos del esquema

Responsibility-responsibility.read_responsibility_employee.read
Campo Tipo Descripción
id integer Campo id.
parent object Campo parent.
responsibilityGroup string Campo responsibilityGroup.
name string Campo de nombre.
description string Campo de descripción.
children array Campo children.
responsibilityEmployees array Campo responsibilityEmployees.

Resumen de la entidad

Comentarios

Recopilar, gestionar y consultar comentarios de pares y gerentes para ciclos de rendimiento.

Endpoints

GET https://api.flowtly.eu/feedback

Listar comentarios

Recupera la colección de recursos FeedbackRequest.

POST https://api.flowtly.eu/feedback

Crear comentario

Crea un recurso FeedbackRequest.

GET https://api.flowtly.eu/feedback/{id}

Obtener comentario por ID

Recuperar un único recurso por su identificador.

GET https://api.flowtly.eu/feedback-requests

Listar comentarios

Recupera la colección de recursos FeedbackRequest.

POST https://api.flowtly.eu/feedback-requests

Crear comentario

Crea un recurso FeedbackRequest.

GET https://api.flowtly.eu/feedback-requests/{id}

Obtener comentario por ID

Recuperar un único recurso por su identificador.

Casos de uso

Activar solicitudes de comentarios desde su plataforma de gestión del rendimiento.
Extraer puntuaciones de comentarios agregadas a los paneles de talento.

Campos del esquema

Feedback-feedback.read
Campo Tipo Descripción
id string Campo de ID.
employee string | null Campo de empleado.
authorEmployee string | null Campo authorEmployee.
description string Campo de descripción.
details string | null Campo de detalles.
visibility string Campo de visibilidad.
rate string Campo de tarifa.
createdAt string Campo createdAt.

Resumen de la entidad

Usuario de la organización

Gestionar quién tiene acceso al espacio de trabajo de Flowtly, enviar invitaciones y eliminar usuarios.

Endpoints

GET https://api.flowtly.eu/organization-users

Listar usuarios de la organización

Recupera la colección de recursos de OrganizationUserInvitation.

DELETE https://api.flowtly.eu/organization-users/{id}

Eliminar usuario de la organización

Eliminar el recurso.

GET https://api.flowtly.eu/organization-user-invitations

Listar usuarios de la organización

Recupera la colección de recursos de OrganizationUserInvitation.

POST https://api.flowtly.eu/organization-user-invitations/{id}/accept

Crea un recurso de OrganizationUserInvitation.

Crea un recurso de OrganizationUserInvitation.

POST https://api.flowtly.eu/organization-user-invitations/{id}/reject

Crea un recurso de OrganizationUserInvitation.

Crea un recurso de OrganizationUserInvitation.

Casos de uso

Invitar automáticamente a nuevos empleados cuando se les aprovisiona en su proveedor de identidad.
Revocar el acceso cuando los empleados son dados de baja de su HRIS.

Campos del esquema

OrganizationUser-organization_user.read_user.read
Campo Tipo Descripción
id string Campo de ID.
user object campo de usuario.
type string campo de tipo.
Whatsapp