Saltar al contenido principal

Encuentra las respuestas que buscas

Sobre la API de reclutamiento de Personio

Este artículo explica qué es una interfaz de programación de aplicaciones (API) pública y para qué se puede utilizar la API de reclutamiento.

Las API posibilitan el intercambio de datos entre Personio y otro servicio o herramienta. De este modo, puedes crear conexiones entre Personio y tus propias bases de datos, o configurar integraciones con otras soluciones de software disponibles en Personio Marketplace. Obtén más información sobre las API públicas de Personio.

Además de la API, puedes recuperar información sobre tus trabajos publicados desde su feed XML e integrar esta información en tu sitio web. Obtén más información sobre cómo integrar ofertas de empleo de Personio en el sitio web de tu empresa mediante XML.

Antes de empezar

  • Para usar el Marketplace y configurar las integraciones, tienes que tener permisos de edición para Integración de Marketplace y la API.
  • Para integrar la API de reclutamiento, te recomendamos consultar a un experto en TI.

Alcance y acceso a la clave de la API de Reclutamiento

La clave de la API de Reclutamiento tiene un alcance limitado y centrado en la escritura. Compartirlo con terceros es la forma prevista de conectar una herramienta de reclutamiento externa. Considéralo como una contraseña y compártelo únicamente a través de un canal seguro.

Una tercera persona con la clave de la API de Reclutamiento puede hacer lo siguiente:

  • Recuperar las listas publicadas de empleos (solo lectura).
  • Enviar candidaturas nuevas, incluyendo el nombre del candidato, el correo electrónico, los documentos de candidatura y el ID del empleo.

Una tercera persona con la clave de la API de Reclutamiento no puede hacer lo siguiente:

  • Leer los perfiles de candidatos o los datos de candidatura existentes de la cuenta.
  • Acceder a la base de datos de los empleados o a cualquier dato de RR. HH., como los salarios, las ausencias o los documentos.

Transferir los datos de los candidatos a Personio

Tienes que utilizar la API de Reclutamiento si tienes un portal de empleo corporativo y quieres que los candidatos rellenen un formulario de candidatura directamente en él, sin ser redirigidos a Personio.

En este caso, la API transmitirá la información del candidato a Personio. Obtén más información sobre cómo transmitir datos de candidatos a tu cuenta de Personio.

Utilizar las credenciales correctas para el endpoint v1

Los endpoints v1 y v2 de la API de Reclutamiento requieren credenciales diferentes. Para usar POST /v1/recruiting/applications, usa las credenciales prediseñadas en Ajustes > Seguridad e integración> Credenciales de la API > Integraciones de Reclutamiento. 

Las credenciales de integración personalizadas estándar (el ID de cliente y la clave de la API de Marketplace > Integraciones conectadas) solo funcionan con los endpoints v2. Si los utiliza con el endpoint v1, obtendrá un error 401 No autorizado.

Buscar los nombres de atributo correctos para el formulario de candidatura

El endpoint v1 utiliza nombres de atributo específicos para los campos estándar del formulario de candidatura. Estas etiquetas no siempre coinciden con las que se ven en la interfaz de Personio. El Centro para desarrolladores de Personio (Personio Developer Hub) enumera los nombres de atributo estándar y ejemplos de cuerpo de la solicitud para este endpoint.

¿Qué devuelve el endpoint v1 después de crear una candidatura?

POST /v1/recruiting/applications devuelve HTTP 201 con un cuerpo de respuesta vacío. Esto es normal: el endpoint v1 no devuelve un ID ni ningún otro dato de la candidatura. La API v1 no incluye endpoints para buscar o recuperar candidaturas después de su creación. Para recuperar los datos de la candidatura, incluyendo los ID de candidatura, utiliza la API de Reclutamiento v2. 

Ten en cuenta que:
Los endpoints v2 requieren el plan Core Pro y las credenciales OAuth.

Recuperar datos de reclutamiento de Personio

Personio ofrece un endpoint GET de reclutamiento. Esto te permite recuperar tus datos de reclutamiento y realizar análisis de datos fuera de Personio.

La siguiente tabla muestra las funcionalidades disponibles y los enlaces relevantes al Centro de desarrollo. Solo puedes recuperar la información descrita en esta sección desde los endpoints de Reclutamiento v2.

Funcionalidad Enlace al Centro de desarrollo
Candidatos
Candidaturas
Puestos

