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

Working Time Assignment Schema

Schema-ID
working_time_assignment
Collection
working_time_assignments
Permissions
  • Lesenworking_time_assignment_view
  • Anlegenworking_time_assignment_employee
  • Ändernworking_time_assignment_employee
  • Löschenworking_time_assignment_employee

Felder

Working Time Assignment Schema

working_time_assignments4 Permissions

Hierarchische Zuweisung eines Arbeitszeitmodells an einen Scope mit Gültigkeit

scopestringerforderlich

Auflösungs-Ebene: Tenant (Fallback), Org-Unit (Vererbung), Employee (Override)

Werte
TENANTORG_UNITEMPLOYEE
scopeIdstringerforderlich

Ziel-ID passend zum Scope: tenantId | org_unit._id | employee_profile._id. Für EMPLOYEE-Scope ist `employee_profile._id` der kanonische Schlüssel (ADR 0036b, Folge-Update 2026-05). Damit lassen sich Arbeitszeitmodelle auch Mitarbeitern ohne verknüpften User-Account zuweisen.

1–64 Zeichen
workingTimeModelIdstringerforderlich

Referenz auf working_time_models._id

1–64 Zeichen
validFromstringerforderlich

ISO 8601 Beginn der Zuweisung

Pattern
validTostringerforderlich

ISO 8601 Ende; "9999-12-31" = unbefristet (Sentinel)

Pattern
weeklyHoursnumberoptional

Individuelle Wochenstunden (Instanz-Parameter). Nicht gesetzt = Modell-Default.

0 – 80nullable
partTimePercentnumberoptional

Teilzeit-Prozentsatz auf dem partTime-Modifier des Modells. Nur sinnvoll, wenn Model partTime definiert.

0 – 100nullable
collectiveAgreementIdstringoptional

Optionale Tarifvertragsbindung (collective_agreements._id)

max 64 Zeichennullable
approvalStatestringoptional

Freigabestatus. Resolver berücksichtigt nur APPROVED für scope ∈ {TENANT, ORG_UNIT}.

Werte
DRAFTPENDING_WORKS_COUNCILAPPROVEDREJECTED
Default: "DRAFT"read-only
submittedForApprovalAtdatetimeoptional

Zeitpunkt der BR-Vorlage

read-onlynullable
submittedBystringoptional

userId der Person, die die Freigabe angefragt hat

max 64 Zeichenread-onlynullable
approvedAtdatetimeoptional

Zeitpunkt der BR-Freigabe oder Ablehnung

read-onlynullable
approvedBystringoptional

userId des freigebenden BR-Mitglieds (muss != submittedBy sein)

max 64 Zeichenread-onlynullable
worksCouncilCaseRefstringoptional

BR-Beschluss-Referenz (Nummer/Datum), frei formatiert

max 200 Zeichennullable
rejectionReasonstringoptional

Begründung bei approvalState === "REJECTED"

max 4000 Zeichennullable
notesstringoptional

Zusätzliche Notizen zur Zuweisung

max 4000 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/working_time_assignments — Liste, paginiert + filterbar
  • GET /api/v1/working_time_assignments/<id> — Einzelne Entity
  • POST /api/v1/working_time_assignments — Anlegen
  • PATCH /api/v1/working_time_assignments/<id> — Teil-Update
  • DELETE /api/v1/working_time_assignments/<id> — Soft-Delete
  • GET /api/v1/working_time_assignments/<id>/timeline — Audit + Aktivitäten

Suche