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.
Transferir los datos de los candidatos a Personio
Tendrás que utilizar la API de Reclutamiento si ya tienes un portal de empleo corporativo y quieres que tus 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.
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. Ten en cuenta que solo puedes recuperar la información descrita en esta sección desde los puntos finales de Reclutamiento de la versión 2.
| 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 puntos finales descritos anteriormente, puede recuperar los siguientes puntos de datos:
Datos de aplicaciones
- ID de aplicación, created_at, updated_at
- Etapa/estado actual
- ID del puesto de trabajo y nombre
- ID e información del candidato
- ID del canal de reclutamiento (si se captura)
- Fecha de candidatura
- Equipo de contratación
Datos de transiciones de etapa (fundamentales para las métricas basadas en el tiempo)
- Historial de transición para cada candidatura
- Del escenario → Al escenario
- Marcas de tiempo de transición
Estos puntos de datos permiten activar todos los cálculos basados en el tiempo.
Datos de empleos
- ID y título del puesto
- Departamento y empresa
- ID de categoría
- Fechas de creación/actualización
- Equipo de contratación
Datos de candidatos
- ID del candidato
- Información básica del candidato
- Fechas de creación/actualización
Datos de categorías
- Nombres e identificadores de categorías
- Etapas de la categoría
Casos de uso
Puedes recuperar datos de reclutamiento útiles mediante la API de Reclutamiento. Los casos de uso de las tablas siguientes muestran lo que es posible.
Métricas basadas en el tiempo
| Ejemplo | Puntos de datos necesarios |
| Tiempo hasta la contratación | Es posible utilizar los puntos finales de la fecha de solicitud y las transiciones de etapa para rastrear cuándo los candidatos pasan a la fase de contratación. |
| Tiempo para hacer la oferta | Es posible mediante el seguimiento de las transiciones de fase a la fase de oferta. |
| Tiempo hasta la integración | Es posible comparando la fecha de creación del empleo con la fecha de contratación final de las solicitudes. |
| Tiempo en cada etapa | Posible a través del punto final de las transiciones de etapas. |
Métricas de conversión y flujo de aplicaciones
| Ejemplo | Puntos de datos necesarios |
| Solicitudes por etapa | Disponible desde el estado de fase actual en el punto final de las aplicaciones. |
| Tasas de conversión de etapas | Calcule estas tasas utilizando los datos de transición de etapa. Por ejemplo, el porcentaje de candidatos que pasan de «Selección» a «Entrevista» y luego a «Oferta». |
| Volumen de aplicaciones a lo largo del tiempo | Realice un seguimiento con las marcas de tiempo created_at y updated_at. |
| Solicitudes por empleo | Disponible a través del campo job_id en el punto final de las aplicaciones.
|
Métricas de origen y canal
| Ejemplo | Puntos de datos necesarios |
| Solicitudes por canal de contratación | Disponible si recruiting_channel_id se captura en el punto final de las aplicaciones. |
| Tasas de conversión por canal | Calcule estas velocidades combinando los datos del canal con las transiciones de etapa. |
Métricas de rechazo y resultados
| Ejemplo | Puntos de datos necesarios |
| Tasa de aceptación de ofertas de trabajo | Posible mediante el seguimiento de las solicitudes que llegan a la fase de contratación |
| Rechazos por etapa | Realice un seguimiento de las transiciones de etapa a la etapa del sistema rechazado. |
| Ofertas rechazadas | Es posible mediante el seguimiento de las solicitudes que pasan de la fase de oferta a rechazada. |
Métricas de puestos y categorías
| Ejemplo | Puntos de datos necesarios |
| Solicitudes por categoría de empleo | Disponible a través de los puntos finales de Trabajos y Categorías. |
| Solicitudes por departamento, centro de trabajo o ubicación | Disponible en los detalles del empleo en el punto final Trabajos. |
| Tiempo de llenado (por categoría) | Combine los datos de las categorías de empleo con las métricas de tiempo. |
Métricas de candidatos
| Ejemplo | Puntos de datos necesarios |
| Calidad de los candidatos | Haz un seguimiento del progreso de los candidatos de cada canal |
| Solicitudes por candidato | Disponible a través del punto final de Candidatos (un candidato puede tener varias solicitudes). |
Pasos siguientes
- Para comenzar, lee nuestro artículo sobre cómo generar y administrar credenciales de API.
- Encontrarás una lista de todos los parámetros y más información relevante en nuestro Centro de desarrolladores.