En este artículo se abordan las preguntas más frecuentes sobre las integraciones y las API en Personio.

Planes y acceso

¿Por qué el botón Crear integración personalizada no está visible en mi cuenta?

La creación de credenciales de la API personalizadas requiere el plan Core Pro. Se trata de una restricción del plan, no de un problema con los permisos de acceso. Tener un rol de administrador te otorga los permisos de acceso correctos, pero no incluye las funcionalidades de Core Pro. Si el botón Crear integración personalizada no está visible en Marketplace > Integraciones conectadas, comprueba el plan en Ajustes > Cuenta y ayuda > Suscripción y facturación. Si usas Core, tienes que mejorar el plan a Core Pro para acceder a esta funcionalidad.

¿Las integraciones de Marketplace requieren el plan Core Pro?

No. Las integraciones de Marketplace de socios están disponibles en todos los planes Core. Solo necesitas Core Pro si quieres crear tu propia integración personalizada con la API pública de Personio.

¿Puedo conectar una herramienta de IA como Claude o ChatGPT a Personio?

Comprueba si la herramienta que quieres conectar aparece en Marketplace. Si no está, puedes seguir conectándola a Personio mediante la API pública y los webhooks. Esto le permite intercambiar datos, incluidos los perfiles de los empleados, las ausencias, los registros de jornada y los datos de reclutamiento. El Departamento de IT o un proveedor externo de servicios de IT son responsables de establecer la conexión. El equipo de ayuda de Personio puede responder a las preguntas sobre la API, pero no puede ayudarte a escribir o revisar el código personalizado.

¿Existe un entorno de pruebas o sandbox para desarrollar la integración de una API con Personio?

Personio no ofrece un entorno sandbox gratuito para el desarrollo de API. Un entorno de pruebas dedicado está disponible como parte de nuestro plan Premium Support.

Para probar las llamadas a la API sin utilizar datos reales de los empleados, debes crear un conjunto de perfiles de empleados ficticios con nombres y datos ficticios en tu cuenta real. Usa estos perfiles para probar tus llamadas a la API y evaluar las respuestas. Elimine o anonimice los perfiles ficticios cuando haya terminado.

¿Para qué sirven las configuraciones de API y los permisos de rol de empleado de integración de Marketplace?

Estos son dos permisos de rol de empleado independientes:

Integración de Marketplace: configura y gestiona integraciones de terceros en Personio Marketplace.
Configuraciones de la API: ve y gestiona las credenciales de la API utilizadas para Marketplace de terceros o integraciones personalizadas.

Ninguno de los permisos de rol controla qué datos puede recuperar la API. Eso depende de los propios permisos de acceso de la integración, no del rol del empleado.

Una integración ha dejado de funcionar. ¿Puedo usar el registro de auditoría para ver qué ha cambiado?

No. El registro de auditoría no registra los cambios realizados en las integraciones ni hace un seguimiento de la actividad de la API. Las llamadas a la API realizadas con credenciales de una integración personalizada o de Marketplace de terceros, como la lectura o escritura de datos, no aparecen en el registro de auditoría. Aprende a solucionar problemas con las integraciones y las API.

¿Cómo puedo gestionar o actualizar los alcances de mis credenciales de la API?

Ve a Marketplace > Integraciones conectadas para ver todas las integraciones actuales, tanto si pertenecen a integraciones de Marketplace como si pertenecen a integraciones personalizadas que hayas creado tú.

En el caso de las integraciones creadas por Personio, los alcances son fijos y no se pueden cambiar.
En el caso de las integraciones con Marketplace de terceros, Personio configura los alcances correctos al conectar la integración. Si bien puedes verlos y ajustarlos en Marketplace > Integraciones conectadas > Permisos de acceso, no tendría que ser necesario hacer cambios. Si algo ha dejado de funcionar, vuelve a conectar la integración en lugar de ajustar los alcances manualmente, ya que así se restablecen los valores predeterminados correctos.

Para crear una integración con los permisos de lectura adicionales que necesitas (por ejemplo, para los atributos de los empleados, el registro de jornada o las ausencias), tienes que crear una integración personalizada. Requiere el plan Core Pro. En el plan Core, puedes conectar las integraciones de Marketplace, pero no puedes crear ni editar los alcances de una integración personalizada.

¿A qué puede acceder mi equipo de IT si le otorgo acceso a la API?

Depende de cómo configures el acceso. Hay dos posibles situaciones:

Has creado una integración personalizada y has compartido el ID de cliente y la clave con ella. Cualquier persona con estas credenciales solo puede acceder a los datos que hayas activado para esas credenciales. Por ejemplo, si no has otorgado acceso de lectura a los atributos relacionados con el salario, no podrán recuperarlos.
Les has otorgado los permisos de rol de Integración de Marketplace o de Configuraciones de la API. Con estos permisos, cualquier usuario puede crear o gestionar las credenciales de la API, con la posibilidad de otorgarse acceso a casi cualquier dato de Personio, incluyendo los salarios y otra información confidencial de RR. HH. Descubre más sobre los permisos de rol de las integraciones.

