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

Position Schema

Schema-ID
position
Collection
positions
Permissions
  • Lesenposition_view
  • Anlegenposition_create
  • Ändernposition_edit
  • Löschenposition_delete

Felder

Position Schema

positions4 Permissions

Schema for organisational positions / Planstellen (Spec docs/specs/org-chart-v2.md, ADR 0097b)

namestringerforderlich

Display name of the position (e.g. "Head of Marketing")

1–200 Zeichen
codestringoptional

Stable internal position code (e.g. "POS-2026-00042"). Generated by sequence service; protected against client writes.

max 50 Zeichenread-onlynullable
orgUnitIduuidoptional

Anchoring org unit. NULL is allowed for top-level positions without OU (Geschäftsführung, Aufsichtsrat, Datenschutzbeauftragter). Settings inheritance skips the OU layer when null.

nullable
parentPositionIduuidoptional

Disciplinary parent position (Linie). Resolver climbs this chain for MANAGER(DISCIPLINARY,…) lookups.

nullable
dottedLineParentIdsuuid[]optional

Functional / dotted-line parent positions (Matrix). Resolver uses these for MANAGER(FUNCTIONAL,…) lookups.

max 10 ItemsDefault: []
positionTypestringerforderlich

LINE: regular org-chart position. STAFF: staff position with read access over the parent branch (no own subordinates). PROJECT: project-bound. EXECUTIVE: GF/C-Level without disciplinary parent.

Werte
LINESTAFFPROJECTEXECUTIVE
roleTypestringoptional

Role flavour — purely informational, drives UI badges.

Werte
MANAGERINDIVIDUAL_CONTRIBUTORLEADASSISTANTnull
nullable
requiredSkillIdsuuid[]optional

Skills expected for this position (FK skill_definition).

Default: []
requiredLanguagesobject[]optional

Required languages with minimum CEFR level for this position.

Default: []
codestringerforderlich
max 10 Zeichenread-only
minLevelstringerforderlich
max 10 Zeichen
requiredDocumentsobject[]optional

Documents the holder must provide (e.g. Führungszeugnis, NDA). Phase 6 generates onboarding tasks from this list.

Default: []
documentTypeIduuiderforderlich
mandatorybooleanerforderlich
Default: true
renewalIntervalMonthsintegeroptional
1 – 1200
blockingForOnboardingbooleanoptional
Default: false
costCenterIduuidoptional

FK auf cost_center. Übersteuert org_unit.costCenterId. Siehe ADR 0116a.

nullable
defaultApprovalLimitnumberoptional

Approval budget limit in EUR for this position (e.g. CFO: 50000).

≥ 0nullable
validFromdateoptional

First day this position is effective.

nullable
validTodateoptional

Last day this position is effective. NULL = open-ended.

nullable
isActivebooleanoptional

Soft activation flag. Inactive positions are excluded from approver resolution.

Default: true
descriptionstringoptional

Long-form description / Stellenbeschreibung.

max 4000 Zeichennullable
responsibilitiesstring[]optional
max 50 ItemsDefault: []

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

Suche