API 2.0.0: Sperränderungen bei aktiven Verträgen
Bei PATCH /employees/{id} verbietet ein aktiver Vertrag sowohl blocked: true als auch blocked: false. Enthält die Anfrage blocked, lehnt die API den gesamten Patch mit HTTP 422 und EMPLOYEE_HAS_ACTIVE_CONTRACT ab, auch bei dryRun=true. Andere Felder dieser abgelehnten Anfrage werden nicht übernommen. Auch das erneute Senden des bereits gespeicherten blocked-Werts ist unzulässig.
Für reine Profiländerungen lassen Sie blocked vollständig weg. Konfigurieren Sie Serialisierung und Synchronisationsmapping so, dass blocked: false nicht als Standardwert hinzugefügt wird. Beispiel:
Wiederholen Sie einen unveränderten abgelehnten Patch nicht. Klären Sie den Sperrauftrag über den zuständigen Fachprozess oder senden Sie für eine unabhängig beabsichtigte Profiländerung einen neuen Patch ausschließlich mit den gewünschten unterstützten Profilfeldern. Ein erfolgreicher Dry Run reserviert den Vertragsstatus nicht; behandeln Sie dieselbe Validierung beim realen Schreibvorgang.
Die öffentliche Employee-Update-Operation stellt die Eigenschaft blocked bereit. Eine Sperrung ändert den Kontostatus; sie ist keine Löschoperation und darf nicht als Datenlöschung beschrieben werden.
Empfohlener Offboarding-Ablauf
Mitarbeiter sperren
Verwenden Sie zuerst einen Dry Run, wenn die Änderung Teil eines automatisierten Offboarding-Prozesses ist.
Was der öffentliche Vertrag garantiert
- Die Mitarbeiterressource enthält den booleschen Status
blocked.
- Der Update-Endpoint kann diesen Status nur ohne aktiven Vertrag ändern.
- Der Mitarbeiter bleibt über seine Ressourcen-ID adressierbar, solange er im Scope verfügbar ist.
- Die Public API bietet keine Löschung von Mitarbeitern an.
Was der öffentliche Vertrag nicht festlegt
Der OpenAPI-Vertrag beschreibt nicht jeden nachgelagerten Portal- oder Facheffekt eines gesperrten Mitarbeiters. Gehen Sie nicht davon aus, dass eine Sperrung automatisch:
- Mitarbeiterdaten löscht
- bestehende Bestellungen storniert, ablehnt oder archiviert
- Vorfälle oder Anhänge löscht
- Payroll-Daten löscht
- ein rechtliches Löschersuchen erfüllt
Behandeln Sie diese Vorgänge über die verantwortlichen JobHandy- und Kundenprozesse.
Reaktivierung
Nur wenn kein aktiver Vertrag besteht und der fachliche Prozess eine Reaktivierung erlaubt, setzen Sie:
Validieren Sie Zielstatus und aktuellen Tenant-Scope vor der Ausführung.
Betriebscheckliste
Zuletzt geändert am 20. Oktober 2026