Si las credenciales tienen acceso de lectura a Informes o a Informes personalizados, y si esos informes contienen datos confidenciales, también pueden acceder a ellos a través de la API. Para los informes nuevos del generador de informes, tienes que activar cada informe para acceder a la API. Con la API solo se pueden recuperar los informes que hayas activado. Al activar el acceso a los informes personalizados, se otorga acceso a todos los informes personalizados, y no puedes restringirlo por informe.

Para controlar lo que cualquier persona con acceso a la API puede recuperar, revisa quién tiene permiso de edición para Integración de Marketplace y Configuraciones de la API, y comprueba los alcances de las credenciales de la API existentes.

Disponibilidad de datos de la API y límites de recuperación

¿Se pueden usar las credenciales de la API para acceder a datos que un empleado no puede ver en la interfaz de Personio?

Sí. Las credenciales de la API actúan como un permiso de acceso de administrador. Cualquier persona con acceso a las credenciales de la API puede recuperar casi todos los datos de la cuenta de Personio a través de la API, independientemente de sus permisos en Personio. Los permisos del rol de empleado se aplican únicamente a la interfaz. No restringen lo que se puede recuperar a través de la API. Por este motivo, solo tienes que otorgar acceso a las credenciales de la API a usuarios de confianza.

¿Puedo limitar el acceso a la API solo a tipos de datos específicos?

Sí. Al crear una integración personalizada, escoge a qué tipos de datos puede acceder. Si activas el acceso de solo lectura para un tipo de datos en particular, la integración solo puede recuperar los datos relacionados con ese tipo de datos. Por ejemplo, el acceso de lectura para Ausencias significa que la integración solo puede recuperar información sobre la ausencia; no puede acceder a Empleados, Documentos, Salarios ni otro tipo de datos.

¿Puedo recuperar los datos históricos del salario con la API de Personio?

Los endpoint de la API de Personio solo muestran los valores de los atributos actuales. Para recuperar los datos históricos del salario, tienes que crear un informe y recuperarlo a través de la API.

Ve a Análisis.
Haz clic en Crear informe y selecciona Informe en blanco de cambios del empleado.
Añade los atributos de salario de los que quieras hacer un seguimiento. El informe muestra los valores antiguos y nuevos junto con la fecha de entrada en vigor de cada cambio.
Guarda el informe.
En la lista de informes, selecciónalo, haz clic en Gestionar acceso a la API y selecciona Activado.
Ve a Marketplace > Integraciones conectadas.
Selecciona la integración personalizada pertinente y activa el permiso de acceso de lectura para Informes.
Para terminar, haz clic en Update.
Recupera los datos mediante la API de informes v2. Endpoint: https://api.personio.de/v2/reports/attributes.

Descubre más sobre cómo usar la API de informes v2 y la referencia de la API del Centro de desarrollo.

¿Puedo recuperar los saldos de horas extras actuales de los empleados mediante la API de Personio?

No. No hay ningún endpoint de la API que devuelva directamente los saldos de horas extras. Para recuperar los datos de horas extras mediante programación, crea un informe de horas extras en Análisis y utiliza la API de informes v2:

Ve a Análisis y haz clic en Crear informe.
Selecciona Registros de jornada y escoge un informe de horas extras en formato de tabla.
Añade Empleado como segmentación y establece Calcular para sumar.
Escoge un intervalo de fechas y guarda el informe.
Sigue los pasos para activar el informe para el acceso a la API y recuperarlo mediante la API de informes v2.

¿Puedo restringir el acceso de una credencial de la API a tipos de remuneración específicos?

No. Los permisos de credenciales de la API se otorgan por recurso. Si otorgas acceso a una integración personalizada al permiso de Remuneración, puede acceder a todos los tipos de remuneración de todos los empleados. No puedes limitarlo a un tipo específico, como el pago único o el pago recurrente.

La única restricción del alcance disponible es por entidad legal. Puedes seleccionar de qué entidades legales la integración puede recupera los datos de remuneración, lo que limita el acceso a los empleados de esas entidades.

Si quieres evitar que la integración acceda a otros tipos de datos, como los datos de los empleados o de registro de jornada, configura una integración dedicada con el permiso Remuneración activado. Esta restricción se aplica a los datos a los que puede acceder la credencial, no a los tipos de remuneración que devuelve el endpoint de la API de remuneraciones. Para obtener una lista completa de los tipos de remuneración que se pueden recuperar y crear, consulta la referencia de la API de remuneraciones en el Centro de desarrollo (Developer Hub).

¿Qué tipos de remuneración devuelve el endpoint GET /v2/compensations?

El endpoint muestra todos los tipos de remuneración almacenados en Personio para el intervalo de fechas solicitado. Entre los tipos devueltos se incluyen los siguientes:

Salario base (excluido el prorrateo)
Salario por hora
Pagos únicos
Pagos recurrentes
Bonus (excepto los bonus objetivo, que no se pueden recuperar)

También puedes crear remuneraciones mediante POST /v2/compensations. Los tipos admitidos para la creación son los siguientes:

Salario fijo
Salario por hora
Pagos únicos
Pagos recurrentes

Los bonus no son un tipo de creación independiente. Asígnalos como una remuneración única o recurrente.

