Employment Contract Schema
Felder
Employment Contract Schema
Schema for versioned employment contracts (Arbeitsverträge)
employeeProfileId
UUID of the employee_profile this contract version belongs to
revision
Sequential contract revision per employee (1 = initial contract, 2 = first amendment, ...)
effectiveFrom
First day on which this version is in effect (YYYY-MM-DD)
effectiveUntil
Last day this version is in effect. null on the currently active version. Set automatically when a new version is created.
supersededBy
UUID of the employment_contract that supersedes this one
supersededAt
When this version was superseded
changeReason
Free-text reason for this contract change (e.g. "Gehaltserhöhung 2026", "Wechsel auf 30h"). Required when creating a v>=2.
contractType
Permanent (unbefristet), fixed-term (befristet), or other forms
PERMANENTFIXED_TERMTEMPORARYTRAININGINTERNSHIPcontractEndDate
End date of the contract (only set for FIXED_TERM/TEMPORARY)
probationEndDate
End of probation period (Probezeit). null if no probation.
noticePeriodDays
Notice period in days (Kündigungsfrist), null = legal default
roleDescription
Free-text role description (Tätigkeitsbeschreibung)
positionTitle
Job title for this contract version (Stellenbezeichnung)
workingTimeModel
Working-time model for this contract
FULL_TIMEPART_TIMEMINI_JOBWORKING_STUDENTINTERNFREELANCERweeklyHours
Contracted weekly hours
workingTimeModelId
Reference to a working_time_model entity (shift pattern, flex windows, ...)
vacationDaysPerYear
Annual vacation entitlement in days
encryptedFields
Map of field-name → encrypted envelope. Encrypted client-side with the employee DEK; the server never sees plaintext. See EMPLOYMENT_CONTRACT_ZK_FIELDS for the registered field set and their visibility category.
status
DRAFT = work in progress, ACTIVE = currently in force, SUPERSEDED = replaced by newer version, TERMINATED = employment ended
DRAFTACTIVESUPERSEDEDTERMINATEDsignedDocumentId
UUID of the dms_document containing the signed PDF of this contract version
attachmentDocumentIds
Additional dms_document IDs (annexes, side letters)
notes
Free-text internal notes
Keine Felder passen zum Filter.
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/employment_contracts— Liste, paginiert + filterbarGET /api/v1/employment_contracts/<id>— Einzelne EntityPOST /api/v1/employment_contracts— AnlegenPATCH /api/v1/employment_contracts/<id>— Teil-UpdateDELETE /api/v1/employment_contracts/<id>— Soft-DeleteGET /api/v1/employment_contracts/<id>/timeline— Audit + Aktivitäten