> ## 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.

# Sage HR

> Conecta Sage HR a Iru Compliance con una API key en el encabezado X-Auth-Token y el subdominio de tu cuenta para recopilar evidencia de empleados, ausencias y directorio de equipos.

### Acerca de Sage HR

Iru llama a **`https://YOUR_SUBDOMAIN.sage.hr/api`** con:

```http theme={null}
X-Auth-Token: YOUR_API_KEY
```

Las claves son **por administrador** y heredan los permisos de ese usuario. Deshabilitar y volver a habilitar el acceso a la API **rota** la clave.

### Cómo funciona

La REST API de Sage HR acepta una **API key** en el encabezado **`X-Auth-Token`**. El asistente del conector solicita primero tu **subdominio** (para construir **`https://{subdomain}.sage.hr/api`**) y la **API key** en un paso posterior.

| Detalle | Valor |
| - | - |
| **Categoría** | HRIS |
| **Autenticación** | API key (`X-Auth-Token`) |

Referencias oficiales: [How the API works](https://support.sage.hr/en/articles/3246469-how-does-sage-hr-api-work), [Sage developer HR](https://developer.sage.com/hr/reference/).

### Requisitos previos

* Acceso de **Administrador**.
* **Subdominio** (`acme` de `https://acme.sage.hr`).

### Conectar Sage HR a Iru

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

    <Steps>
      <Step title="Inicia sesión en Sage HR">
        Abre tu sitio de Sage HR (`https://YOUR_SUBDOMAIN.sage.hr`) e inicia sesión con un **Administrador** que pueda cambiar la configuración de **Integraciones**.
      </Step>

      <Step title="Abre el menú de tu perfil">
        Selecciona **Nombre** (tu perfil) en el encabezado de Sage HR para abrir el menú de la cuenta.
      </Step>

      <Step title="Abre Settings">
        Elige **Configuración** (o **Company settings**, según la edición de Sage HR).
      </Step>

      <Step title="Abre Integrations y API">
        Navega a **Integraciones** y luego a **API** (las etiquetas pueden ser **Integraciones** → **API access**).
      </Step>

      <Step title="Habilita el acceso a la API">
        Activa o selecciona **Enable API Access** y confirma cualquier aviso que muestre Sage HR sobre el acceso a los datos.
      </Step>

      <Step title="Copia la API key">
        Copia la **API key** que muestra Sage HR y guárdala de forma segura. La usarás como valor de **`X-Auth-Token`** en Iru.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**Sage HR**](#sage-hr).
    </Note>

    <Steps>
      <Step title="Abre 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="Activa Sage HR">
        Busca **Sage HR** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **toggle**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Introduce el subdominio">
        Introduce el **subdominio** cuando el asistente lo solicite.
      </Step>

      <Step title="Pega el valor del encabezado de la API key">
        Pega el valor de **`X-Auth-Token`** cuando se te solicite.
      </Step>

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

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta **Sage HR** 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="401 Unauthorized">
    La clave se rotó: vuelve a copiarla después de volver a habilitar el acceso.
  </Accordion>

  <Accordion title="Tenant incorrecto">
    Corrige el **subdominio**.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

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

  <Card title="Primeros pasos con 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="Administración de Artifacts" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>