Para acceder a este endpoint, activa el acceso de lectura para las remuneraciones en la integración personalizada en Marketplace > Integraciones conectadas. Para obtener la documentación completa de los endpoint, incluidos los filtros disponibles y los parámetros de solicitud, consulta la referencia de la API de remuneraciones en el Centro de desarrollo (Developer Hub).

¿Puedo consultar los horarios de trabajo de los empleados con la API de Personio?

Sí. Los horarios de trabajo forman parte de los datos de los empleados disponibles a través de la API de empleados v1. Para acceder a ellos, tienes que activar el acceso de lectura para los empleados en la integración, en Marketplace > Integraciones conectadas.

Puedes recuperar los horarios de trabajo mediante estos endpoint:

La API muestra el horario de trabajo vigente de cada empleado. No muestra datos históricos del cronograma. Los datos del horario de trabajo con granularidad diaria no están disponibles en v2. Utiliza el endpoint de v1 para estos datos.

¿Por qué el departamento, el equipo y el puesto (de trabajo) no aparecen en la respuesta de la API?

El departamento, el equipo y el puesto (de trabajo) son atributos relacionados con el empleo. El endpoint de datos de los empleados estándar no los devuelve, aunque tengas habilitado el acceso de lectura para Empleados en las credenciales de la API. Para recuperarlos, utiliza estos endpoints:

Departamento, equipo y puesto (de trabajo): GET /v2/persons/{person-id}/employments
Departamentos de primer nivel: GET /v2/org-units

El endpoint org-units muestra solo los departamentos de nivel superior (principales). Este endpoint no devuelve subdepartamentos dentro de una jerarquía de departamentos.

No tienes que cambiar nada de atributos como la fecha de nacimiento, que sí aparecen en la respuesta estándar de los empleados.

¿Cómo puedo recuperar los datos del catálogo de empleos (nombre del trabajo, familia profesional y nivel del puesto de trabajo) con la API de Personio?

Los atributos del catálogo de empleos están disponibles en la API de Personio. Utiliza estos endpoints:

Enumerar todos los empleos: GET /v2/jobs
Recuperar un solo empleo: GET /v2/jobs/{id}

Para configurar el acceso, abre la integración personalizada y activa el acceso a Catálogo de empleos. Para incluir datos de las bandas salariales, también tienes que activar el acceso a Bandas salariales.

Descubre más sobre la documentación de endpoints en el Centro de desarrollo (Developer Hub).

¿Puedo recuperar los subatributos del atributo secundario con la API de Personio?

No. Los subatributos del atributo secundario, como la fecha límite prevista y la fecha de nacimiento del menor, no están disponibles con la API de Personio (v1 o v2). Esto se aplica tanto al acceso directo a la API como a los informes exportados con la API.

¿Cómo recupero los datos de ausencia de todos los empleados con la API de Personio?

Utiliza el endpoint GET /v2/absence-periods para recuperar los periodos de ausencia de los empleados, incluyendo todos los tipos de ausencia y las fechas.

Para configurar esto:

Ve a Marketplace > Integraciones conectadas.
Selecciona la integración personalizada y activa el acceso de lectura para Ausencias.
Llama al endpoint GET /v2/absence-periods. Puedes filtrar por empleado, tipo de ausencia o rango de fechas.

Visita el Centro de desarrollo (Developer Hub) para obtener la documentación completa de los endpoints y los filtros disponibles.

¿Puedo recuperar los datos de los sustitutos de las ausencias con la API de Personio?

No. Los datos de los sustitutos no están disponibles en la API de Personio. Puedes incluir un sustituto al crear una ausencia mediante la API, pero el endpoint GET /v2/absence-periods no devuelve el campo “sustituto”. No hay ningún endpoint disponible para recuperar los datos de sustitutos.

¿Cómo sincronizo los proyectos de una herramienta externa en Personio con la API para el registro de jornadas basado en los proyectos?

Puedes sincronizar proyectos mediante un proceso de dos pasos:

En Personio, primero debes crear los proyectos. Usa el endpoint de la API de proyectos para crear cada proyecto. Incluye un ID de proyecto que coincida con el identificador de tu herramienta externa.
Envía las entradas de tiempo vinculadas a esos proyectos. Una vez que los proyectos existan en Personio, utiliza el endpoint de la API de registro de jornada para enviar los registros de jornada. Incluye el ID del proyecto en cada entrada. Esto es lo que vincula la jornada registrada con el proyecto correcto para el registro de jornada basado en proyectos.

Para acceder al endpoint de proyectos, activa el acceso a registro de jornada (lectura, escritura o ambos) en tus credenciales de API. No hay ningún permiso de proyectos independiente. Obtenga más información sobre la documentación de endpoint.

¿Por qué no puedo encontrar la opción Proyectos en los ajustes de las credenciales de la API de mi integración personalizada?

Para acceder al endpoint de la API de Proyectos en un proceso de integración personalizado, tienes que activar el acceso a Registro de jornada (lectura o escritura) en las credenciales de la API. No hay un permiso de Proyectos independiente: el endpoint de la API de Proyectos está cubierto por el acceso a Registro de jornada.

¿Personio restringe el acceso a la API en función de las direcciones IP?

