Was bedeuten die Status-Werte und wie ändere ich den Lebenszyklus?

Ab Tarif Basic

Kurzantwort

Jedes Asset hat einen Status (Standard: Aktiv). Über „Bearbeiten” setzt du ihn auf einen der fünf Werte: Aktiv, Inaktiv, In Wartung, Außer Betrieb oder Entsorgt. Zusätzlich bilden Datumsfelder (Garantie bis, End of Life, End of Support) den weiteren Lebenszyklus ab.

Voraussetzungen

Das Asset-Modul ist im Kern enthalten und in allen Tarifen verfügbar.

Die Status-Werte

API-Wert (`status`)	Bedeutung
`active`	Aktiv: in Betrieb (Standard bei der Neuanlage).
`inactive`	Inaktiv: vorübergehend nicht genutzt.
`maintenance`	In Wartung: aktuell in Reparatur/Wartung.
`retired`	Außer Betrieb: ausgemustert, aber noch inventarisiert.
`disposed`	Entsorgt: endgültig aus dem Betrieb genommen.

In der Weboberfläche werden diese Werte übersetzt und als farbige Status-Badge angezeigt (z. B. Aktiv grün, In Wartung gelb, Entsorgt rot).

Asset öffnen und bearbeiten. Wähle Assets, öffne das Asset und klicke auf „Bearbeiten”.
Status wählen. Wähle im Feld Status den passenden Wert aus der Liste.

Screenshot ausstehend assets-status-01 Asset-Formular mit geöffneter Status-Auswahlliste

Der Status wird im Bearbeiten-Formular über die Auswahlliste gesetzt.
Speichern. Nach dem Speichern erscheint der neue Status als Badge in der Detailansicht und in der Asset-Liste.

Screenshot ausstehend assets-status-02 Asset-Liste mit farbigen Status-Badges in der Status-Spalte

Die Status-Spalte der Asset-Liste zeigt den Status als farbige Badge.

Den Status setzt du wie jedes andere Feld per PUT auf /api/v1/assets/{id}:

curl -X PUT https://demo.notory.io/api/v1/assets/a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55 \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{ "status": "maintenance" }'

Nach Status filtern (Scope read), der Query-Parameter heißt status:

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets?status=maintenance&page=1&page_size=25"

Mögliche Fehler: 422 bei einem unbekannten status-Wert (nur die fünf Werte aus der Tabelle sind gültig), 404 bei fremdem/nicht existierendem Asset.

Was passiert dabei?

Status ist ein Feld: Der Wechsel ist eine normale Aktualisierung (PUT); es werden dadurch keine automatischen Abläufe ausgelöst.
Audit-Trail: updated_by und updated_at werden gesetzt; der Wechsel ist über den Verlauf nachvollziehbar.
Lebenszyklus-Daten: Ergänze Garantie bis (warranty_expiry), End of Life (end_of_life) und End of Support (end_of_support) für die Ablauf- und Ersatzplanung.
Auswertung: Das Dashboard zählt u. a. aktive Assets und Assets in Wartung; in der Liste lässt sich nach Status filtern.
Mandanten-Isolation: Statusänderungen wirken nur auf Assets deines Mandanten.