Abwesenheit erstellen

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

Anfrage

POST /api/v1/absences

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: false im Request → Abwesenheit wird genehmigt (approved: true im Response)
Bei Verwendung von planned: true im Request → Abwesenheit muss noch genehmigt werden (approved: false im 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 from Datum 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 ist pending.
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.

GET Abwesenheit Fehlgründe