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

> Verbinden Sie Deel über ein Organisations-API-Token mit eingeschränkten Scopes mit Iru Compliance, um Mitarbeiterliste, Organisationsstruktur und Abwesenheitsdaten als Nachweise für Onboarding und Offboarding zu erfassen.

### Über Deel

Iru liest **Mitarbeitende**, die **Struktur von Organisation und juristischen Personen** sowie **Abwesenheitsdaten** über die Deel API. Die Authentifizierung erfolgt über ein **Organisations-API-Token**, das im **Developer Center** Ihres Deel-Dashboards erstellt wird. Tokens werden bei der Erstellung an **Scopes gebunden**. Gewähren Sie nur die **Lese**-Scopes, die Ihre Kontrollen erfordern.

### So funktioniert es

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

Deel authentifiziert sich mit einem **Bearer**-Token gegenüber `https://api.letsdeel.com/rest`. Es muss keine Subdomain konfiguriert werden.

Deel bietet **Organisations**- und **persönliche** Tokens an. Ein **persönliches Token** ist an die Person gebunden, die es erstellt hat, und **läuft ab, wenn diese Person Ihr Unternehmen verlässt**. Dadurch kann die Erfassung von Nachweisen ohne Vorwarnung stoppen, auch während des Offboardings. Ein **Organisationstoken** ist an keine Einzelperson gebunden und läuft nicht ab. Verwenden Sie ein Organisationstoken.

| Detail | Wert |
| - | - |
| **Kategorie** | HRIS |
| **Authentifizierung** | Bearer (Organisations-API-Token) |

Offizielle Referenzen: [Authentifizierung](https://developer.deel.com/api/authentication), [So verwenden Sie die Deel API](https://help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API).

### Voraussetzungen

* Eine Rolle als **Organisationsadministrator** oder **IT Developer Admin** in Deel. Nur diese Rollen können API-Tokens generieren.
* Legen Sie fest, welche Scopes Sie gewähren. Die Scopes von Deel sind leseorientiert, sodass Sie Nachweise zu Mitarbeiterliste und Offboarding erfassen können, ohne Vergütungsdaten offenzulegen.

### Deel mit Iru verbinden

<Tabs>
  <Tab title="Deel">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei Deel anmelden">
        Melden Sie sich bei Deel als **Organisationsadministrator** oder **IT Developer Admin** an.
      </Step>

      <Step title="Developer Center öffnen">
        Gehen Sie zu **Apps & Integrations** → **Developer Center**.
      </Step>

      <Step title="Organisations-API-Token erstellen">
        Wählen Sie **Create API Token** und als Tokentyp **Organisation** aus. Wählen Sie nicht **Personal**. Ein persönliches Token läuft ab, wenn seine Inhaberin bzw. sein Inhaber das Unternehmen verlässt.
      </Step>

      <Step title="Token benennen">
        Geben Sie einen Tokennamen wie **Iru Compliance** ein und fahren Sie fort.
      </Step>

      <Step title="Schreibgeschützte Scopes auswählen">
        Wählen Sie **schreibgeschützte** Scopes aus, die die benötigten Nachweise abdecken: `people:read` für die Mitarbeiterliste, `organizations:read` für juristische Personen und Organisationsstruktur sowie `time-off:read`, wenn eine Kontrolle von Abwesenheitsdaten abhängt. Gewähren Sie `payslips:read` nur, wenn eine Kontrolle Lohnabrechnungsdaten erfordert.
      </Step>

      <Step title="Token generieren und kopieren">
        Wählen Sie **Generieren** aus und kopieren Sie den Tokenwert, solange Deel ihn **einmalig** anzeigt.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Deel**](#deel) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen** aus.

        <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="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Deel aktivieren">
        Suchen Sie **Deel** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich eine Browser-Registerkarte oder ein Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Bearer-Token einfügen">
        Fügen Sie das Token in das Feld **Bearer** ein.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **Bearer-Token senden** aus. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Prüfen, ob die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und vergewissern Sie sich, dass die Karte **Deel** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Überprüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="Sie können das Developer Center nicht aufrufen">
    Ihre Deel-Rolle ist nicht **Organisationsadministrator** oder **IT Developer Admin**. Bitten Sie eine Person mit einer dieser Rollen, das Token zu generieren.
  </Accordion>

  <Accordion title="Authentifizierung schlägt fehl">
    Vergewissern Sie sich, dass das Token vollständig ist und nicht widerrufen wurde, und prüfen Sie, ob der Wert beim Kopieren nicht abgeschnitten wurde.
  </Accordion>

  <Accordion title="Einige Datensätze fehlen">
    Dem Token fehlt der passende Lese-Scope. Die Scopes von Deel werden bei der Erstellung festgelegt. Generieren Sie ein neues Token mit den benötigten Scopes.
  </Accordion>

  <Accordion title="Die Erfassung stoppte, nachdem ein Mitarbeiter das Unternehmen verlassen hat">
    Es wurde ein **persönliches** Token verwendet, das mit dem Ausscheiden seines Inhabers abgelaufen ist. Ersetzen Sie es durch ein **Organisations**token.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Organisationstoken verwenden" icon="circle-info">
    Verwenden Sie ein **Organisations**token, kein **persönliches** Token. Persönliche Tokens laufen ab, wenn ihr Inhaber das Unternehmen verlässt, und können die Erfassung von Nachweisen während des Offboardings stoppen.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>
