En este artículo te explicamos qué es una interfaz de programación de aplicaciones (API) pública, para qué sirve una API de reclutamiento y cómo generar credenciales de API para ella.
¿Qué es una API pública en Personio?
Las API posibilitan el intercambio de datos entre Personio y otros servicios o herramientas. 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. Personio ofrece tres API públicas: reclutamiento, datos de personal e informes personalizados.
Nota
Para integrar la API de reclutamiento, es necesario consultar con un experto en TI.
¿Qué puedes hacer con la API de reclutamiento de Personio?
Concretamente, la API de reclutamiento de Personio te permite el intercambio de datos relacionados con los puestos de trabajo y los candidatos:
▶︎ Recuperación de puestos de trabajo en Personio (sin necesidad de credenciales): puedes extraer los datos de los puestos de trabajo que publicaste en Personio a través de XML y mostrarlos en el portal de empleo de la empresa. Encontrarás más información al respecto en el artículo Cómo integrar las ofertas de empleo de Personio en la página web de tu empresa mediante XML.
▶︎ Transferencia de candidaturas a Personio (se requieren credenciales): transfiere automáticamente las candidaturas y los datos de los candidatos (como el nombre del candidato, la fecha de la candidatura, los documentos, etc.) desde tu propio formulario de candidatura hacia Personio y crea un perfil de candidato. Encontrarás más información en el artículo Transferencia de los datos de los candidatos a tu cuenta de Personio.
Obtén tus credenciales de API
Para esta API pública, el sistema genera unas credenciales y las almacena en tu cuenta de Personio. Podrás encontrarlas en Ajustes > Integraciones > Credenciales de API > Clave de la API de reclutamiento. Allí también encontrarás el ID de la empresa y tu token de acceso a la API de reclutamiento.
Obtener información sobre puestos vacantes en Personio
Utiliza una solicitud GET para obtener información de tu canal de XML acerca de los puestos publicados e integrarla en tu sitio web. La URL subyacente es youraccount.jobs.personio.de/xml.
Una vez que las vacantes se muestren en portal de empleo, las candidaturas entrantes deberán transferirse a Personio a través de la API de reclutamiento (en forma de solicitudes y respuestas):
Transferir candidaturas a Personio
Para enviar una solicitud POST a Personio, utiliza la siguiente URL: https://api.personio.de/v1/recruiting/applications
Parámetros obligatorios para el cuerpo de la solicitud POST
| Parámetro | Notas |
| company_id | Puedes encontrarlo en: Ajustes > Integraciones > Credenciales de API |
| access_token | Puedes encontrarlo en: Ajustes > Integraciones > Credenciales de API |
| job_position_id | Puedes encontrarlo en: youraccount.jobs.personio.de/xml |
| first_name | Transferido a través del formulario de candidaturas |
| last_name | Transferido a través del formulario de candidaturas |
| Transferido a través del formulario de candidaturas | |
| application_date | Transferido a través del formulario de candidaturas |
| evaluación | Pueden ser fases de sistema o personalizadas |
Consejo
recomendamos extraer automáticamente el job_position_id del canal de XML activado (GET) e integrarlo en la solicitud POST.
Parámetros opcionales para el cuerpo de la solicitud POST
Personio también acepta los siguientes parámetros opcionales:
| Parámetro | Notas |
| Fecha de nacimiento | Transferido a través del formulario de candidaturas |
| Documentos | Transferido a través del formulario de candidaturas |
Notas
▶ Puedes transferir los documentos de los candidatos de forma masiva mediante una matriz o de forma individual. Encontrarás más información al respecto en nuestro Centro de desarrolladores.
▶ ︎El tamaño máximo de cada documento recibido a través de la API de reclutamiento es de 20 MB.
▶ Se admiten los siguientes formatos: pdf, docx, doc, png, jpg, jpeg, txt, odt, ods, xlsx, rtf, xls, pptx, ppt, gif, tif, tiff, bmp, csv, rar, gz, zip, 7z, mp4, 3gp, mov, avi, wmv.
Transferir atributos personalizados
También puedes usar la API para agregar valores a todos los atributos de candidatos que hayas creado individualmente en Ajustes > Reclutamiento > Reclutamiento > Atributos en Personio.
Para hacerlo, debes enlazar el atributo del candidato mediante el nombre del atributo API. Podrás encontrar dicho nombre en el modo de edición para el atributo del candidato:
Transferir el canal de la candidatura
Además, puedes facilitar el canal por el que se presentó la candidatura.
Para ello, integra el parámetro recruiting_channel_id en tu solicitud POST. El ID del canal se encuentra en Ajustes > Reclutamiento > Reclutamiento > Canales:
Nota
Si estás publicando un puesto de trabajo en portar de búsqueda de empleo externo, deberás añadir el parámetro external_posting_id a la solicitud POST. Esto te permitirá rastrear de qué portal de búsqueda de empleo proviene la candidatura. Encontrarás más información en el artículo Centro para desarrolladores: cómo crear candidaturas en Personio.
Documentación técnica
Encontrarás una lista completa de todos los parámetros e información adicional en nuestro centro de desarrollo Developer Hub.