Saltar al contenido principal

Encuentra las respuestas que buscas

Solucionar problemas con las integraciones y las API

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

Problemas después de la configuración

Antes de empezar

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:
  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 actúa como destinatario de las llamadas a la API: la integración del socio envía solicitudes para consultar o sincronizar datos con Personio. Si los datos no se sincronizan, solo se sincronizan parcialmente o se producen errores, lo más habitual es que se deba a que el socio no ha enviado las solicitudes necesarias o estas son incorrectas. Personio no puede ver cómo configuró el socio la integración ni si se ha producido algún cambio por su parte. Si tu integración 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. Si el socio no reporta ningún problema, pídale a su equipo técnico que revise sus registros para encontrar los registros afectados. Personio no conserva registros de la actividad de la API del socio, así que los registros del propio socio son la única forma de comprobar si ha enviado la solicitud a la API y qué respuesta ha devuelto Personio.
  3. Si el equipo técnico del socio cree que el problema reside en Personio, pídales que preparen un informe con la siguiente información:
    • La llamada completa a la API, incluidos los encabezados y el cuerpo de la solicitud.
    • El ID de cliente utilizado.
    • La respuesta completa de la API.

A continuación, el propietario de la cuenta envía este informe al equipo de ayuda de Personio y solicita que se escale 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. Su equipo de IT o el desarrollador debe evaluar la solicitud y respuesta fallidas:
    • 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.

Un atributo específico del empleado dejó de transferirse a una integración conectada

Problema

Un atributo específico de un empleado deja de transferirse a una integración de terceros conectada, aunque la integración siga conectada.

Posible solución

Comprueba si el atributo aparece en la lista de atributos de empleado que la integración puede consultar:

  1. Ve a Marketplace > Integraciones conectadas.
  2. Abra la integración que dejó de recibir el atributo.
  3. Busque la lista de atributos de empleado legibles.
  4. Utilice la barra de buscar para encontrar el atributo que falta o desplácese por la lista.
  5. Seleccione la casilla de verificación junto al atributo.
  6. Para terminar, haz clic en Update.

A partir de ese momento, la integración tendría que transferir el atributo. Si el problema persiste después de activar el atributo, ponte en contacto con el equipo de ayuda del socio de integración. Personio recibe las solicitudes de API del socio, pero no controla cómo el sistema del socio procesa los datos que recupera.

Error HTTP 410 “Credenciales incorrectas” del endpoint de autenticación

Si recibes un error HTTP 410 “Credenciales incorrectas” al realizar una solicitud POST /v1/auth, comprueba cómo estás enviando las credenciales. Tienes que enviar las credenciales en el cuerpo de la solicitud y no como parámetros de consulta de la URL:

POST https://api.personio.de/v1/auth
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret"
}

Personio ya no permite enviar credenciales como parámetros de consulta para las credenciales nuevas de API. La autenticación mediante parámetros de consulta dejará de estar disponible para todas las credenciales en diciembre de 2026. Si creaste tus credenciales de API antes de que entrara en vigor este cambio, podrás seguir utilizando la autenticación mediante parámetros de consulta hasta la fecha en que deje de estar disponible.

Personio no restringe el acceso a la API en función de las direcciones IP. Si tus llamadas a la API fallan, el problema está en el formato de la solicitud o en las credenciales, no en un bloqueo a nivel de red.

Ayùdanos a mejorar. ¿Te resulta útil esta página?