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

Asset Handover Schema

Schema-ID
asset_handover
Collection
asset_handovers
Permissions
  • Lesenasset_handover_view
  • Anlegenasset_handover_create
  • Ändernasset_handover_edit
  • Löschenasset_handover_delete
Beziehungen

Felder

Asset Handover Schema

asset_handovers4 Permissions

Ausgabe-/Rückgabeprotokoll für ein Asset (ADR 0675). Ein Dokument je Ausgabevorgang; die Rückgabe setzt returnedAt auf demselben Dokument.

assetIduuiderforderlich→ asset

Asset, das ausgegeben wurde.

recipientTypestringerforderlich

USER = interne:r Mitarbeiter:in, PARTY_CONTACT = CRM-Kontakt/Firma (Leihgerät), EXTERNAL = Freitext ohne Datensatz.

Werte
USERPARTY_CONTACTEXTERNAL
recipientUserIduuidoptional

Interne:r Empfänger:in (users._id) — Pflicht bei recipientType USER.

Default: nullnullable
recipientPartyIduuidoptional

CRM-Empfänger (parties._id) — Pflicht bei recipientType PARTY_CONTACT.

Default: nullnullable
recipientNamestringoptional

Freitext-Name — Pflicht bei recipientType EXTERNAL, sonst optionale Ergänzung (z. B. der konkrete Mensch hinter einer Firma).

max 200 ZeichenDefault: nullnullable
recipientEmailstringoptional

Kontaktadresse des Empfängers, rein dokumentarisch.

max 200 ZeichenDefault: nullnullable
issuedAtdatetimeerforderlich

Zeitpunkt der Ausgabe.

issuedByUserIduuidoptional

Wer ausgegeben hat. Wird serverseitig vorbelegt, ist aber überschreibbar.

Default: nullnullable
conditionAtIssuestringoptional

Zustand bei Ausgabe.

Werte
NEWGOODUSEDDAMAGEDDEFECTIVEnull
Default: nullnullable
purposestringoptional

Anlass der Ausgabe (dokumentarisch).

Werte
PERMANENTLOANREPLACEMENTPROJECTREPAIROTHERnull
Default: nullnullable
expectedReturnAtdatetimeoptional

Vereinbarte Rückgabe — Grundlage für die Überfällig-Kennzeichnung.

Default: nullnullable
returnedAtdatetimeoptional

Zeitpunkt der Rückgabe. null = Asset ist aktuell beim Empfänger. Das Setzen dieses Feldes IST die Rückgabe.

Default: nullnullable
returnedToUserIduuidoptional

Wer die Rückgabe entgegengenommen hat.

Default: nullnullable
conditionAtReturnstringoptional

Zustand bei Rückgabe.

Werte
NEWGOODUSEDDAMAGEDDEFECTIVEnull
Default: nullnullable
returnNotesstringoptional

Bemerkungen zur Rückgabe (Schäden, fehlendes Zubehör).

max 2000 ZeichenDefault: nullnullable
accessoriesstring[]optional

Mitgegebenes Zubehör (Netzteil, Tasche, SIM, Schlüssel …).

max 50 ItemsDefault: []
locationstringoptional

Wo die Übergabe stattfand.

max 200 ZeichenDefault: nullnullable
ticketIduuidoptional

Auslösendes Ticket, falls die Ausgabe aus einem Vorgang heraus passierte.

Default: nullnullable
projectIduuidoptional

Auslösendes Projekt.

Default: nullnullable
equipmentAssignmentIduuidoptional

Verweis auf den HR-Datensatz (ADR 0115), falls die Ausgabe dort gepflegt wurde. Verhindert doppelte Zählung im Ausgabe-Tab.

Default: nullnullable
notesstringoptional

Freitext zur Ausgabe.

max 2000 ZeichenDefault: nullnullable
attachmentFileIdsuuid[]optional

Angehängte Dateien — unterschriebenes Übergabeprotokoll, Fotos.

max 20 ItemsDefault: []
signedProtocolFileIduuidoptional

Das unterschriebene Übergabeprotokoll, falls hochgeladen.

Default: nullnullable

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

Suche