No. Personio no restringe ni bloquea el acceso a la API en función de las direcciones IP. Si las llamadas a la API fallan, el problema está en el formato de la solicitud o en las credenciales.

Los intentos fallidos de inicio de sesión repetidos desde la misma dirección IP pueden provocar que esa IP se bloquee en la página de inicio de sesión de Personio. Se trata de un sistema independiente y no afecta al acceso a la API.

¿Hay límites de volumen para las llamadas a la API?

Sí. Los límites de volumen de la API varían según el endpoint. El límite global para los endpoint de la versión 1 es de 2000 solicitudes por minuto. El límite de volumen predeterminado para los endpoint de la versión 2 es de 30 solicitudes por segundo (1800 solicitudes por minuto), aunque los endpoint individuales pueden tener límites más altos o más bajos. También hay un límite de infraestructura global de 2000 solicitudes por minuto. Se trata de un límite para todas las solicitudes, no de una garantía por endpoint.

Límites de volumen para endpoint específicos:

/v1/auth: 60 solicitudes por minuto. Si superas este límite, se activará un tiempo de recarga de 60 segundos.
/v2/auth/token: 150 solicitudes por minuto. Si se supera, solo se permite 1 solicitud por segundo durante los próximos 60 segundos y, a continuación, se reinicia.
GET Employees (v1): 300 solicitudes por minuto, con un volumen de ráfaga de 15 solicitudes por segundo.
Reclutamiento (solicitudes y documentos): 20 solicitudes cada 60 segundos por empresa. Tras alcanzar el límite, espera 60 segundos antes de enviar más.

Si no aparece ningún límite de volumen, supón que se aplica el valor predeterminado de la versión 2 de 30 solicitudes por segundo (1800 solicitudes por minuto) e implementa un mecanismo de reintento con un retraso de al menos un segundo cuando recibas la respuesta 429 “Demasiadas solicitudes”.

Importación de datos y elaboración de informes

¿Puedo importar datos a Personio sin usar la API?

Sí. Puedes importar datos con las plantillas de importación integradas de Personio, sin necesidad de API ni trabajo de desarrollo. Los tipos admitidos incluyen empleados, registro de jornada, ausencia y salario.

¿Puedo configurar informes automatizados para los eventos del ciclo de vida de los empleados, como las nuevas contrataciones, las salidas y los cambios de registro de jornada?

No puedes programar la entrega automática de informes directamente en Personio. No hay ninguna funcionalidad integrada que envíe informes con una frecuencia determinada o active la exportación de informes sobre un evento del ciclo de vida. Para realizar un seguimiento de estos datos, ve a Análisis > Métricas o Análisis > Informes y ejecuta los informes manualmente. Allí encontrarás muchas plantillas de informes predefinidas. Si necesitas acceso programático a los datos de los informes, puedes recuperarlos mediante la API de informes v2. A continuación, puedes crear tu propio embudo programado de forma externa.

Integraciones del Marketplace

¿Por qué una integración conectada sigue mostrando un valor antiguo después de cambiar el nombre de una opción de atributo?

Al cambiar el nombre de una opción en un atributo de la lista de opciones, solo se actualiza la etiqueta para mostrar en Personio. El valor de la base de datos, que es lo que Personio envía a las integraciones conectadas, permanece igual y no puedes cambiarlo. Para actualizar el valor que recibe la integración, tienes que crear una opción con el nombre correcto. El nombre que introduzcas primero se convertirá en el valor nuevo de la base de datos. Descubre más sobre cómo corregir los valores de la base de datos y mostrar las etiquetas.

¿Por qué mi integración de Marketplace está bloqueada en estado Pendiente?

El estado Pendiente significa que Personio está listo y a la espera de que la integración realice su primera solicitud de la API. El estado cambia a Conectado automáticamente una vez que la integración envía los datos; no puede actualizarlos manualmente.

Si tu integración aparece como Pendiente, comprueba primero la configuración en el sistema externo para asegurarte de que está enviando solicitudes de forma activa a Personio. Para revisar los datos a los que puede acceder la integración en Personio, ve a Marketplace > Integraciones conectadas, haz clic en la integración y selecciona la pestaña Permisos de acceso. El sistema externo, no Personio, controla el comportamiento de la integración.

Si la integración sigue en estado Pendiente durante un periodo prolongado, el problema es del socio. Personio no sabe cómo los socios externos crean integraciones ni por qué no envían datos. Si la herramienta del socio muestra que la integración está activa por su parte, solucione el problema antes de ponerse en contacto con el socio; la causa puede ser una falta de coincidencia en el tipo de credencial que puede corregir usted mismo. Ponte en contacto con el equipo de ayuda del socio, no con Personio, para investigar.

¿Por qué mi informe de integración con Marketplace no tiene permisos de la API y cómo puedo solucionarlo?

Para corregir los permisos de la API que faltan en una integración de Marketplace, desconéctala y vuelve a conectarla:

Ve a Marketplace > Integraciones conectadas.
Selecciona la integración.
Haz clic en Desconectar.
Ve a Marketplace y busca la integración.
Haz clic en Conectar.
Haga clic en Generar credenciales nuevas para generar automáticamente otras credenciales de la API con los permisos que necesita la integración.

