> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Personio

> Conecta Personio con Automations usando tus propias credenciales de API de Personio, sin ventana de inicio de sesión

Conecta Personio para leer tus datos de RR. HH. en automatizaciones: personas, contratos, ausencias, asistencias, proyectos y documentos. Personio no tiene una ventana de inicio de sesión para otras apps. En su lugar, creas credenciales de API en tu cuenta de Personio y pegas su Client ID y su secreto en Famulor.

Lo que obtienes: las **acciones** de Personio en el [App Catalog](/es/automations/app-catalog). Todas leen datos; Personio no ofrece disparadores aquí.

| Acción | Qué devuelve |
| - | - |
| List persons | Las personas actuales, filtradas por identidad, estado o fecha de creación |
| List person employments | Los contratos de una persona, con estado, tipo y jornada |
| List absence periods | Las ausencias filtradas por persona, tipo de ausencia o periodo |
| List absence types | Los tipos de ausencia configurados en tu empresa |
| List attendance periods | Las asistencias filtradas por personas, proyectos, estado o fechas |
| List projects | Los proyectos de registro de tiempo |
| List documents | Los metadatos de los documentos de una persona, opcionalmente por categoría y fecha |
| List document categories | Las categorías de documentos y sus ID |
| List employee attributes | Los atributos estándar y personalizados que las credenciales pueden leer |
| List employee records | Las fichas de empleados con los atributos que elijas |

## Antes de empezar

* Eres usuario de Personio con **derechos de acceso a la API**. Sin ellos, Personio no te deja crear credenciales de API.
* Tu espacio de trabajo de Famulor incluye la plataforma de automatización en su plan, y eres propietario o administrador del espacio.

El Client ID y el secreto se quedan en el conector de apps; Famulor nunca los guarda en tu espacio de trabajo.

## Paso 1 — Crear credenciales de API en Personio

1. En Personio, abre **Marketplace → Connected integrations** y ve a **API credentials**.
2. Crea credenciales nuevas y dales un nombre que reconozcas, por ejemplo *Famulor*.
3. Activa el **acceso de lectura** a los datos que necesitan tus automatizaciones. **Personas** es obligatorio, porque Famulor lo usa para comprobar la conexión. Añade ausencias, asistencias, proyectos, documentos y atributos de empleados si quieres usar esas acciones.
4. Guarda y copia el **Client ID** y el **Client secret**. Personio muestra el secreto solo una vez. Si lo pierdes, restablece las credenciales y usa el par nuevo.

## Paso 2 — Conectar en Famulor

1. Ve a **Automations → Connections** y haz clic en **New connection**.
2. Abre el **App marketplace**, busca **Personio** y selecciónalo.
3. Introduce el **Client ID** y el **Client secret**. El nombre de la conexión es opcional; si lo dejas vacío, se llama *Personio*.
4. Haz clic en **Conectar Personio**.

Famulor comprueba las credenciales con Personio al momento. Si todo va bien, la conexión aparece como **ok** en la lista de conexiones y las acciones de Personio están disponibles en todas las automatizaciones del espacio de trabajo.

## Solución de problemas

| Mensaje | Qué significa | Solución |
| - | - | - |
| *Personio rechazó el ID de cliente o el secreto* | Un error al copiar, o el secreto se restableció en Personio. | Copia de nuevo ambos valores, o restablece las credenciales y usa el par nuevo. |
| *Personio aceptó las credenciales, pero no pueden leer empleados* | Las credenciales no tienen acceso de lectura a personas. | Edita las credenciales en Personio, activa el acceso de lectura a personas y vuelve a conectar. |
| Un paso de la automatización falla con un error de permisos | A las credenciales les falta acceso de lectura a esos datos. | Añade el acceso de lectura en Personio y luego elige **Reemplazar credenciales** en la conexión de Famulor. |

## Reconectar y eliminar

* **Reemplazar credenciales:** abre la conexión en Automations → Connections y elige **Editar**. Introduce el nuevo Client ID y el nuevo secreto; Famulor reemplaza las credenciales guardadas en un solo paso.
* **Eliminar:** al borrar la conexión también se eliminan las credenciales del conector de apps. Las automatizaciones que la usaban muestran *Connect needed* hasta que vuelvas a conectar Personio.
* Para revocar el acceso desde Personio, borra o restablece las credenciales de API en Personio.

## Relacionado

* [App Catalog](/es/automations/app-catalog)
* [Referencia de nodos de automatización](/es/automations/nodes)
* [Resumen de automatizaciones](/es/automations/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.