Ten en cuenta que:
La API es una API REST estándar. Este tipo de interfaz es diferente de los webhooks. Los webhooks te notificarían automáticamente sobre los cambios en una candidatura, candidato o empleo. Las API REST no tienen esta funcionalidad. Para detectar cambios al interactuar a través de una API REST, debes verificar los resultados devueltos en busca de diferencias. Personio no puede comprobar esto por ti.

Puntos de datos clave disponibles

Desde los endpoints descritos anteriormente, puedes recuperar los siguientes datos:

Datos de candidatura

  • ID de la candidatura, created_at, updated_at
  • Fase/ estado actual
  • Nombre e ID del puesto de trabajo
  • ID e información del candidato
  • ID del canal de Reclutamiento (si se ha capturado)
  • Fecha de candidatura
  • Equipo de contratación

Datos de transiciones de fase (fundamentales para las métricas basadas en el tiempo)

  • Historial de transición de cada candidatura
  • Desde la fase → A la fase
  • Marcas de tiempo de transición

Estos puntos de datos activan todos los cálculos basados ​​en el tiempo.

Datos del empleo

  • ID y título del puesto 
  • Departamento y empresa
  • ID de categoría
  • Fechas de creación y actualización
  • Equipo de contratación

Datos de candidatos

  • ID del candidato
  • Información básica del candidato
  • Fechas de creación y actualización

Datos de categorías

  • Nombres e ID de la categoría
  • Fases de la categoría

Casos de uso

Puedes recuperar datos útiles de reclutamiento utilizando la API de Reclutamiento. Los casos de uso que se muestran en las tablas siguientes ilustran las posibilidades.

Métricas basadas en el tiempo

Ejemplo Puntos de datos necesarios
Tiempo hasta la contratación Es posible utilizar los endpoints application-date y stage-transitions para hacer un seguimiento de cuándo los candidatos pasan a la fase Contratado.
Tiempo para hacer la oferta Es posible mediante el seguimiento de las transiciones de fase a la fase Oferta de trabajo.
Tiempo hasta cubrir el puesto Es posible comparando la fecha created_at del empleo con la fecha de contratación final de las candidaturas.
Tiempo en cada fase Es posible a través del endpoint stage-transitions.

Flujo de la candidatura y métricas de conversión

Ejemplo Puntos de datos necesarios
Candidaturas por fase Disponible a partir del estado de la fase actual en el endpoint de Candidaturas.
Tasas de conversión de la fase Calcule estas tasas utilizando datos de transición de las fases. Por ejemplo, el porcentaje de candidatos que pasan de la fase “Cribado” a la de “Entrevista” y “Oferta de trabajo”.
Volumen de candidaturas en el tiempo Haz el seguimiento utilizando las marcas de tiempo created_at y updated_at.
Candidaturas por empleo Disponible a través del campo job_id del endpoint Candidaturas.

Métricas de fuente y canal

Ejemplo Puntos de datos necesarios
Candidaturas por canal de contratación Disponible si se captura recruiting_channel_id en el endpoint Candidaturas.
Tasas de conversión por canal Calcula estas tasas combinando los datos del canal con las transiciones de fase.

Métricas de rechazo y resultados

Ejemplo Puntos de datos necesarios
Tasa de aceptación de ofertas de trabajo Es posible mediante el seguimiento de las candidaturas que llegan a la fase Contratado.
Rechazos por fase Haz el seguimiento mediante transiciones de fase a la fase del sistema Rechazado.
Ofertas de trabajo denegadas Es posible mediante el seguimiento de las candidaturas que pasan de la fase Oferta de trabajo a la fase Rechazada.

Métricas de empleo y categoría

Ejemplo Puntos de datos necesarios
Candidaturas por categoría de empleo Disponible a través de los endpoints Empleos y Categorías.
Candidaturas por departamento, centro de trabajo o ubicación Disponible en los detalles del empleo del endpoint Empleos.
Tiempo hasta cubrir el puesto (por categoría) Combine los datos de categoría del empleo con las métricas de tiempo.

Métricas de los candidatos

Ejemplo Puntos de datos necesarios
Calidad de los candidatos Haz un seguimiento del progreso de los candidatos de cada canal.
Candidaturas por candidato Disponible a través del endpoint Candidatos (un candidato puede tener varias candidaturas).

 

Pasos siguientes

Ayùdanos a mejorar. ¿Te resulta útil esta página?