Si la integración sigue sin funcionar según lo esperado después de volver a conectarse, ponte en contacto con el equipo de ayuda del socio de integración.

¿Puedo ejecutar varias integraciones al mismo tiempo?

Sí. La API de Personio responde a las solicitudes de las herramientas conectadas en lugar de iniciarlas. Esto significa que ejecutar varias integraciones a la vez no provoca conflictos de forma predeterminada. La excepción es cuando dos integraciones tienen acceso de escritura al mismo tipo de datos, por ejemplo, los datos de registro de jornada. Si ambos añaden o actualizan los mismos registros, esto puede provocar conflictos o que se sobrescriban los datos. Si ejecutas varias integraciones con los mismos datos, comprueba si más de una tiene acceso de escritura a los mismos. Coordine con cada socio si es necesario.

¿Puedo conectar una segunda cuenta a una integración de Marketplace que ya uso?

Puede reutilizar las credenciales existentes para conectar una segunda cuenta con esa misma integración. Sin embargo, no puedes crear un segundo conjunto de credenciales de la API para la misma integración de Marketplace. Utilizar una integración con Marketplace o conectar una integración a través de la API pública no supone ningún coste adicional para Personio, siempre y cuando la cuenta tenga el plan Core Pro, que incluye el uso de la API. Es posible que algunas herramientas de socios tengan su propia tarificación independiente. Consulta directamente con la pareja si no estás seguro.

¿Puedo excluir a empleados específicos de una sincronización de integración de Marketplace?

Para la mayoría de las integraciones de Marketplace, no existe la opción de excluir a empleados individuales o a un grupo específico. Todos los empleados se sincronizan de forma predeterminada. Algunas integraciones de nómina, como Xero, ADDISON y Loket, son una excepción. Incluyen un atributo que puedes usar para excluir a empleados individuales de esa sincronización de nómina específica. Esto no está disponible para las integraciones que no son de nómina.

Algunas integraciones ofrecen filtros dentro de sus propios ajustes. Sin embargo, esto normalmente solo cambia la forma en que la herramienta de socios muestra a los empleados; la movilidad de datos a esa herramienta sigue ocurriendo. Para ver las opciones de filtrado específicas de la integración, consulte la documentación del socio.

¿Qué ocurre después de solicitar una integración que no está en Marketplace?

No recibes una confirmación individual ni una actualización del estado por correo electrónico una vez que solicitas una integración. Para comprobar el progreso, visita la página de integraciones solicitadas. Si Personio decide crear la integración, el estado de la misma se actualizará.

¿Por qué mi integración aparece sin logotipo en Integraciones conectadas?

Si una integración de Marketplace aparece sin logotipo en Marketplace > Integraciones conectadas, significa que has configurado la integración creando credenciales de la API manualmente, en lugar de haciendo clic en Conectar en Marketplace. Así, se crea una entrada de credenciales personalizadas en lugar de una entrada de integración de Marketplace, así que aparece sin logotipo. Personio sigue recibiendo datos de la herramienta para socios con las credenciales personalizadas, pero no vincula oficialmente la integración con la entrada de Marketplace.

Esto significa que es posible que el socio no gestione automáticamente las actualizaciones de credenciales o los cambios de autenticación por ti. Para usar la versión oficial de Marketplace, en la que el socio gestiona la integración, desconecta la entrada personalizada y vuelve a conectarla mediante Marketplace haciendo clic en Conectar en la página de la integración. Si la integración funciona y no quieres volver a configurarla, ponte en contacto directamente con el equipo de ayuda del socio para confirmar que se encargarán de las actualizaciones necesarias por su parte.

¿Por qué mi integración de Marketplace no sincroniza todos los tipos de datos?

El socio decide qué tipos de datos sincroniza su integración, no Personio. Los datos están disponibles en Personio, pero la integración del socio controla lo que consulta y envía. Si una integración no sincroniza el tipo de datos esperado, suele ser la opción de implementación de un socio. No se trata de un error que haya que solucionar. Para solicitar tipos de datos adicionales o preguntar sobre la sincronización parcial, ponte en contacto directamente con el socio.

¿Cómo vuelvo a autenticar una integración de Marketplace existente?

Si una integración de Marketplace pierde la conexión o si tienes que actualizar la autenticación después de efectuar cambios en las credenciales o la API, no hay que configurarla desde cero.

Ve a Marketplace > Integraciones conectadas y selecciona la integración.
Junto a Repetir la autenticación, haz clic en Siguiente.
Sigue los pasos para completar el flujo de autorización con el sistema de socios.
Si se te solicita, revisa la asignación de campos para confirmar que sigue siendo correcta.

Si la autenticación nueva no se completa correctamente, aparecerá un mensaje de aviso en la integración. Sigue las instrucciones para volver a conectarla.

¿Puedo activar la sincronización bidireccional para que los datos vuelvan a Personio desde una integración de terceros?

La API pública de Personio puede recibir datos de empleados, ausencia, registro de jornada y reclutamiento de sistemas externos. Sin embargo, las integraciones de Marketplace de socios solo sincronizan los datos en una dirección, normalmente de Personio al socio. Esto depende de cómo el socio haya creado la integración, no de tus permisos.

