En este artículo te explicamos cómo generar y administrar (actualizar, desactivar, volver a activar y eliminar) las credenciales para las API de datos de empleados y la API de informes personalizados de Personio.
Las credenciales de la API de reclutamiento se generan en el sistema y no las gestionan los administradores.
¿Qué son las credenciales de API en Personio?
Las credenciales de API posibilitan el intercambio de datos entre Personio y otros servicios o herramientas. De este modo, puedes crear conexiones entre Personio y tu propio sistema, o configurar integraciones con otras soluciones de software disponibles en Personio Marketplace. Deberás introducir las credenciales de API siempre que quieras activar una integración.
Nota
Las credenciales de API ayudan a proteger la comunicación entre aplicaciones y a evitar el acceso no autorizado y las posibles violaciones de datos. Por razones de seguridad, te recomendamos generar credenciales de API diferentes para cada integración.
Generar las credenciales de API
- Ve a Ajustes > Integraciones > Credenciales de API.
- Haz clic en Generar nueva credencial en la parte superior derecha de la pantalla.
- Aparecerá la barra lateral Añadir nueva credencial. En el campo Nombre, introduce un nombre descriptivo para las credenciales (por ejemplo, «Integración con Greenhouse» o «Informes personalizados»).
- Si fuera necesario, selecciona la integración correspondiente en el menú desplegable Integración. Si no, selecciona Otro.
- Utiliza las casillas para configurar los niveles de acceso deseados. Si has seleccionado una integración, se preseleccionarán los niveles de acceso recomendados.
▶︎ Empleados: selecciona Leer para permitir que los sistemas de terceros puedan extraer los datos de los empleados a partir de Personio y Editar para permitir que puedan crear y actualizar datos en Personio.
▶︎ Registro de jornada: selecciona Leer para permitir que los sistemas de terceros puedan extraer los datos del registro de la jornada a partir de Personio y Editar para permitir que puedan crear, actualizar y eliminar registros de jornada en Personio.
▶︎ Ausencias: selecciona Leer para permitir que los sistemas de terceros puedan extraer los datos de las ausencias a partir de Personio y Editar para permitir que puedan crear y eliminar ausencias en Personio.
▶︎ Documentos: selecciona Leer para permitir que los sistemas de terceros puedan extraer los ID de las categorías de documentos a partir de Personio. Esto será necesario si buscas usar el permiso Editar para que puedan enviar documentos a un perfil de empleado de Personio.
▶︎ Informes personalizados: selecciona Leer para permitir que los sistemas de terceros puedan extraer todos los informes personalizados existentes a partir de Personio. Infórmate sobre la API de informes personalizados de Personio.
Nota
Si seleccionas la casilla «Informes personalizados», permites que todos los atributos que se añadan a un informe personalizado se puedan extraer, independientemente de si el atributo se ha incluido en la lista blanca como Atributos de empleado legibles o no. - Si seleccionas Leer junto a Empleados, aparecerá el menú desplegable Atributos de empleado legibles. Selecciona los atributos de empleado que quieras que se transfieran desde Personio. Si has seleccionado una integración, se preseleccionarán los atributos recomendados.
Consejo
Para obtener más información sobre los niveles de acceso que deben asignarse a una integración determinada, lee el artículo relacionado en la sección Integraciones. - Para generar las credenciales de API (ID de cliente y secreto), haz clic en Generar nueva credencial. Aparecerá un mensaje confirmando que se han creado las nuevas credenciales.
Nota
Necesitarás el ID de cliente y el secreto para activar la integración correspondiente. Encontrarás más información en nuestro artículo Activar integraciones del Marketplace. Tus credenciales pueden usarse para acceder a datos de la cuenta y deben protegerse como si de una contraseña se tratara. Preserva la confidencialidad de las credenciales. No las compartas con terceros.
Gestionar las credenciales de API
Actualizar las credenciales de API
Si quieres actualizar el nombre de las credenciales de API, los niveles de acceso o los atributos de empleado legibles, sigue los pasos a continuación. No es posible actualizar el ID de cliente ni el secreto.
- Ve a Ajustes > Integraciones > Credenciales de API.
- Haz clic en las credenciales en cuestión.
- Haz las actualizaciones necesarias desde la barra lateral que habrá aparecido.
- Haz clic en Guardar para aplicar las actualizaciones.
Desactivar las credenciales de API
Si deseas desactivar temporalmente las credenciales de API, sigue estos pasos:
- Ve a Ajustes > Integraciones > Credenciales de API.
- En la lista de todas las credenciales de API existentes, cambia el interruptor junto a las credenciales correspondientes a Desactivado.
- Las credenciales de API se deshabilitarán y el intercambio de datos se detendrá hasta que se vuelvan a habilitar.
Reactivar las credenciales de API
Si quieres volver a habilitar las credenciales de API cuyo funcionamiento esté deshabilitado temporalmente, sigue estos pasos:
-
- Ve a Ajustes > Integraciones > Credenciales de API.
- En la lista de todas las credenciales de API existentes, cambia el interruptor junto a las credenciales correspondientes a Activado.
- Las credenciales se volverán a habilitar y se reanudará el intercambio de datos.
Eliminar credenciales de API
Si quieres suprimir las credenciales de API y detener permanentemente su funcionamiento, sigue estos pasos:
-
- Ve a Ajustes > Integraciones > Credenciales de API.
- Haz clic en las credenciales en cuestión.
- En la barra lateral que aparece, haz clic en el icono de la papelera
y confirma que deseas eliminar las credenciales de API.
- Las credenciales se eliminarán de forma permanente.
Documentación técnica
Toda la documentación de nuestras API, incluidos los endpoints, la información precisa sobre qué datos se transfieren y los tutoriales técnicos, está disponible en nuestro Centro para desarrolladores.