Este artículo te ayudará a solucionar problemas relacionados con las integraciones y las API en Personio. Los pasos que se deben seguir dependen de quién haya creado la integración. Personio no crea ni mantiene todas las integraciones. Averigua quién desarrolló tu integración antes de empezar a solucionar problemas.

Este artículo aborda los siguientes temas:

Problema durante la configuración

• El botón Continuar del asistente de configuración de la integración no responde

Problemas después de la configuración

• Descubre quién desarrolló tu integración
• Una integración de Marketplace creada por Personio no funciona
• Una integración de Marketplace de terceros no funciona
• Un Marketplace de terceros o una integración personalizada devuelve códigos de error al sincronizar la información sobre la ausencia
• Una integración que no está en el Marketplace no funciona
• El webhook de Greenhouse se activa, pero Personio no crea un perfil del empleado
• La integración de Entra ID muestra un error por “privilegios insuficientes para completar la operación” (403)
• La integración de Google Directory Sync desactiva continuamente la cuenta de Google de un empleado recontratado
• Una integración de Marketplace permanece en estado Pendiente aunque la herramienta del socio la muestre como activo

Antes de empezar

• Comprueba que tienes los permisos de acceso correctos para ver y gestionar las integraciones.
• Si tienes problemas con las credenciales de la API, consulta cómo generar y gestionar credenciales de API.

El botón Continuar del asistente de configuración de la integración no responde

Problema

Al configurar una integración en el Marketplace, hacer clic en Continuar en el asistente de configuración no tiene ningún efecto. El motivo suele ser una extensión del navegador, un servidor proxy o una configuración de red corporativa que bloquea el JavaScript de la página.

Posible solución

1. Abre Personio en una ventana de navegación privada o de incógnito y reinicia el asistente de configuración. Esto desactiva las extensiones del navegador que puedan estar interfiriendo con la página.
2. Si el botón sigue sin responder, intenta conectarte desde una red diferente. Por ejemplo, desde un punto de acceso móvil en lugar de la red de la empresa.

Descubre quién desarrolló tu integración

Antes de solucionar problemas, comprueba quién desarrolló tu integración. Los pasos que debes seguir y quién puede ayudarte dependen de esto. Para averiguarlo:

1. Ve a Marketplace y busca la integración.
2. Si aparece la integración, ábrela y comprueba el campo Desarrollado por en los Detalles de la aplicación:
   • Muestra Personio: soluciona problemas en una integración de Marketplace creada con Personio.
   • Muestra un nombre de terceros: soluciona problemas en una integración de Marketplace de terceros.
3. Si la integración no aparece en el Marketplace, soluciona el problema de una integración que no se encuentra en el Marketplace.

Una integración de Marketplace creada por Personio no funciona

Problema

Las integraciones que desarrolla Personio son las únicas integraciones de Marketplace que incluyen una pestaña de Supervisión. Si la tuya ha dejado de funcionar o no se sincroniza, la pestaña Supervisión es el primer lugar donde debe comprobarlo.

Posible solución

1. Ve a Marketplace > Integraciones conectadas y confirma que la integración sigue apareciendo como conectada.
2. Consulta la pestaña Supervisión para ver el estado de sincronización y los detalles de todos los errores.
3. Si eso no resuelve el problema, los propietarios de la cuenta pueden ponerse en contacto con el servicio de asistencia. 

Una integración de Marketplace de terceros no funciona

Problema

Son socios externos, no Personio, quienes desarrollan y mantienen las integraciones de Marketplace de terceros. Personio no puede ver cómo configuró el socio la integración ni por qué dejó de funcionar. Si la tuya ha dejado de funcionar o no se sincroniza, el equipo de ayuda del socio es el responsable de solucionar el problema.

Posible solución

