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

# Deel

> Conecta Deel a Iru Compliance con un token de API de organización con alcance limitado para recopilar la nómina de trabajadores, la estructura de la organización y los registros de ausencias como evidencia de incorporación y baja.

### Acerca de Deel

Iru lee **trabajadores**, la **estructura de la organización y de las entidades legales** y los **registros de ausencias** desde la API de Deel. La autenticación usa un **token de API de organización** creado en el **Developer Center** de tu panel de Deel. Los tokens están **vinculados a alcances** desde su creación. Concede solo los alcances de **lectura** que requieran tus controles.

### Cómo funciona

```http theme={null}
Authorization: Bearer YOUR_API_TOKEN
```

Deel se autentica con un token **Bearer** contra `https://api.letsdeel.com/rest`. No hay ningún subdominio que configurar.

Deel ofrece tokens de **organización** y **personales**. Un **token personal** está vinculado a la persona que lo creó y **caduca cuando esa persona deja tu empresa**, lo que puede detener la recopilación de evidencia sin previo aviso, incluso durante la baja. Un **token de organización** no está vinculado a ninguna persona y no caduca. Usa un token de organización.

| Detalle | Valor |
| - | - |
| **Categoría** | HRIS |
| **Autenticación** | Bearer (token de API de organización) |

Referencias oficiales: [Autenticación](https://developer.deel.com/api/authentication), [Cómo usar la API de Deel](https://help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API).

### Requisitos previos

* Un rol de **Administrador de la organización** o **IT Developer Admin** en Deel. Solo estos roles pueden generar tokens de API.
* Decide qué alcances conceder. Los alcances de Deel son específicos de lectura, por lo que puedes recopilar evidencia de la nómina de trabajadores y de las bajas sin exponer datos de compensación.

### Conectar Deel a Iru

<Tabs>
  <Tab title="Deel">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Iniciar sesión en Deel">
        Inicia sesión en Deel como **Administrador de la organización** o **IT Developer Admin**.
      </Step>

      <Step title="Abrir el Developer Center">
        Ve a **Apps & Integrations** → **Developer Center**.
      </Step>

      <Step title="Crear un token de API de organización">
        Selecciona **Create API Token** y elige **Organización** como tipo de token. No elijas **Personal**. Un token personal caduca cuando su propietario deja la empresa.
      </Step>

      <Step title="Asignar un nombre al token">
        Introduce un nombre de token como **Iru Compliance** y, a continuación, continúa.
      </Step>

      <Step title="Seleccionar alcances de solo lectura">
        Selecciona los alcances de **solo lectura** que cubran la evidencia que necesitas: `people:read` para la nómina de trabajadores, `organizations:read` para la estructura de entidades legales y de la organización, y `time-off:read` si algún control depende de los registros de ausencias. Concede `payslips:read` solo si un control requiere datos de nóminas.
      </Step>

      <Step title="Generar y copiar el token">
        Selecciona **Generar** y, a continuación, copia el valor del token **una sola vez** mientras Deel lo muestra.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Termina primero la pestaña [**Deel**](#deel).
    </Note>

    <Steps>
      <Step title="Abrir Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activar Deel">
        Busca **Deel** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Pegar el token Bearer">
        Pega el token en el campo **Bearer**.
      </Step>

      <Step title="Finalizar la conexión">
        Selecciona **Enviar token de Bearer**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirmar que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos** y, a continuación, vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Deel** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="No puedes acceder al Developer Center">
    Tu rol en Deel no es **Administrador de la organización** ni **IT Developer Admin**. Pide a alguien con uno de esos roles que genere el token.
  </Accordion>

  <Accordion title="La autenticación falla">
    Confirma que el token está completo y no se ha revocado, y comprueba que el valor no se haya truncado al copiarlo.
  </Accordion>

  <Accordion title="Faltan algunos registros">
    Al token le falta el alcance de lectura correspondiente. Los alcances de Deel se fijan al crear el token. Genera un nuevo token con los alcances que necesitas.
  </Accordion>

  <Accordion title="La recopilación se detuvo después de que un empleado se fuera">
    Se usó un token **personal** que caducó con su propietario. Sustitúyelo por un token de **organización**.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Usa un token de organización" icon="circle-info">
    Usa un token de **organización**, no un token **personal**. Los tokens personales caducan cuando su propietario deja la empresa y pueden detener la recopilación de evidencia durante la baja.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>