API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · vacation_requests

Vacation Request Schema

Schema-ID
vacation_request
Collection
vacation_requests
Permissions
  • Lesenvacation_request_view
  • Anlegenvacation_request_create
  • Ändernvacation_request_edit
  • Löschenvacation_request_delete

Felder

Vacation Request Schema

vacation_requests4 Permissions

Schema for validating vacation request entities (Abwesenheitsanträge)

employeeIduuiderforderlich

ADR 0123 — employee_profile._id der freistellungsbedürftigen Person. Kanonischer Schlüssel, funktioniert auch ohne verknüpften Login.

requesterIduuidoptional

User UUID des Antragstellers — denormalisiert für Self-Service-Reads. Null bei HR-erfassten Anträgen für Mitarbeitende ohne Login-Account.

nullable
approverIduuidoptional

User UUID of the designated approver

nullable
substituteIduuidoptional

User UUID of the substitute during leave (Vertretung)

nullable
startDatedateerforderlich

First day of leave (ISO 8601 date: YYYY-MM-DD)

endDatedateerforderlich

Last day of leave (ISO 8601 date: YYYY-MM-DD)

daysRequestednumbererforderlich

Number of working days requested (0.5 for half-day)

≥ 0.5
halfDayStartbooleanoptional

Whether the first day is a half day (afternoon only)

Default: false
halfDayEndbooleanoptional

Whether the last day is a half day (morning only)

Default: false
leaveTypestringerforderlich

Abwesenheitsart. Nur VACATION zieht vom Jahresurlaub ab. ADR 0036b: TIME_IN_LIEU (Gleitzeit, FLEX), OVERTIME_COMPENSATION (Überstunden, OVERTIME), LONG_TERM_WITHDRAWAL (Langzeitkonto). Gesetzliche Freistellungen: VOCATIONAL_SCHOOL, EDUCATION_LEAVE, QUARANTINE, PAID_RELEASE, CARE_LEAVE.

Werte
VACATIONSPECIAL_LEAVECOMPENSATORYUNPAIDOTHERTIME_IN_LIEUOVERTIME_COMPENSATIONLONG_TERM_WITHDRAWALVOCATIONAL_SCHOOLEDUCATION_LEAVEQUARANTINEPAID_RELEASECARE_LEAVE
specialLeaveReasonstringoptional

Anlass für SPECIAL_LEAVE: WEDDING (Hochzeit), BEREAVEMENT (Todesfall naher Angehöriger), CHILD_BIRTH (Geburt eigenes Kind), RELOCATION (Umzug), JUBILEE (Dienstjubiläum), OTHER (sonstiger Anlass).

Werte
nullWEDDINGBEREAVEMENTCHILD_BIRTHRELOCATIONJUBILEEOTHER
nullable
accountTransactionIduuidoptional

UUID der time_account_transaction, die bei Genehmigung des Freizeitausgleichs gebucht wurde. Nur bei leaveType ∈ {TIME_IN_LIEU, OVERTIME_COMPENSATION, LONG_TERM_WITHDRAWAL}.

nullable
statusstringoptional

Current request status

Werte
PENDINGAPPROVEDREJECTEDWITHDRAWN
Default: "PENDING"
reasonstringoptional

Reason for the leave request

max 1000 Zeichennullable
approverCommentstringoptional

Approver comment on approval or rejection

max 1000 Zeichennullable
eventIduuidoptional

UUID of the CalendarEvent created on approval

nullable
externalReferencesobject[]optional

Cross-System-Verknüpfungen (ADR 0147 §3). Pro Fremdsystem ein Eintrag mit stabiler externer Id und den beiden Echo-Hashes. Wird ausschließlich von Sync-Pfaden geschrieben, nie über die generische CRUD-Oberfläche.

Default: []read-only
systemstringerforderlich
max 100 Zeichen
externalIdstringerforderlich
max 200 Zeichen
externalVersionstringoptional
nullable
externalNumberstringoptional
max 200 Zeichennullable
syncedAtdatetimeoptional
nullable
lastSyncCorrelationIdstringoptional
nullable
lastInboundHashstringoptional
max 64 Zeichennullable
lastOutboundHashstringoptional
max 64 Zeichennullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/vacation_requests — Liste, paginiert + filterbar
  • GET /api/v1/vacation_requests/<id> — Einzelne Entity
  • POST /api/v1/vacation_requests — Anlegen
  • PATCH /api/v1/vacation_requests/<id> — Teil-Update
  • DELETE /api/v1/vacation_requests/<id> — Soft-Delete
  • GET /api/v1/vacation_requests/<id>/timeline — Audit + Aktivitäten

Suche