Dieser Endpunkt wird erst ab Montag, 21. August 2023 valide Daten liefern.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id | integer |
Die ID des Antrags
|
| date | string |
Das Datum, für das Arbeitszeiten geändert werden sollen
|
| users_id | integer |
Der Benutzer, dessen Arbeitszeiten geändert werden sollen
|
| status | integer |
Status des Antrags
1: beantragt, 2: abgelehnt
|
| declined_at | string|null |
Zeitpunkt, zu dem der Antrag abgelehnt wurde
im Format ISO 8601 UTC, z.B. „2023-07-30T12:34:56Z“
|
| declined_by | integer|null |
ID des Benutzers, der den Antrag abgelehnt hat
|
| changes | changeRequestInterval[] |
Die beantragten Änderungen der Arbeitszeit
|
| Parameter | Typ | Beschreibung |
|---|---|---|
| type | integer |
Art der Änderung
1: Zeit hinzufügen; 2: Zeit entfernen
|
| time_since | string |
Beginn der Änderung
im Format ISO 8601 UTC, z.B. „2023-07-30T12:34:56Z“
|
| time_until | string |
Ende der Änderung
im Format ISO 8601 UTC, z.B. „2023-07-30T12:34:56Z“
|
GET /api/v2/workTimes/changeRequests
| Optionale Parameter | date_since | string |
Beginn des Zeitraums, für den angefragt wird
|
|---|---|---|---|
| date_until | string |
Ende des Zeitraums, für den angefragt wird
| |
| users_id | integer |
ID des Benutzers, dessen Anträge angefragt werden
| |
| status | integer |
Status-Filter
1: angefragt; 2: abgelehnt
|
{
"paging": [paging information],
"change_requests":
{
[object of type changeRequest],
[object of type changeRequest],
...
}
}POST /api/v2/workTimes/changeRequests
| Pflichtparameter | date | string |
|---|---|---|
| users_id | integer | |
| changes | changeRequestInterval[] |
{
"date": "2023-07-30",
"users_id": 123,
"changes": [
{
"type": 1,
"time_since": "2023-07-30T14:00:00Z",
"time_until": "2023-07-30T15:00:00Z",
},
{
"type": 2,
"time_since": "2023-07-30T13:00:00Z",
"time_until": "2023-07-30T14:00:00Z",
},
]
}{
'change_request': [object of type changeRequest], // Der neu angelegte Antrag
'replaced_change_request': [object of type changeRequest]|null, // Der bisherige offene Antrag für diesen Tag, der überschrieben wurde
'approved_immediately': boolean // Wurde der Antrag sofort automatisch angenommen?
}Pro Benutzer und Tag kann nur ein offener Antrag existieren. Wird für einen Tag, an dem bereits ein offener Antrag vorliegt, ein weiterer Antrag erstellt, überschreibt dieser den existierenden. Wird ein Antrag für einen Tag erstellt, dessen Arbeitszeiten ohne Antrag bearbeitet werden dürfen, wird dieser automatisch angenommen und sofort auf die Arbeitszeiten des Tages angewendet.
POST /api/v2/workTimes/changeRequests/[ID]/approve
{
"change_request": null
}POST /api/v2/workTimes/changeRequests/[ID]/decline
{
"change_request": [object of type changeRequest]
}DELETE /api/v2/workTimes/changeRequests/[ID]
Abgelehnte Anträge können nicht gelöscht werden.
{
"change_request": null
}
Unser Customer-Success-Team steht Ihnen für Fragen zur Verfügung!
Bechtle
Peerigon GmbH
Phoenix Logistik
Fidea