Neue API-Version v7.7.0 wurde veröffentlicht! 🎉
REST Dokumentation
PUT Beschäftigungszeitraum aktualisieren

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 dem end_date sein
  • Der employee_id muss einem existierenden Mitarbeiter entsprechen