Capacidades de la integración
Los dashboards leen los datos directamente de PeopleForce, así que las cifras en Power BI coinciden con el sistema de HR en cada actualización.
Conjuntos de datos de HR en vivo por REST API
Eventos de cambio por webhooks
Exportación de reportes programada
Mecánica
Qué datos llegan a tu herramienta de BI
Los datos van de PeopleForce a tu herramienta de BI. La REST API devuelve el estado actual en cada llamada, los webhooks envían el payload poco después de que un registro cambia y las exportaciones de reportes llegan como archivos según el horario.
| Qué se envía | A dónde | Cuándo | Datos |
|---|---|---|---|
Personas y estructura empleados, estructura, historial de cambios | PeopleForce herramienta de BI | en cada actualización modelo de BI por REST API | empleados, campos personalizados, tablas de empleados, historial de campos, departamentos, divisiones, ubicaciones, equipos, posiciones, entidades legales, perfiles de puesto, auditorías |
Ausencias y vacaciones solicitudes, saldos, políticas | PeopleForce herramienta de BI | en cada actualización modelo de BI por REST API | solicitudes de ausencia, saldos, historiales, tipos de ausencia, políticas, feriados, reportes de saldos y horas trabajadas |
Reclutamiento vacantes, candidatos, postulaciones | PeopleForce herramienta de BI | en cada actualización modelo de BI por REST API | vacantes, candidatos, postulaciones, movimientos entre etapas, fuentes, pipelines, motivos de descalificación |
Desempeño y tiempo módulos Perform y Time | PeopleForce herramienta de BI | en cada actualización modelo de BI por REST API | objetivos, KPI, ciclos de evaluación, evaluaciones, participantes, respuestas, planillas de horas, registros de horas, proyectos, solicitudes de horas extra |
Eventos de cambio temas de webhooks | PeopleForce herramienta de BI | normalmente en segundos a tu endpoint | creación, inicio, actualización y desvinculación de empleado; cambios de posición, perfil de puesto, salario y estado de empleo; aprobación, rechazo y retiro de solicitudes de ausencia; candidato, vacante, postulación, aceptación y rechazo de oferta; inicio de encuesta |
Los datos de compensación y los datos sensibles de candidatos se habilitan por separado en la clave API de tipo Company: compensación de empleados, rango de compensación base de la vacante, compensación base deseada del candidato y campos sensibles del candidato vienen en None y pasan a View cuando un dashboard los necesita. Una misma clave de tipo Company funciona en las versiones v1, v2 y v3 de la API; v3 también atiende todos los endpoints de v2 y v1.
Parámetros
Qué se puede configurar
Todo lo de abajo lo configura en PeopleForce una persona administradora o un usuario con el permiso correspondiente; la herramienta de BI mantiene su propio horario de actualización y su propio almacén de credenciales.
Parámetro | Opciones |
|---|---|
Clave API | Configuración → Seguridad → Claves API: tipo Company para reportes, tipo Career para el sitio de empleo; en las claves Company, cuatro interruptores de datos sensibles (None / View / Edit, None por defecto) y lista de IP permitidas; el token se muestra una sola vez, al crearlo |
Webhook | URL del endpoint, tema, secreto compartido opcional para la firma; una entrega fallida se puede reenviar desde el registro de entregas |
Horario del reporte | Reporte, formato XLSX o CSV, días y hora, destinatarios, interruptor de activo |
Exportación del reporte | Cualquier reporte → Exportar, XLSX o CSV, cuando lo necesites |
Actualización en la herramienta de BI | Actualización programada de Power BI, data freshness en Looker Studio o el cron de tu ETL; la API responde con el estado actual en cada llamada |
Cómo funciona la integración
Quién obtiene acceso, cómo se manejan los campos sensibles y qué tan frescas son las cifras en cada actualización.
Acceso: con el paquete Professional
Datos sensibles: se habilitan aparte en la clave
Frescura: la define quien consume los datos
Preguntas frecuentes
Lo que preguntan analistas y administradores cuando conectan por primera vez una herramienta de BI a PeopleForce.
API y webhooks en el centro de ayuda¿Cómo se arma la analítica de reclutamiento en Power BI?
Desde los recursos de reclutamiento de la API: vacantes, candidatos, postulaciones con su etapa en el pipeline, movimientos entre etapas, fuentes y motivos de descalificación. Los movimientos traen marcas de tiempo, así obtienes el time-to-hire y el tiempo en cada etapa por vacante; las fuentes te dan el desglose por canal.
¿Qué versión de la API conviene usar para conectar BI?
v3. También atiende todos los endpoints de v2 y v1, así que una sola URL base y una sola clave de tipo Company cubren datos de personas, ausencias, reclutamiento, desempeño y tiempo.
¿Los datos de Perform están disponibles por la API?
Sí. Objetivos, KPI, ciclos de evaluación, evaluaciones, participantes, preguntas y respuestas se leen por los recursos de performance de la API.
¿Cómo llevas los datos de encuestas de Pulse a BI?
Los resultados se exportan desde la encuesta misma como archivo y se cargan al modelo de BI junto con los datos de la API. En las encuestas anónimas el archivo va anonimizado e incluye departamento, división, tipo de empleo y antigüedad. El webhook survey_start marca el inicio de cada ejecución de la encuesta.
¿Cómo se autentica Power BI con PeopleForce?
Con el encabezado X-API-KEY en el conector Web: la clave se agrega en las opciones avanzadas como encabezado de la solicitud HTTP. Los interruptores de datos sensibles de la clave deciden si vuelven los campos de compensación.
¿Puedes dejar la compensación fuera de la conexión con BI?
Sí. La compensación de empleados y los otros tres interruptores de datos sensibles de una clave Company vienen en None, así que una clave nueva devuelve todas las demás áreas de datos y ninguno de estos campos hasta que pongas View en la clave.
