REST DokumentationMitarbeiterPATCH Anfahrtsdaten-Eintrag ändern

Anfahrtsdaten-Eintrag ändern

Ändert nur die gesendeten Felder. Wird valid_from auf einen Tag verschoben, für den der Mitarbeiter schon einen Eintrag hat, antwortet die API mit 422 auf valid_from. Erfordert das Modul Inovex.

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

PATCH /api/v1/employees/{username}/travel-data/{id}
curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}/travel-data/{id}' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
       "valid_from": "2026-01-01",
       "distance": 1.5,
       "travel_time": 1.5
     }'

Pfad-Parameter

  • Name
    username
    Type
    string
    Description

    Der Benutzername des Mitarbeiters

  • Name
    id
    Type
    integer
    Description

    Die ID des Anfahrtsdaten-Eintrags

Request-Body

  • Name
    valid_from
    Type
    string (date)
    Description

    Der erste Tag, ab dem Entfernung und Anfahrtzeit gelten, als Y-m-d. Ein Mitarbeiter hat höchstens einen Eintrag pro Tag.

  • Name
    distance
    Type
    number
    Description

    Die Entfernung zum Arbeitsort in Kilometern, 0 bis 99999999.99, höchstens zwei Nachkommastellen.

  • Name
    travel_time
    Type
    number
    Description

    Die Anfahrtzeit zum Arbeitsort in Stunden, 0 bis 9999.9999, höchstens vier Nachkommastellen.

Response

{
  "data": {
    "id": 1,
    "username": "max.mustermann",
    "valid_from": "2026-01-01",
    "distance": 1.5,
    "travel_time": 1.5
  }
}

Response-Felder

  • Name
    id
    Type
    integer
    Description

    Eindeutige Kennung des Anfahrtsdaten-Eintrags.

  • Name
    username
    Type
    string
    Description

    Benutzername des Mitarbeiters, zu dem der Eintrag gehört.

  • Name
    valid_from
    Type
    string (date)
    Description

    Erster Kalendertag, ab dem Entfernung und Anfahrtzeit gelten, als Y-m-d.

  • Name
    distance
    Type
    number
    Description

    Entfernung zum Arbeitsort in Kilometern.

  • Name
    travel_time
    Type
    number
    Description

    Anfahrtzeit zum Arbeitsort in Stunden.

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