Abwesenheit erstellen
Mit diesem Endpunkt können Sie eine neue Abwesenheit erstellen.
Anfrage
curl --request POST \
--url 'https://www.zep-online.de/zepinstanz/next/api/v1/absences' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
"employee_id": "john.doe",
"absence_reason_id": 1,
"from": "2024-10-15",
"to": "2024-10-17",
"days": 3.0,
"half_day_from": false,
"half_day_to": false,
"comment": "Familienurlaub",
"approval_status": "pending",
"approved_by": "jane.manager",
"approved_at": "2024-10-01T14:30:00Z"
}'Antwort
{
"data": {
"id": 12345,
"employee_id": "john.doe",
"absence_reason_id": 1,
"from": "2024-10-15",
"to": "2024-10-17",
"days": 3.0,
"half_day_from": false,
"half_day_to": false,
"comment": "Familienurlaub",
"approval_status": "pending",
"approved_by": "jane.manager",
"approved_at": "2024-10-01T14:30:00.000000Z",
"created": "2024-10-01T14:30:00.000000Z",
"modified": "2024-10-01T14:30:00.000000Z"
}
}Wichtiger Hinweis zu planned und approved
Beachten Sie: Das Request-Feld planned und das Response-Feld approved haben eine invertierte Logik:
- Bei Verwendung von
planned: falseim Request → Abwesenheit wird genehmigt (approved: trueim Response) - Bei Verwendung von
planned: trueim Request → Abwesenheit muss noch genehmigt werden (approved: falseim Response)
Die Beziehung ist: approved = !planned
Pflichtparameter
- Name
employee_id- Type
- string
- Description
Der Benutzername des Mitarbeiters, für den die Abwesenheit erstellt wird.
- Name
absence_reason_id- Type
- integer
- Description
Die ID des Abwesenheitsgrunds (z.B. Urlaub, Krankheit, etc.).
- Name
from- Type
- date | Y-m-d
- Description
Das Startdatum der Abwesenheit.
- Name
to- Type
- date | Y-m-d
- Description
Das Enddatum der Abwesenheit. Muss am oder nach dem
fromDatum liegen.
Optionale Parameter
- Name
days- Type
- float
- Description
Die Gesamtzahl der Abwesenheitstage. Wird automatisch berechnet, wenn nicht angegeben.
- Name
half_day_from- Type
- boolean
- Description
Gibt an, ob der erste Tag ein halber Tag ist. Standard ist
false.
- Name
half_day_to- Type
- boolean
- Description
Gibt an, ob der letzte Tag ein halber Tag ist. Standard ist
false.
- Name
comment- Type
- string
- Description
Zusätzliche Kommentare oder Notizen zur Abwesenheit.
- Name
approval_status- Type
- string | enum
- Description
Der Genehmigungsstatus der Abwesenheit. Mögliche Werte:
pending,approved,rejected. Standard istpending.
- Name
approved_by- Type
- string
- Description
Der Benutzername der Person, die die Abwesenheit genehmigt hat.
- Name
approved_at- Type
- datetime | ISO 8601
- Description
Datum und Uhrzeit der Genehmigung.