REST DokumentationMitarbeiterPOST Anfahrtsdaten-Eintrag anlegen

Anfahrtsdaten-Eintrag anlegen

Erfasst Entfernung und Anfahrtzeit des Mitarbeiters ab dem Tag valid_from. Ein Mitarbeiter hat höchstens einen Eintrag pro Tag; ein zweiter für denselben Tag antwortet mit 422 auf valid_from. Erfordert das Modul Inovex.

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

Request

POST /api/v1/employees/{username}/travel-data
curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}/travel-data' \
     --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

Request-Body

  • Name
    valid_from
    Type
    string (date), erforderlich
    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, erforderlich
    Description

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

  • Name
    travel_time
    Type
    number, erforderlich
    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.