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

HR Ticket Schema

Schema-ID
hr_ticket
Collection
hr_tickets
Permissions
  • Lesenhr_ticket_view
  • Anlegenhr_ticket_create
  • Ändernhr_ticket_edit
  • Löschenhr_ticket_delete

Felder

HR Ticket Schema

hr_tickets4 Permissions

Internal HR-only ticket. Any employee can create one; only HR (Personalabteilung) can edit/process.

hrTicketNumberstringoptional

Auto-generated HR ticket number (e.g. HR-2026-00042). Set by entity.service.

read-onlynullable
titlestringerforderlich

Short subject line of the HR ticket

1–500 Zeichen
descriptionstringoptional

Detailed description (plain text)

nullable
descriptionHtmlstringoptional

Rich-text HTML version of the description (sanitized server-side)

nullable
categorystringerforderlich

HR category — drives routing/filtering inside HR

Werte
equipmentpayrollpersonalitonboardingoffboardingtrainingfeedbackother
statusstringerforderlich

Workflow status. Only HR can transition.

Werte
OPENIN_PROGRESSWAITINGRESOLVEDCLOSED
Default: "OPEN"
prioritystringerforderlich

Priority chosen by requester; HR may re-prioritize

Werte
LOWNORMALHIGHCRITICAL
Default: "NORMAL"
requesterIduuidoptional

User UUID of the employee who raised the ticket. Auto-set on create.

read-only
assignedToIduuidoptional

HR processor user UUID (assignee).

nullable
orgUnitIduuidoptional

Org unit of the requester at time of creation (denormalized).

nullable
contactUserIduuidoptional

Optional additional contact person (user UUID) HR should coordinate with — e.g. line manager of the requester, mentor during onboarding. Distinct from requester/assignee/affected.

nullable
dueAtdatetimeoptional

Due date for the HR ticket in ISO format

nullable
estimatedMinutesintegeroptional

Estimated work time in minutes

≥ 0nullable
affectedEmployeeIdsuuid[]optional

Additional employees (user IDs) affected by this HR ticket beyond the requester — e.g. payroll issue affecting a team, onboarding for a group. The requester is intentionally NOT auto-added since HR may file tickets on behalf of others.

Default: []nullable
confidentialbooleanoptional

Marks the ticket as sensitive (e.g. complaints, art-9 topics). UI may hide previews accordingly.

Default: false
attachmentFileIdsstring[]optional

References to uploaded files via the DMS / file service

Default: []nullable
tagsstring[]optional

Free-form tags for filtering

Default: []nullable
statusChangedAtdatetimeoptional

Timestamp of last status change (denormalized)

nullable
resolvedAtdatetimeoptional

When status moved to RESOLVED

nullable
closedAtdatetimeoptional

When status moved to CLOSED

nullable
resolutionstringoptional

DEPRECATED — kept for legacy data. New HR notes / resolutions are written as comments or internal notes via the EntityActivityCard. Existing values stay in the document and remain visible through the History dialog, but no UI surfaces this field for editing anymore.

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

Suche