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

¿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.

¿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.

1. Ve a Análisis.
2. Haz clic en Crear informe y selecciona Informe en blanco de cambios del empleado. 
3. 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.
4. Guarda el informe.
5. En la lista de informes, selecciónalo, haz clic en Gestionar acceso a la API y selecciona Activado.
6. Ve a Marketplace > Integraciones conectadas.
7. Selecciona la integración personalizada pertinente y activa el permiso de acceso de lectura para Informes.
8. Para terminar, haz clic en Update.
9. 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.

¿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.

¿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:

• Enumerar a todos los empleados
• Consultar sobre un empleado específico

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.

¿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:

1. Ve a Marketplace > Integraciones conectadas.
2. Selecciona la integración personalizada y activa el acceso de lectura para Ausencias.
3. 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.

¿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.

¿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.

¿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.

¿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.

¿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:

1. Ve a Ajustes.
2. En la sección Organización , haz clic en Centros de trabajo.
3. Añade un centro de trabajo si no existe ninguno o comprueba que has configurado los centros de trabajo existentes.
4. 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.

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

¿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.

¿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:

1. 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.
2. 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.

¿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.

¿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.

¿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.

¿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:

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

• Más información sobre cómo configurar el acceso a la API.
• Encuentra documentación sobre los endpoints en el Centro de desarrollo (Developer Hub).

¿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.

¿Por qué mi integración sigue estando 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 Conectada una vez que la integración envía los datos. 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. Ve a Marketplace > Integraciones conectadas para confirmar el estado y, a continuación, ponte en contacto con el equipo de ayuda del socio, no con Personio, para investigarlo.

¿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.