Personio no posee ni controla el código de integración del socio. Esto significa que no puede añadir la sincronización bidireccional a una integración que el socio no haya creado para que sea compatible.

Si la integración tiene un listado en Marketplace, compruébalo para obtener detalles sobre los datos que sincroniza. No des por sentado que las capacidades de una integración se basan únicamente en la ficha de Marketplace; es posible que las listas no describan el comportamiento de sincronización total. Consulta directamente al socio para confirmar qué es lo que realmente admite la integración. Los datos también pueden volver a entrar en Personio. Para ello, el socio o el equipo de IT tienen que crearla con la API de Personio. Si no estás seguro de lo que admite una integración específica, ponte en contacto directamente con el socio.

¿Por qué no puedo encontrar el atributo “Oficina” al conectar una integración?

Algunas integraciones de terceros hacen referencia al atributo del centro de trabajo de Personio como “Oficina”. Se trata del mismo concepto: la ubicación física del trabajo del empleado. Si una integración requiere el atributo “Oficina” y no puedes encontrarlo, comprueba si has configurado centros de trabajo en Personio:

Ve a Ajustes.
En la sección Organización , haz clic en Centros de trabajo.
Añade un centro de trabajo si no existe ninguno o comprueba que has configurado los centros de trabajo existentes.
Una vez que hayas configurado un centro de trabajo, el atributo Centro de trabajo estará disponible en los perfiles de los empleados. Ya se puede asignar la integración a este.

¿Por qué los datos sobre mis ausencias no se sincroniza aunque una integración de terceros aparezca como conectada?

Personio incluye una API REST, lo que significa que no envía datos de forma proactiva a las herramientas conectadas. Una integración de terceros debe solicitar (extraer) activamente los datos que necesita. Por ejemplo, necesita consultar los periodos de ausencia después de que alguien los apruebe. Personio no sabe si una herramienta de terceros hizo esa solicitud o por qué no lo hizo.

Confirma que las credenciales de API configuradas para la integración incluyan el acceso de lectura para los datos relevantes (por ejemplo, la ausencia).
Ponte en contacto con el equipo de ayuda de la integración y pídeles que comprueben los registros afectados en sus archivos.
Pueden confirmar si su sistema solicitó los datos a Personio y qué datos devolvió Personio.

Los usuarios ya no pueden iniciar sesión en un proceso de integración personalizado o de terceros. ¿Ha cambiado algo con la conexión a Personio?

Personio no puede ver los cambios realizados en Marketplace de terceros ni en las integraciones personalizadas. Si el problema persiste, ponte en contacto con el equipo de ayuda del socio en el caso una integración de Marketplace de terceros o con tu equipo de IT en el caso de una integración personalizada.

Si los usuarios no pueden iniciar sesión en Personio, se trata de un problema aparte. Obtén información sobre cómo solucionar problemas de inicio de sesión SSO.

¿Cuál es la diferencia entre deshabilitar y desconectar una integración y cuándo tengo que usar cada una de ellas?

La desactivación de una integración de Marketplace o personalizada hace que quede inactiva, pero la mantiene visible en Marketplace > Integraciones conectadas. La desconexión de una integración de Marketplace o personalizada elimina permanentemente las credenciales. Esta acción no se puede deshacer. No puedes deshabilitar una integración creada por Personio.

Si no sabes si una integración sigue en uso, primero tienes que deshabilitarla. Si no se interrumpe nada, puedes desconectarla para retirarla permanentemente.

Para deshabilitar o desconectar una integración personalizada o una integración de Marketplace de terceros, haz lo siguiente:

Ve a Marketplace > Integraciones conectadas.
En la columna Acción, haga clic en los tres puntos junto a la integración.
Haz clic en Deshabilitar o Desconectar.

¿Qué opciones tengo si la herramienta que quiero conectar no está en Marketplace?

Si quieres analizar datos de RR. HH o elaborar informes, vale la pena comprobar si el área de análisis integrado de Personio ya cubre tus necesidades. Incluye métricas, KPI y creación de informes personalizados.