1. Ponte en contacto con el equipo de ayuda del socio. Puedes encontrar sus detalles de contacto en la barra lateral derecha de la página de la integración en el Marketplace.
2. Personio actúa como receptor de las llamadas a la API. La integración del socio envía solicitudes para recuperar o sincronizar datos con Personio. Si esto no sucede, sucede solo parcialmente o produce errores, la causa suele ser la falta de solicitudes o solicitudes incorrectas por parte del socio. Personio no tiene visibilidad sobre cómo el socio ha configurado la integración ni si se produjo algún cambio por su parte. El socio se encarga de crear y mantener la integración, no Personio.
3. Si el socio no informa de ningún problema por su parte, pídale a su equipo técnico que revise sus registros específicamente en busca de los registros afectados, incluyendo si enviaron la solicitud de API y qué respuesta ha devuelto Personio. Personio no conserva registros de la actividad de la API del socio, así que los registros del socio son el único lugar donde se puede confirmar esto.
4. Si después de eso el problema requiere una investigación más profunda:
   • Para clientes: Los propietarios de cuenta pueden ponerse en contacto con Ayuda para solicitar una revisión superficial. Personio no puede garantizar una solución ni realizar una revisión exhaustiva del código ni ofrecer servicios de consultoría. Para facilitar la revisión, pídale a su equipo de IT o al desarrollador: la llamada completa a la API, incluidos los encabezados y el cuerpo, el ID de cliente utilizado y la respuesta completa de la API.
   • Para los socios de integración: si su equipo técnico ha agotado la investigación y cree que el problema reside en Personio, el propietario de la cuenta del cliente puede ponerse en contacto con Ayuda y solicitar que el caso se derive al equipo de gestión de socios de Personio.

Un Marketplace de terceros o una integración personalizada devuelve códigos de error al sincronizar la información sobre la ausencia

Problema

Una integración conectada devuelve códigos de error de API al intentar sincronizar la información sobre la ausencia con Personio. Los códigos de error indican por qué Personio ha rechazado la solicitud.

Posible solución

Utilice el código de error y el mensaje que le ha devuelto su herramienta de integración para identificar la causa y aplicar la solución correspondiente que se indica a continuación.

422 — No hay asignada ninguna política al empleado

El empleado no tiene asignada una política de ausencias para el tipo de ausencia que la integración está intentando sincronizar. Acceda al perfil del empleado, abra la pestaña “Ausencias” y confirme que se ha asignado una política para el tipo correspondiente. Si no se ha asignado ninguna, añada la correcta y pida a la integración que lo intente de nuevo.

400 — Periodos de ausencias que se solapan

Personio no permite que dos entradas de ausencia cubran el mismo periodo para el mismo empleado. Elimine la ausencia existente en Personio antes de que la integración intente sincronizar el periodo que se solapa.

404 — No se ha encontrado al empleado

Esto puede indicar que la integración está enviando un ID de empleado que no existe en Personio. Verifique que los ID de empleado que transmite la integración coincidan con los ID de empleado de su cuenta de Personio. Para otros casos de error 404, póngase en contacto con el equipo de ayuda del socio de integración.

Una integración que no está en el Marketplace no funciona

Problema

Una integración que no aparece en el Marketplace es una integración personalizada. Personio no la ha creado ni se encarga de su mantenimiento. Tu equipo de TI o un desarrollador externo que no sea socio de Personio lo configuró directamente a través de la API. La resolución de problemas es su responsabilidad.

Posible solución

1. Ponte en contacto con tu equipo de TI o con el desarrollador que creó la integración. Son los responsables de solucionar el problema y tendrán acceso a los detalles técnicos que Personio no puede ver.
2. Personio actúa como receptor de las llamadas a la API. Tu integración envía solicitudes para recuperar o sincronizar datos con Personio. Si esto no sucede, sucede solo parcialmente o produce errores, la causa suele ser la falta de solicitudes o solicitudes incorrectas por parte tu parte.
3. Si el problema requiere una investigación más exhaustiva, los propietarios de la cuenta pueden ponerse en contacto con el servicio de asistencia para solicitar una revisión superficial. Personio no puede garantizar una solución ni realizar una revisión exhaustiva del código ni ofrecer servicios de consultoría. Solicita lo siguiente a tu equipo de TI o desarrollador:
   • La llamada completa a la API, incluyendo los encabezados y, si corresponde, el cuerpo.
   • El ID de cliente utilizado.
   • La respuesta completa de la API.

El webhook de Greenhouse se activa, pero Personio no crea un perfil del empleado

Problema

El webhook de Greenhouse se activa, pero Personio no crea un perfil del empleado

Solución

Sigue estos pasos.

