Mitarbeiter

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

Mitarbeiter-Collections paginieren, filtern, sortieren und einschränken.

Zuordnung validieren und Konto erstellen.

Einen Mitarbeiter über seine undurchsichtige ID abrufen.

Unterstützte Felder, Divisionszuordnung und Sperrstatus patchen.

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.

Implementieren Sie Identitätsabgleich, Checkpoints, Dry Runs, partielle Updates und Reconciliation nach Timeouts.

Zuletzt geändert am 27. August 2026