Si la herramienta que buscas (por ejemplo, una herramienta de inteligencia empresarial (BI) o de análisis, como Power BI o Tableau, no aparece en la lista de Personio Marketplace, tienes dos opciones en función de lo que necesites

Utiliza una plataforma de integración: las plataformas de integración como Zapier pueden conectar Personio con muchas otras aplicaciones sin necesidad de un desarrollo personalizado. Esto funciona mejor para las automatizaciones del flujo de trabajo, por ejemplo, para activar una acción en otra herramienta cuando algo cambia en Personio. Zapier está disponible como una integración de Marketplace.
Crea un proceso de integración personalizado con la API de Personio: Si una plataforma de integración no satisface tus necesidades, puedes crear un proceso de integración personalizado con la API de Personio. Requiere el plan Core Pro. Su equipo de IT o un proveedor de IT externo es responsable de establecer la conexión. El equipo de Ayuda de Personio puede responder a las preguntas sobre la API, pero no puede ayudarte a escribir o revisar el código personalizado.

¿Por qué los documentos subidos por una integración de terceros se clasifican en la categoría incorrecta y cómo puedo solucionarlo?

Cuando una integración de terceros sube documentos a Personio a través de la API, el ID de categoría de la solicitud de la API determina la categoría del documento. Si los documentos se clasifican en la categoría incorrecta, la integración utiliza un ID de categoría incorrecto.

Para encontrar los ID de categoría correctos, llama al endpoint de categorías de documentos: GET /v1/company/document-categories

Esto devuelve una lista de todas las categorías de documentos disponibles y sus ID. Para que este endpoint funcione, las credenciales de la API necesitan permiso de lectura para Documentos. Cuando tengas el ID de categoría correcto, envíalo a la solicitud POST /v1/company/documents al subir el documento para asignarlo a la categoría correcta.

Comparte el ID de categoría correcto con el proveedor de la integración para que actualice la asignación de categorías.

Integraciones personalizadas

¿Cómo puedo saber para qué se utiliza una integración personalizada no identificada en mi cuenta?

Personio no almacena el propósito de una integración personalizada, solo recibe solicitudes de la API. Para investigar una integración no identificada, haz lo siguiente:

Ve a Marketplace > Integraciones conectadas, selecciona la integración y revisa los permisos de la API para ver a qué datos puede acceder (por ejemplo, empleados, registro de jornada o ausencias).
Comprueba internamente si alguien de la organización sabe a qué se conecta la integración. Para ello, es posible que tengas que preguntar al equipo de IT, revisar cualquier documentación interna sobre el paquete tecnológico o ponerte en contacto con la persona que haya configurado o gestionado la integración anteriormente.
Si sigues sin poder identificarlo, puedes deshabilitarla temporalmente y controlar si algo de los sistemas deja de funcionar. Si no se interrumpe nada, puedes desconectarla.

¿Por qué mi integración personalizada nueva aparece como Pendiente?

Al crear un servicio de integración personalizado en Personio, el estado aparece inicialmente como Pendiente. Esto significa que Personio está preparado para recibir solicitudes, sin que tengas que hacer nada más en Personio. El estado cambia automáticamente a Conectado una vez que la integración realiza correctamente su primera llamada a la API.

Si la integración sigue apareciendo como Pendiente, significa que aún no se ha establecido la conexión por tu parte. Compruebe que su sistema utilice correctamente el ID de cliente y la clave del cliente generados para la integración. Si necesitas solucionar un error en una llamada a la API, comprueba la solicitud completa (incluidos los encabezados y el cuerpo), el ID de cliente utilizado y la respuesta completa de la API para identificar el problema.

Slack y Microsoft Teams

¿Puedo impedir que Slack o Microsoft Teams anuncien el cumpleaños o el aniversario laboral de un empleado?

No. Las actualizaciones del canal se aplican a todos los miembros del departamento, equipo o centro de trabajo asignados a ese canal; no puedes excluir a un único empleado. Tienes dos opciones: desactivar ese tipo de evento para todo el canal o asignar la actualización a un departamento, equipo o centro de trabajo más reducido para que no se incluya al empleado.

Las actualizaciones de los canales dependen de si el estado del empleado en Personio es activo o inactivo, no del estado de inactividad temporal. Un empleado en situación de inactividad temporal o de cualquier otro tipo de ausencia sigue contando como activo y sigue apareciendo en las actualizaciones. No puedes filtrar las actualizaciones por tipo de ausencia. La única forma de excluir a un empleado concreto es marcarlo como inactivo en Personio.

¿La integración de Microsoft Teams puede incluir tipos de ubicación de trabajo, como “trabajar desde casa” o “viaje de negocios”, en sus actualizaciones diarias?

No. La integración de Teams solo envía actualizaciones diarias del canal para un conjunto fijo de eventos: fechas de ausencia y regreso de los empleados, cumpleaños, aniversarios laborales y empleados nuevos. No cubre el registro de jornada o los tipos de ubicación del trabajo, como trabajar desde casa, trabajo a distancia o viajes de negocios.

Si quieres que los compañeros vean quién está trabajando desde casa o quién está en un viaje de negocios, necesitas una integración personalizada mediante la API: usa la API de Personio para recuperar la información sobre la ausencia en la ubicación de trabajo y crear una integración personalizada que la publique en un canal de Teams de forma programada. Esto requiere el trabajo de desarrollo por parte de su equipo de IT o de un proveedor externo.

¿Puedo excluir determinados tipos de ausencia, como la baja por maternidad o paternidad, de la actualización diaria de ausencias de Slack?

No. Si una actualización incluye ausencias, se incluyen todos los tipos de ausencias. No se puede filtrar por tipo. Puedes definir a quién se aplica la actualización asignándola a un departamento, equipo o centro de trabajo específico, pero esto cambia la audiencia, no los tipos de ausencia que aparecen.

¿Puedo conectar más de un espacio de trabajo de Slack a mi cuenta de Personio?

No, solo puedes conectar un espacio de trabajo de Slack por cuenta de Personio. Si tienes una segunda entidad legal que usa un espacio de trabajo de Slack independiente, puedes usar la API de Personio como solución alternativa para enviar notificaciones de ausencia a ese espacio de trabajo. Para ello:

Utilice el endpoint de Enumerar empleados para recuperar empleados y filtrar por entidad legal.
Utilice el endpoint Enumerar periodos de ausencia para recuperar las ausencias de esos empleados.
Usa la API de Slack para publicar los resultados en un canal del espacio de trabajo adicional.

Descubre más sobre cómo configurar el acceso a la API y buscar documentación de endpoints en el Developer Hub (centro de desarrolladores).

¿Puedo hacer que Slack muestre con precisión las ausencias de medio día o por horas?

No. La funcionalidad automatizada del estado de Slack solo admite la ausencia diaria. La ausencia de medio día y por horas se muestra como ausencia de día completo en Slack. No hay ningún ajuste para cambiar esto. Los registros de ausencia en Personio se mantienen exactos. Esta limitación solo afecta a la visualización del estado de Slack.

Si necesitas que Slack refleje con precisión la ausencia de medio día, puedes crear una solución personalizada. Esta solución utiliza webhooks y endpoints de la API de Personio para activar actualizaciones de estado de Slack en función de datos específicos de ausencia. El Departamento de IT o un proveedor externo de servicios de IT son responsables de establecer la conexión. El equipo de ayuda de Personio puede responder a las preguntas sobre la API, pero no puede ayudarte a escribir o revisar el código personalizado.

¿Qué son el ID del socio y el ID de la aplicación? ¿Los necesito?

El ID del socio y el ID de la aplicación son encabezados que puedes incluir en las solicitudes de API de Personio para ayudar a identificar tu integración. Estos valores los estableces tú mismo. Personio no los genera. Si estás creando un proceso de integración personalizado, Personio recomienda encarecidamente incluir X-Persono-App-ID, ya que ayuda con la depuración y la ayuda. Obtenga más información sobre los valores y el formato en el Centro para desarrolladores.

API de reclutamiento

¿Cómo soluciono un error 404 al enviar una candidatura mediante la API de Reclutamiento?

Una respuesta 404 en POST /v1/recruiting/applications normalmente significa que el estado del puesto (de trabajo) no es Publicado. La API solo acepta candidaturas para puestos (de trabajo) publicados: los que están en borrador o en cualquier otro estado muestran un 404, incluso si el puesto existe en Personio.

Para solucionarlo, ve a Reclutamiento > Empleos, busca el puesto (de trabajo) correspondiente y confirma el estado. Si figura como borrador, cámbialo a Publicado y, a continuación, vuelve a enviar la solicitud de la API.

¿Puedo subir documentos a una candidatura de reclutamiento existente mediante la API?

No. La API solo permite adjuntar documentos al crear una candidatura, no añadirlos a una que ya existe. Si necesitas adjuntar documentos a una candidatura existente, hazlo manualmente en el perfil del candidato.

Los documentos subidos al endpoint de subida sin que se haga referencia inmediata a ellos en una llamada de creación de candidaturas no son visibles en ningún lugar de Personio. Completa siempre ambos pasos en el mismo flujo.

¿Puedo descargar documentos de los candidatos, como los CV, con la API de Personio?

Puedes descargar los documentos de las candidaturas mediante la API de gestión de documentos. La API de Reclutamiento en sí misma no incluye un endpoint de descarga de documentos, pero la API de gestión de documentos lo permite cuando usas application_id como owner_id.

Sigue estos pasos:

Genera un código de portador con las credenciales de la API a través del endpoint de autenticación.
Utiliza el endpoint Lista de candidaturas para recuperar los valores de application_id. Puedes filtrar por created_at para determinar el alcance de los resultados.
Para cada application_id, llama al endpoint Lista de metadatos del documento utilizando application_id como owner_id.
Esto devuelve los valores de document_id de los documentos adjuntos a esa candidatura.
Utiliza cada document_id con el endpoint Descargar archivo del documento para descargar el archivo.
Necesitas acceso de lectura tanto para Documentos como para Reclutamiento en las credenciales de la API.

¿Los atributos y etiquetas personalizados escritos con la API de Reclutamiento se pueden recuperar posteriormente a través de la API?

No. Los endpoints Candidatos y Candidaturas de la versión 2 no muestran atributos ni etiquetas personalizados en sus respuestas. Cuando escribes un atributo personalizado o un valor de etiqueta mediante POST, los endpoints GET de la versión 2 no lo devuelven. Si necesitas recuperar o verificar estos datos más adelante, guarda una copia en el sistema en el momento de escribir este artículo.

¿Puedo actualizar el estado de una candidatura o el estado de un candidato mediante la API de Reclutamiento?

No. Los endpoints de la API de Reclutamiento v2 (/applications, /candidates, /jobs y /applications/{id} /stage-transitions) son de solo lectura. Solo admiten las candidaturas GET. El único endpoint de escritura en la API de Reclutamiento es POST /v1/recruiting/applications, que crea una candidatura y no puede actualizar las existentes.

Para hacer un seguimiento de los cambios de fase en un sistema externo, sondea los endpoints leídos periódicamente para detectar cambios a lo largo del tiempo. Consulta en el Developer Hub (centro de desarrolladores) de Personio para ver los webhooks disponibles para los eventos de reclutamiento.

Encuentra las respuestas que buscas