Einzelnen Beschäftigungszeitraum abrufen

Liefert einen Beschäftigungszeitraum des angegebenen Mitarbeiters anhand seiner ID.

Verfügbarkeit: Vollversion und ZEP Clock

Request

GET /api/v1/employees/{username}/employment-periods/{id}

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}/employment-periods/{id}' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

Name
username
Type
string
Description
Der Benutzername des Mitarbeiters
Name
id
Type
integer
Description
Die ID des Beschäftigungszeitraums

Response

{
  "data": {
    "id": 1,
    "employee_id": "max.mustermann",
    "start_date": "2024-01-15T00:00:00.000000Z",
    "end_date": "2024-01-16T00:00:00.000000Z",
    "note": "Familienurlaub",
    "beginning_of_year": "2024-01-01T00:00:00.000000Z",
    "annual_leave_entitlement": 30,
    "period_holiday_entitlement": 30,
    "is_holiday_per_year": true,
    "day_absent_in_hours": 8,
    "created": "2024-07-20T11:30:00.000000Z",
    "modified": "2024-07-20T12:30:00.000000Z"
  }
}

Response-Felder

Name
id
Type
integer
Description
Eindeutige Kennung des Beschäftigungszeitraums.
Name
employee_id
Type
string
Description
Benutzername des Mitarbeiters, zu dem dieser Beschäftigungszeitraum gehört.
Name
start_date
Type
string (date-time), nullable
Description
Erster Kalendertag, an dem der Mitarbeiter in diesem Zeitraum beschäftigt war.
Name
end_date
Type
string (date-time), nullable
Description
Letzter Kalendertag, an dem der Mitarbeiter in diesem Zeitraum beschäftigt war, sofern beendet.
Name
note
Type
string, nullable
Description
Freitextnotiz zum Beschäftigungszeitraum.
Name
beginning_of_year
Type
string (date-time), nullable
Description
Kalendertag, an dem das Urlaubsjahr für diesen Beschäftigungszeitraum beginnt.
Name
annual_leave_entitlement
Type
number, nullable
Description
Anzahl der Urlaubstage, auf die der Mitarbeiter pro vollem Urlaubsjahr Anspruch hat.
Name
period_holiday_entitlement
Type
number, nullable
Description
Anzahl der Urlaubstage, auf die der Mitarbeiter Anspruch hat, anteilig für diesen Zeitraum.
Name
is_holiday_per_year
Type
boolean, nullable
Description
Ob der Urlaubsanspruch pro Kalenderjahr und nicht pro Beschäftigungszeitraum angegeben ist.
Name
day_absent_in_hours
Type
number, nullable
Description
Anzahl der Stunden, mit denen ein ganzer Fehltag für diesen Beschäftigungszeitraum gebucht wird.
Name
created
Type
string (date-time), nullable
Description
Zeitstempel der Erstellung des Beschäftigungszeitraums.
Name
modified
Type
string (date-time), nullable
Description
Zeitstempel der letzten Änderung des Beschäftigungszeitraums.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

POST Beschäftigungszeitraum anlegen PATCH Beschäftigungszeitraum aktualisieren