En este artículo te explicamos qué es una interfaz de programación de aplicaciones (API) pública, para qué se pueden usar las diferentes API de datos de empleados, y cómo generar credenciales de API para ellas.
¿Qué es una API pública en Personio?
Las API posibilitan el intercambio de datos entre Personio y otros servicios o herramientas. De este modo, puedes crear conexiones entre Personio y tus propias bases de datos, o configurar integraciones con otras soluciones de software disponibles en Personio Marketplace.
Actualmente, Personio ofrece varias API públicas: la API de reclutamiento, la API de informes personalizados y las cuatro API de datos de empleados (empleados, ausencias, registros de jornada y documentos).
¿Qué puedes hacer con las diferentes API de datos de empleados?
En concreto, las API de datos de empleados permiten el intercambio de información relacionada con los datos personales, los documentos, las ausencias y los registros de la jornada de los empleados, respectivamente.
Dependiendo de la API en cuestión, podrás hacer lo siguiente:
-
API de empleados
▶︎ Extraer datos de los empleados en Personio.
▶︎ Crear nuevos empleados en Personio
▶︎ Actualizar los datos de los empleados en Personio.
Ejemplo
Puedes usar la integración de MS Teams para informar a tus empleados de un canal seleccionado sobre aniversarios y cumpleaños. -
API de registro de jornada
▶︎ Extraer datos relacionados con el registro de jornada (incluido el ID del proyecto) en Personio.
▶︎ Crear registros de jornada en Personio.
▶︎ Actualizar los registros de jornada almacenados en Personio.
▶︎ Eliminar los registros de jornada en Personio.
Ejemplo
Puedes usar la integración de askDante para registrar la jornada laboral de tus empleados. Los datos sobre la jornada registrados en esta aplicación, como las horas de inicio y finalización o los descansos, se pueden transferir a Personio. -
API de ausencias
▶︎ Extraer datos relacionados con las ausencias en Personio.
▶︎ Registrar nuevas ausencias en Personio.
▶︎ Eliminar ausencias en Personio.
Ejemplo
Puedes usar la integración de Slack para que tus empleados puedan solicitar una ausencia directamente en Slack. -
API de documentos
▶︎ Extraer datos de categorías de documentos en Personio.
▶︎ Enviar un documento al perfil de un empleado en Personio (sólo es posible tras extraer datos de categorías de documentos)Ejemplo
Puedes usar la integración de Pento para guardar las nóminas generadas en Pento en el perfil del empleado correspondiente.
Generar las credenciales de API
-
- Ve a Ajustes > Integraciones > Credenciales de API.
- Haga clic en Generar nueva credencial.
- Aparecerá la barra lateral Agregar nueva credencial. En el campo Nombre, introduce un nombre descriptivo (por ejemplo, Credenciales API de los datos de documentos) para las credenciales de API.
- Si fuera necesario, selecciona una integración en el menú desplegable Integración. Si no, selecciona Otro.
- Selecciona las casillas Leer o Escribir, o ambas, para la API de datos de personal en cuestión (empleados, ausencia, registro de jornada, documentos). Si seleccionas la casilla Leer para la API de empleados, selecciona también los atributos personalizados que se transferirán a través de la API.
Consejo
Encontrarás más información sobre las diferentes casillas de verificación en el artículo Generar y administrar credenciales de API. - Haz clic en Generar nueva credencial.
- Aparecerá un mensaje confirmando que se han creado las nuevas credenciales de API.
Documentación técnica
Toda la documentación de las diferentes API de datos relacionados con los datos de los empleados, incluyendo los endpoints, la información sobre qué datos se transfieren exactamente y los tutoriales técnicos, está disponible en nuestro Centro para desarrolladores.
Para POST y PATCH, solo se admiten atributos específicos del sistema. Los atributos del sistema admitidos se enumeran en nuestro Centro de desarrollo en el ejemplo Crear un empleado. Todos los demás atributos del sistema no se admiten para hacer POST ni PATCH.