1. Confirma que el candidato tenga el estado “Contratado” en Greenhouse. La integración solo crea un perfil de Personio cuando el candidato pasa explícitamente a la categoría de “Contratado” en Greenhouse. Trasladarlo a otra fase o hacer que avance en el workflow de una oferta de trabajo sin actualizar la fase en Greenhouse no permite crear su perfil.
2. Verifique que los campos obligatorios se hayan rellenado en el registro de Greenhouse del candidato. La sincronización del proceso de contratación requiere que el nombre, los apellidos y el correo electrónico del candidato figuren en su registro de Greenhouse. Si alguno de estos campos está vacío, Personio no crea el perfil. Verifique el registro del candidato directamente en Greenhouse. Se trata de una comprobación de la integridad de los datos, no de una comprobación de la asignación de atributos.
3. Comprueba si el correo electrónico está duplicado en Personio. Si ya existe un perfil del empleado en Personio con el mismo correo electrónico que el del candidato contratado, Personio no puede crear un segundo perfil. Ve a Organización > Lista de personal y busca el correo electrónico del candidato para confirmar que ningún perfil existente lo esté utilizando.

La integración de Entra ID muestra un error por “privilegios insuficientes para completar la operación” (403)

Problema

La integración de Entra ID no sincroniza a ciertos empleados y muestra un error 403 Prohibido o “Privilegios insuficientes para completar la operación”, mientras que otros empleados sí se sincronizan. 

Solución

Personio no puede determinar cuál de estas opciones se aplica. Tienes que investigar la causa directamente en Microsoft Entra ID.

1. Comienza por volver a autenticar la integración. Ve a Marketplace > Integraciones conectadas. Selecciona Microsoft Entra ID y haz clic en Repetir autenticación.
2. Si sigues teniendo el mismo error después de repetir la autenticación, es posible que las cuentas afectadas en Microsoft Entra ID tengan una configuración que restrinja el acceso a la integración. Consulta al equipo de IT las siguientes causas posible:
   • Roles privilegiados: la cuenta tiene permisos de Administrador global, Administrador con privilegios o un rol con privilegios similares. Asigna un rol superior a la aplicación de integración para que pueda actualizar las cuentas. Para obtener más información sobre los permisos de administrador, visite la documentación de Microsoft sobre funciones y privilegios.
   • Cuentas de emergencia: esta cuenta es una cuenta de acceso de emergencia protegida y está restringida deliberadamente para que no reciba actualizaciones automáticas.
   • Sincronización del AD local: un Active Directory local administra la cuenta. Solo se pueden modificar algunos atributos en el entorno local, no en la nube.
   • Estado de invitado frente a estado de miembro: la cuenta está configurada como usuario invitado en lugar de miembro. También podría tener una asignación de licencia diferente a la de otras cuentas.
   • Unidades administrativas: la cuenta pertenece a una unidad administrativa restringida que limita qué aplicaciones pueden modificarla.
   • Políticas de acceso condicional: una política bloquea los cambios en esa cuenta específica.

La integración de Google Directory Sync desactiva continuamente la cuenta de Google de un empleado recontratado

Problema

Cuando vuelves a contratar a un empleado, Personio crea un perfil con un ID de empleado nuevo. El campo externalID de Google Directory puede vincular la cuenta de Google existente del empleado con el antiguo ID de empleado de Personio, que está ahora inactivo. Debido a que la integración lee ese externalID y encuentra un perfil inactivo, desactiva la cuenta de Google en cada ciclo de sincronización. Esto sucede incluso aunque el empleado esté activo en Personio. 

Solución

Retira el antiguo ID de empleado de Personio del campo externalID de la cuenta de Google en la que se produce este problema. Hazlo a través de la API de Google Directory.

Una vez borrado el campo externalID, la integración vuelve a vincular la cuenta de Google con el perfil nuevo de Personio que el empleado tiene activo. Esto ocurrirá durante la siguiente sincronización.

Una integración de Marketplace permanece en estado Pendiente aunque la herramienta del socio la muestre como activo

Problema

La integración muestra el estado Pendiente en Personio, pero la herramienta del socio lo muestra como activo por su parte. Esto suele significar que la integración se ha conectado utilizando credenciales personalizadas creadas manualmente en lugar de las credenciales predefinidas que genera Personio cuando te conectas a través del Marketplace. Algunas integraciones, como las herramientas de reclutamiento, necesitan esas credenciales predefinidas para establecer una conexión válida.

Solución

1. Ve a Marketplace > Integraciones conectadas.
2. Selecciona la integración.
3. Haz clic en Desconectar.
4. Ve a Marketplace y busca la integración.
5. Haz clic en Conectar
6. Haga clic en Generate new API credential (Generar otras credenciales) para generar automáticamente otras credenciales de la API con los permisos que necesita la integración.