Neue API-Version v6.13.17 wurde veröffentlicht! 🎉
REST Dokumentation
POST Projektzeiten

Projektzeit erstellen

Mit diesem Endpunkt können Sie eine neue Projektzeit erstellen.

Request

POST /api/v1/attendances
curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/attendances' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
         "employee_id": "john.doe",
         "date": "2024-08-17",
         "from": "09:45:00",
         "to": "14:30:00",
         "duration": 4.75,
         "locked": false,
         "is_travel": false,
         "billable": true,
         "work_location_is_project_relevant": false,
         "color": "#FF5733",
         "project_task_id": 41,
         "project_id": 9,
         "activity_id": "re",
         "start": "Location A",
         "destination": "Location B",
         "vehicle_id": 3,
         "private": true,
         "km": 120,
         "passengers": 2,
         "direction_of_travel": "continue"
     }'

Response

{
	"data": [
        {
            "id": 1,
            "employee_id": "john.doe",
            "date": "2024-08-17",
            "from": "09:45:00",
            "to": "14:30:00",
            "duration": 4.75,
            "locked": false,
            "is_travel": false,
            "billable": true,
            "work_location_is_project_relevant": false,
            "color": "#FF5733",
            "project_task_id": 41,
            "project_id": 9,
            "activity_id": "re",
            "start": "Location A",
            "destination": "Location B",
            "vehicle_id": 3,
            "private": true,
            "km": 120,
            "passengers": 2,
            "direction_of_travel": {
                "id": 1,
                "name": "continue"
            },
            "created": "2024-09-17T10:15:47.000000Z",
            "modified": "2024-09-17T10:15:47.000000Z"
        }
	]
}

Erforderliche Parameter

  • Name
    employee_id
    Type
    string
    Description

    Der Username des Mitarbeiters, der die Projektzeit erstellt.

  • Name
    date
    Type
    date | Y-m-d
    Description

    Das Datum der Projektzeit.

  • Name
    from
    Type
    string | H:i:s
    Description

    Der Startzeitpunkt der Projektzeit.

  • Name
    to
    Type
    string | H:i:s
    Description

    Der Endzeitpunkt der Projektzeit. Muss nach from liegen.

  • Name
    project_task_id
    Type
    integer
    Description

    Die ID der zugehörigen Projektaufgabe.

  • Name
    project_id
    Type
    integer
    Description

    Die ID des zugehörigen Projekts.

  • Name
    activity_id
    Type
    string
    Description

    Die ID der Aktivität.

Optionale Parameter

  • Name
    duration
    Type
    float
    Description

    Die Gesamtdauer der Projektzeit in Stunden.

  • Name
    locked
    Type
    boolean
    Description

    Gibt an, ob die Projektzeit gesperrt ist.

  • Name
    is_travel
    Type
    boolean
    Description

    Gibt an, ob die Projektzeit als Reisezeit zählt.

  • Name
    billable
    Type
    boolean
    Description

    Gibt an, ob die Projektzeit abrechenbar ist.

  • Name
    work_location_is_project_relevant
    Type
    boolean
    Description

    Gibt an, ob der Arbeitsort projektbezogen ist.

  • Name
    color
    Type
    string | Hex
    Description

    Farbe im Hex-Format (z. B. #FF5733).

  • Name
    start
    Type
    string
    Description

    Startpunkt der Reise.

  • Name
    destination
    Type
    string
    Description

    Ziel der Reise.

  • Name
    vehicle_id
    Type
    integer
    Description

    Die ID des Fahrzeugs.

  • Name
    private
    Type
    boolean
    Description

    Gibt an, ob die Fahrt privat ist.

  • Name
    km
    Type
    integer
    Description

    Zurückgelegte Kilometer.

  • Name
    passengers
    Type
    integer
    Description

    Anzahl der Mitreisenden.

  • Name
    direction_of_travel
    Type
    string | enum
    Description

    Richtung der Reise (z. B. continue).