Beschäftigungszeitraum aktualisieren
Sie können diesen Endpunkt verwenden, um einen bestehenden Beschäftigungszeitraum für einen Mitarbeiter zu aktualisieren.
Request
PUT /api/v1/employees/:username/employment-periods/:id
curl --request PUT \
--url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/john.doe/employment-periods/42' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
"id": 42,
"employee_id": "john.doe",
"start_date": "2024-01-01",
"end_date": "2025-12-31",
"note": "Verlängerter Vollzeit Entwickler Position",
"beginning_of_year": "2024-01-01",
"annual_leave_entitlement": 32.0,
"period_holiday_entitlement": 32.0,
"is_holiday_per_year": true,
"day_absent_in_hours": 8.0
}'
Response
{
"data": {
"id": 42,
"employee_id": "john.doe",
"start_date": "2024-01-01T00:00:00.000000Z",
"end_date": "2025-12-31T00:00:00.000000Z",
"note": "Verlängerter Vollzeit Entwickler Position",
"beginning_of_year": "2024-01-01T00:00:00.000000Z",
"annual_leave_entitlement": 32.0,
"period_holiday_entitlement": 32.0,
"is_holiday_per_year": true,
"day_absent_in_hours": 8.0,
"created": "2024-09-12T10:30:00.000000Z",
"modified": "2025-10-07T15:45:00.000000Z"
}
}
Erforderliche Parameter
- Name
id
- Type
- integer
- Description
ID des zu aktualisierenden Beschäftigungszeitraums.
- Name
employee_id
- Type
- string
- Description
Benutzername des Mitarbeiters (max. 32 Zeichen).
- Name
start_date
- Type
- date | Y-m-d
- Description
Das Startdatum des Beschäftigungszeitraums (muss vor oder gleich end_date sein).
Optionale Parameter
- Name
end_date
- Type
- date | Y-m-d
- Description
Das Enddatum des Beschäftigungszeitraums.
- Name
note
- Type
- string
- Description
Notiz zum Beschäftigungszeitraum (max. 255 Zeichen).
- Name
annual_leave_entitlement
- Type
- float
- Description
Jährlicher Urlaubsanspruch in Tagen (min. 0).
- Name
beginning_of_year
- Type
- date | Y-m-d
- Description
Beginn des Jahres für die Urlaubsberechnung.
- Name
period_holiday_entitlement
- Type
- float
- Description
Urlaubsanspruch für den Zeitraum in Tagen (min. 0).
- Name
is_holiday_per_year
- Type
- boolean
- Description
Gibt an, ob der Urlaub pro Jahr berechnet wird.
- Name
day_absent_in_hours
- Type
- float
- Description
Anzahl der Stunden pro Abwesenheitstag (min. 0).
Hinweise
- Die
id
muss ein gültiger, existierender Beschäftigungszeitraum sein - Das
start_date
muss vor oder gleich demend_date
sein - Der
employee_id
muss einem existierenden Mitarbeiter entsprechen