Wie führe ich die Wartungshistorie und schließe eine Wartung ab?

Ab Tarif Basic

Kurzantwort

Die Liste im Modul Wartung ist zugleich die Wartungshistorie: Sie zeigt jeden Eintrag mit Asset, Titel, Status und Geplant am. Um eine Wartung abzuschließen, öffnest du den Eintrag über das Stift-Symbol, setzt den Status auf Abgeschlossen, trägst Abgeschlossen am und ggf. Kosten ein und speicherst.

Voraussetzungen

In allen Tarifen verfügbar (Teil des Asset-Lebenszyklus).

Historie einsehen. Öffne Wartung. Die Tabelle listet alle Wartungseinträge des Mandanten, nach Geplant am sortierbar. Über die Spalte Asset erkennst du, zu welchem Gerät ein Eintrag gehört; über die Spalte Status den Fortschritt (Geplant, In Bearbeitung, Abgeschlossen, Abgebrochen).

Screenshot ausstehend wartung-historie-01 Wartungsliste mit den Spalten Asset, Titel, Status und Geplant am

Die Wartungsliste als Historie, mit Asset-, Status- und Datumsspalte.
Eintrag öffnen. Klicke in der Zeile auf das Stift-Symbol (Bearbeiten). Der Dialog „Wartungseintrag bearbeiten” öffnet sich mit den vorhandenen Werten.
Abschließen und speichern. Setze Status auf Abgeschlossen, trage Abgeschlossen am und, falls angefallen, die Kosten und Durchgeführt von ein. „Speichern” schreibt die Änderung zurück; die Zeile zeigt den neuen Status.

Screenshot ausstehend wartung-historie-02 Dialog 'Wartungseintrag bearbeiten' mit Status auf Abgeschlossen, gesetztem Abschlussdatum und Kosten

Eine Wartung abschließen: Status, Abschlussdatum und Kosten erfassen.

Historie lesen: GET /api/v1/maintenance liefert alle Wartungseinträge des Mandanten (sortiert nach scheduled_date). Nach einem bestimmten Asset filterst du über das Feld asset_id:

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/maintenance

Wartung abschließen ist ein PUT auf /api/v1/maintenance/{id} mit den geänderten Feldern (Scope write):

curl -X PUT https://demo.notory.io/api/v1/maintenance/c7d2b0a1-4e5f-4a99-b3c8-1d2e3f4a5b6c \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed",
    "completed_date": "2026-08-15",
    "cost": 89.90,
    "performed_by": "M. Schröder"
  }'

{
  "id": "c7d2b0a1-4e5f-4a99-b3c8-1d2e3f4a5b6c",
  "asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "title": "Lüfter reinigen, Firmware-Update",
  "status": "completed",
  "scheduled_date": "2026-08-15",
  "completed_date": "2026-08-15",
  "cost": 89.9,
  "performed_by": "M. Schröder",
  "updated_at": "2026-08-15T14:05:11Z"
}

Mögliche Fehler: 401 (Token fehlt/ungültig), 403 (kein Schreibrecht), 404 (Eintrag nicht gefunden), 422 (Validierung).

Was passiert dabei?

Statusfluss: Der Status ist frei setzbar. Üblich ist Geplant → In Bearbeitung → Abgeschlossen; Abgebrochen beendet einen Termin ohne Durchführung. Notory erzwingt keine feste Reihenfolge.
Abschlussdatum nicht automatisch: Beim Setzen auf Abgeschlossen wird kein completed_date automatisch gefüllt. Trage es selbst ein, damit die Historie stimmt.
Audit-Trail: Jede Änderung wird protokolliert (Bearbeiter, Zeitstempel, IP).
Löschen ist Administratoren vorbehalten: Über das Papierkorb-Symbol bzw. DELETE /api/v1/maintenance/{id} entfernt ein Administrator einen Eintrag endgültig.