Neue API-Version v7.12 wurde veröffentlicht! 🎉
REST DokumentationProjektzeitenPATCH Projektzeit aktualisieren

Projektzeit aktualisieren

Mit diesem Endpunkt können Sie eine bestehende Projektzeit ändern. Die Buchungsregeln werden vor dem Schreiben geprüft; Verstöße kommen als 422 mit Meldungen je Feld zurück.

Request

PATCH /api/v1/attendances/:id
curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/attendances/1234' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "employee_id": "max.mustermann",
  "date": "2026-07-24",
  "from": "09:00:00",
  "to": "12:30:00",
  "project_id": 16,
  "project_task_id": 7,
  "activity_id": "im",
  "note": "Konzept überarbeitet"
}'

Parameter

  • id (integer, erforderlich): Die ID der zu ändernden Projektzeit

Erforderliche Felder

  • employee_id (string): Der Username des Mitarbeiters
  • date (date | Y-m-d): Der Tag der Buchung
  • from (time | H:i:s): Beginn
  • to (time | H:i:s): Ende. 00:00:00 bedeutet Tagesende und zählt zum Folgetag
  • project_id (integer): Das Projekt
  • project_task_id (integer): Der Projektvorgang
  • activity_id (string): Die Tätigkeit

Häufige Ablehnungsgründe

Die Prüfung entspricht der des ZEP-Kerns, die auch Weboberfläche, SOAP und Clock durchlaufen:

  • Tag in einem abgeschlossenen Monat, nach dem Freigabedatum oder außerhalb des Erfassungszeitraums
  • Nichtarbeitstag oder ganztägiger Feiertag des Mitarbeiters
  • Tag außerhalb des Beschäftigungszeitraums
  • Tag außerhalb der Laufzeit von Projekt, Vorgang oder Ticket
  • überschrittene Planstunden

Response

{
  "data": {
    "id": 1234,
    "date": "2026-07-24T00:00:00.000000Z",
    "from": "09:00:00",
    "to": "12:30:00",
    "end_date": "2026-07-24",
    "employee_id": "max.mustermann",
    "duration": 3.5,
    "note": "Konzept überarbeitet",
    "billable": true,
    "project_id": 16,
    "project_task_id": 7,
    "activity_id": "im",
    "created": "2026-07-24T12:31:00.000000Z",
    "modified": "2026-07-24T12:31:00.000000Z"
  }
}