Wie plane ich eine Wartung?

Ab Tarif Basic

Kurzantwort

Öffne das Modul Wartung, klicke auf „Wartungseintrag hinzufügen”, wähle das betroffene Asset, vergib einen Titel und ein Geplant am-Datum und speichere. Der Eintrag startet im Status Geplant. Pflicht sind nur Asset und Titel. Alles Weitere lässt sich jederzeit nachtragen.

Voraussetzungen

Die Wartung gehört zum Asset-Lebenszyklus und ist in allen Tarifen enthalten. Ein eigenes Modul-Recht ist nicht erforderlich.

Modul „Wartung” öffnen. Wähle in der linken Navigation Wartung. Du siehst die Liste aller Wartungseinträge. Oben rechts liegt die Schaltfläche „Wartungseintrag hinzufügen”.

Screenshot ausstehend wartung-planen-01 Wartungsliste mit hervorgehobener Schaltfläche 'Wartungseintrag hinzufügen' oben rechts

Die Wartungsübersicht mit der Schaltfläche 'Wartungseintrag hinzufügen'.
Formular ausfüllen. Es öffnet sich der Dialog „Wartungseintrag hinzufügen”. Fülle mindestens die Pflichtfelder aus:
- Asset-ID: die UUID des Assets, das gewartet wird.
- Titel: kurze Bezeichnung der Wartung (z. B. „Lüfter reinigen, Firmware-Update”).
Optional: Typ (z. B. Inspektion, Reparatur), Status (Standard: Geplant), Geplant am, Abgeschlossen am, Kosten, Durchgeführt von und Notizen.

Screenshot ausstehend wartung-planen-02 Dialog 'Wartungseintrag hinzufügen' mit den Feldern Asset-ID, Titel, Typ, Status, Geplant am

Der Dialog 'Wartungseintrag hinzufügen'. Pflicht sind Asset und Titel.
Speichern. Klicke auf „Speichern”. Der Eintrag erscheint sofort in der Liste, standardmäßig im Status Geplant.

Dieselbe Aktion per REST-API: ein POST auf /api/v1/maintenance mit einem Bearer-Token (Scope write). Pflicht sind asset_id und title.

curl -X POST https://demo.notory.io/api/v1/maintenance \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
    "title": "Lüfter reinigen, Firmware-Update",
    "maintenance_type": "Inspektion",
    "status": "scheduled",
    "scheduled_date": "2026-08-15",
    "cost": 0,
    "performed_by": "IT-Team",
    "notes": "Vor Ort in Raum 2.14"
  }'

Bei Erfolg antwortet die API mit HTTP 201 Created und dem angelegten Eintrag:

{
  "id": "c7d2b0a1-4e5f-4a99-b3c8-1d2e3f4a5b6c",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "asset_id": "a2f1c9e4-7b3d-4a11-9c2e-8f6b1d0a7e55",
  "title": "Lüfter reinigen, Firmware-Update",
  "maintenance_type": "Inspektion",
  "status": "scheduled",
  "scheduled_date": "2026-08-15",
  "completed_date": null,
  "cost": 0.0,
  "performed_by": "IT-Team",
  "notes": "Vor Ort in Raum 2.14",
  "created_at": "2026-07-08T09:20:00Z",
  "updated_at": "2026-07-08T09:20:00Z"
}

Mögliche Werte für status: scheduled, in_progress, completed, cancelled.

Mögliche Fehler: 401 (Token fehlt/ungültig), 403 (kein Schreibrecht), 422 (Validierung, z. B. fehlendes asset_id/title oder negative cost).

Was passiert dabei?

Mandanten-Zuordnung: Der Eintrag gehört automatisch deinem aktuellen Mandanten (tenant_id) und ist für andere Mandanten unsichtbar.
Audit-Trail: Anlage und spätere Änderungen werden protokolliert (Ersteller, Zeitstempel, IP) und erscheinen u. a. in den „letzten Aktivitäten” des Dashboards.
Bindung ans Asset: Der Eintrag hängt am angegebenen Asset. Wird das Asset gelöscht, entfällt auch seine Wartungshistorie (Kaskade).
Kein automatischer Statuswechsel: Ein geplanter Termin bleibt Geplant, bis du ihn selbst auf In Bearbeitung oder Abgeschlossen setzt. Siehe Wartungshistorie.
Keine automatische Wiederholung: Notory erzeugt aus einem Termin keine wiederkehrenden Wartungen. Regelmäßige Intervalle bildest du ab, indem du je Termin einen eigenen Eintrag anlegst.