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

Equipment Assignment Schema

Schema-ID
equipment_assignment
Collection
equipment_assignments
Permissions
  • Lesenequipment_assignment_view
  • Anlegenequipment_assignment_create
  • Ändernequipment_assignment_edit
  • Löschenequipment_assignment_delete
Beziehungen

Felder

Equipment Assignment Schema

equipment_assignments4 Permissions

Mitarbeiter-zentrierte Zuweisung von Sachausstattung (ADR 0115). Kein Vertragsbestandteil, fällt unter Direktionsrecht / Widerrufsvorbehalt — keine neue employment_contract-Version bei Aus-/Rückgabe.

employeeProfileIduuiderforderlich

Mitarbeiter, dem das Equipment zugeordnet ist.

kindstringerforderlich

Geräte-/Sachgut-Kategorie. CAR_WORK_USE_ONLY ist explizit für Pool-/Werkstattfahrzeuge ohne Privatnutzung; Firmenwagen mit 1%-Regel braucht zusätzlich einen contractualComponent IN_KIND (ADR 0114).

Werte
PHONELAPTOPTABLETDESKTOPMONITORPERIPHERALHEADSETDOCKCAR_WORK_USE_ONLYKEY_BADGEUNIFORMTOOLOTHER
labelstringoptional

Anzeigename, z.B. „MacBook Pro 14, Sales-Pool 03".

max 200 Zeichennullable
manufacturerstringoptional
max 100 Zeichennullable
modelstringoptional
max 100 Zeichennullable
serialNumberstringoptional
max 120 Zeichennullable
imeistringoptional

14–17-stellige IMEI bei PHONE / TABLET (ohne Trennzeichen).

max 20 ZeichenPatternnullable
inventoryTagstringoptional

Tenant-internes Inventaretikett.

max 60 Zeichennullable
assetIduuidoptional→ asset

Optionale FK auf das Asset im RMM-/Inventarmodul. Equipment-Assignment ist mitarbeiter-zentriert; ein Asset kann über Zeit verschiedene Zuweisungen haben.

nullable
issuedAtdateerforderlich

Übergabe-Datum.

returnedAtdateoptional

Rückgabe-Datum. Null = aktuell beim Mitarbeiter.

nullable
conditionAtIssuestringoptional

Zustand bei Übergabe. null = noch nicht erfasst.

Werte
NEWGOODUSEDDAMAGEDnull
nullable
conditionAtReturnstringoptional

Zustand bei Rückgabe. null = noch nicht zurückgegeben oder nicht erfasst.

Werte
NEWGOODUSEDDAMAGEDnull
nullable
agreementTypestringerforderlich

Rechtsbasis. WORK_TOOL_DIREKTIONSRECHT = reines Arbeitsmittel (§ 106 GewO); WIDERRUFSVORBEHALT = Privatnutzung erlaubt aber jederzeit widerrufbar; VERTRAGSBESTANDTEIL = im Arbeitsvertrag fixiert (→ flankierender contractualComponent IN_KIND nötig).

Werte
WORK_TOOL_DIREKTIONSRECHTWIDERRUFSVORBEHALTVERTRAGSBESTANDTEIL
privateUseAllowedbooleanoptional

Separat von agreementType, da WORK_TOOL_DIREKTIONSRECHT auch Privatnutzung erlauben kann (§ 3 Nr. 45 EStG = steuerfrei für AG-eigene Telekom-Geräte unabhängig vom Vertragsstatus).

Default: false
attachmentDocumentIdsuuid[]optional

FKs auf dms_documents — Übergabe-Protokoll, Fotos bei Übergabe, Rechnungs-Kopie etc.

max 20 ItemsDefault: []
notesstringoptional

Freitext-Notiz. Bei sensiblen Angaben (Diebstahl-Verdacht, Disziplinarbezug) lieber als ZK-Dokument im DMS hinterlegen statt hier.

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

Suche