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

# Mitarbeiter

> Mitarbeiterstammdaten, Tenant-Zuordnung, Divisionszuweisung, Kontosperrung und Synchronisationsoperationen.

Mitarbeiter sind kundenspezifische Stammdatenressourcen. Die Public API unterstützt Auflisten, Erstellen, Abrufen und partielle Aktualisierung.

## Funktionen

| Funktion                            | Unterstützt | Hinweise                                                  |
| ----------------------------------- | ----------: | --------------------------------------------------------- |
| Mitarbeiter auflisten und filtern   |          Ja | Über alle Tenants des Keys oder einen ausgewählten Tenant |
| Mitarbeiter erstellen               |          Ja | Sendet beim realen Create eine E-Mail zur Passwortvergabe |
| Unterstützte Felder aktualisieren   |          Ja | Nur geänderte Felder patchen                              |
| Geschäftliche E-Mail-Adresse ändern |        Nein | Über Public Update nicht patchbar                         |
| Division ändern                     |          Ja | Innerhalb desselben Tenants und zulässigen Scopes         |
| Tenant wechseln                     |        Nein | Für zugeordnete Mitarbeiter nicht angeboten               |
| Sperren oder entsperren             |          Ja | Über `blocked`                                            |
| Mitarbeiter löschen                 |        Nein | Keine öffentliche Delete-Operation                        |

## Lifecycle

```mermaid theme={"theme":{"light":"github-light","dark":"github-dark"}}
flowchart LR
    A[Tenant und Division auflösen] --> B[POST Dry Run]
    B --> C[POST Create]
    C --> D[JobHandy-ID speichern]
    D --> E[Unterstützte Felder per GET und PATCH pflegen]
    E --> F[Bei Bedarf sperren oder entsperren]
```

## Endpoints

<CardGroup cols={2}>
  <Card title="Mitarbeiter auflisten" icon="list" href="/de/api-reference/employees/list-employees">
    Mitarbeiter-Collections paginieren, filtern, sortieren und einschränken.
  </Card>

  <Card title="Mitarbeiter erstellen" icon="user-plus" href="/de/api-reference/employees/create-employee">
    Zuordnung validieren und Konto erstellen.
  </Card>

  <Card title="Mitarbeiter abrufen" icon="user" href="/de/api-reference/employees/get-employee">
    Einen Mitarbeiter über seine undurchsichtige ID abrufen.
  </Card>

  <Card title="Mitarbeiter aktualisieren" icon="user-pen" href="/de/api-reference/employees/update-employee">
    Unterstützte Felder, Divisionszuordnung und Sperrstatus patchen.
  </Card>
</CardGroup>

## Zentrale Regeln

* Speichern Sie die JobHandy-Mitarbeiter-ID nach einem Match oder Create.
* Verwenden Sie einen stabilen Kundenidentifikator wie `employeeNumber`, sofern Eindeutigkeit garantiert ist.
* Verwenden Sie die E-Mail-Adresse nicht als einzigen langfristigen Key, wenn der Kunde deren Unveränderlichkeit nicht garantiert.
* Lassen Sie Patch-Felder weg, die unverändert bleiben sollen.
* Verwenden Sie `null` nur für nullable Felder, die geleert werden sollen.
* Verwenden Sie eine Dry-Run-Vorschau-ID nicht in späteren Anfragen.

<Card title="Leitfaden zur Mitarbeitersynchronisation" icon="refresh-cw" href="/de/guides/sync-employees" horizontal>
  Implementieren Sie Identitätsabgleich, Checkpoints, Dry Runs, partielle Updates und Reconciliation nach Timeouts.
</Card>