Docs — revuwork

Juni 2026

inventory v0.22.0 Juni 2026 Features

Audit-Journal: Filterfunktion

Das Audit-Journal lässt sich jetzt per Freitextsuche und nach Aktion sowie Zeitraum filtern; aktive Filter erscheinen als entfernbare Chips.

inventory v0.20.3 Juni 2026 Features

Import-Verbesserungen

Der JSON-Import akzeptiert Datumsfelder jetzt auch im deutschen Format (TT.MM.JJJJ).
Neues Feld „Kundennummer”: der Import ordnet Kunden jetzt vorrangig über die Kundennummer statt nur über den Namen zu.

inventory v0.20.1 Juni 2026 Fixes

Mehrere Fehler behoben

Das Dashboard lieferte für Editor- und Admin-Benutzer teilweise einen Serverfehler statt der Übersicht.
Das Import-Journal blieb beim direkten Aufruf über einen Link dauerhaft im Ladezustand hängen.
Prüfberichte waren für die Editor-Rolle fälschlich nicht zugänglich.

inventory v0.20.0 Juni 2026 Features

Mehr Möglichkeiten für die Editor-Rolle

Benutzer mit der Rolle „Editor” sehen jetzt zusätzlich die Bereiche Einstellungen (Lesezugriff), Sicherheit (eigene API-Schlüssel) und Import-Journal (eigene Importe des Mandanten).

inventory v0.19.1 Juni 2026 Fixes

Farbeinstellungen werden jetzt zuverlässig gespeichert

Eigene Farbeinstellungen wurden bisher nur lokal im Browser gemerkt und gingen bei einem Geräte- oder Browserwechsel verloren. Sie werden jetzt zentral gespeichert und stehen auf jedem Gerät gleich zur Verfügung.

inventory v0.19.0 Juni 2026 Features

Importierte Projekte löschen

Im Aktionsmenü der Prüfberichtsliste lässt sich ein importiertes Projekt (alle Berichte einer Projektnummer) gesammelt löschen, sobald nach Projektnummer gefiltert ist — mit Bestätigungsdialog vor dem unwiderruflichen Löschen.

inventory v0.17.0 Juni 2026 Features

Überarbeitetes Design

Neue Farbwelt und einheitliche Gestaltungsgrundlage in der gesamten Anwendung.
Einklappbare Seitenleiste, wahlweise mit oder ohne Beschriftung.
Neue, stapelbare Benachrichtigungen (Toasts) statt der bisherigen Meldungen.
Verbesserte Hilfetexte (Tooltips) und ein neuer Schritt-für-Schritt-Assistent für mehrstufige Formulare.

inventory v0.13.0 Juni 2026 Breaking

API-Feldnamen von Deutsch auf Englisch umgestellt

Alle Feldnamen in den API-Antworten wurden von deutschen auf englische Bezeichnungen umgestellt (z. B. Arbeitsmitteltyp → DeviceType, Gebaeude → Building, Ergebnis → Result). Eigene Integrationen, die zu diesem frühen Zeitpunkt bereits auf die API zugegriffen haben, mussten ihre Feldnamen entsprechend anpassen.

inventory v0.12.0 Juni 2026 Features

Neue Tabs in der Inventar-Detailansicht

Tab „Prüfvorschriften”: Zuweisung aus einem zentralen Katalog, Sortierung, Aktivieren/Deaktivieren.
Tab „Dokumente”: Dateien direkt am Betriebsmittel hochladen, mit Beschreibung und Kategorie versehen.

inventory v0.9.0 Juni 2026 Features

Prüfberichte-Liste überarbeitet

Server-seitige Filterung und Seitenweise-Ladung — deutlich schneller bei vielen Prüfberichten.
Aktive Filter erscheinen als entfernbare Chips (Freitext, Projektnummer, Ergebnis, Prüfer, Standort, Prüfdatum u. a.).
Sichtbare Spalten frei konfigurierbar, Einstellung pro Benutzer gespeichert.
Excel-Export aller gefilterten oder nur der ausgewählten Berichte.

inventory v0.8.1 Juni 2026 Features

Inventarliste: frei wählbare Spalten

Über den Button „Spalten” lässt sich festlegen, welche Spalten sichtbar sind und in welcher Reihenfolge sie erscheinen (u. a. Hersteller, Seriennummer, letzte Prüfung, Schutzklasse, Leitungslänge, Projektnummer).
Die Einstellung wird pro Benutzer gespeichert.

inventory v0.8.0 Juni 2026 Features

Konfigurierbare Webhooks

Neuer Bereich in der Administration: ausgehende Webhooks für Systemereignisse (Betriebsmittel/Prüfeintrag angelegt/bearbeitet/gelöscht, Prüf-PDF erstellt, Wiederholungsprüfung fällig).
Beliebig viele eigene HTTP-Header je Webhook, Test-Button zur Erreichbarkeitsprüfung.

inventory v0.6.3 Juni 2026 Feature

Kundenverwaltung

Neuer Bereich zur Verwaltung von Kunden (Name, Anschrift).
Betriebsmittel lassen sich einem Kunden zuordnen, auch nachträglich per Mehrfachauswahl in der Inventarliste.
Der Excel-Import erkennt die Kundenanschrift automatisch und legt fehlende Kunden selbstständig an.

inventory v0.6.0 Juni 2026 Feature

Hilfe & Support direkt in revuwork

Neuer Bereich „Hilfe & Support”: Fehlermeldungen oder Änderungswünsche direkt aus der Anwendung heraus einreichen, inklusive Dateianhängen (Screenshots, PDFs).
Ticket-Verlauf im Chat-Stil mit Status (Offen, In Bearbeitung, Gelöst, Geschlossen u. a.).
Benachrichtigung per E-Mail bei Antworten.

inventory v0.5.0 Juni 2026 Feature

Inventarnummer, Prüfvorlagen und automatische Benachrichtigungen

Neues Feld Inventarnummer als eindeutiger Schlüssel je Betriebsmittel; wird beim Import automatisch erkannt und bei unbekannter Nummer legt der Import das Gerät direkt neu an.
Sichtprüfungs-Vorlagen sind jetzt konfigurierbar: die vorgegebenen DGUV-V3-Standardschritte lassen sich pro Mandant anpassen oder um eigene Schritte ergänzen.
Bereits abgeschlossene Prüfberichte lassen sich bei Bedarf als PDF neu erzeugen (z. B. nach Korrektur von Stammdaten).
Neu: automatische E-Mail- und Webhook-Benachrichtigungen vor Fälligkeit von Prüfungen, mit frei konfigurierbaren Vorlaufzeiten und zusätzlichen Empfängern.

inventory v0.4.0 Juni 2026 Feature

DGUV V3: normkonforme Elektroprüfungsdokumentation

Neue Felder für Schutzklasse, Leitungslänge und Seriennummer bei Betriebsmitteln.
Automatische Berechnung der zulässigen Grenzwerte (Schutzleiterwiderstand, Isolationswiderstand, Ableitstrom) nach VDE 0701/0702, abhängig von Schutzklasse und Leitungslänge.
Neues, geführtes Prüfformular in vier Schritten: Gerät & Prüfdaten, Sichtprüfung, Messwerte mit automatischem Grenzwertvergleich, Abschluss.
Hinweis, wenn die Qualifikation des Prüfers nicht zur Schutzklasse passt (z. B. Elektrofachkraft erforderlich).
Normkonformer PDF-Prüfbericht nach DIN EN 50699, direkt aus dem abgeschlossenen Prüfbericht herunterladbar.

inventory v0.3.0 Juni 2026 Neu

E-Mail-Bestätigung bei der Registrierung

Neue Konten werden per Bestätigungslink per E-Mail freigeschaltet — ein Login ist erst nach der Bestätigung möglich.
Der Login-Bildschirm zeigt jetzt das revuwork-Logo und die aktuelle Versionsnummer.

inventory v0.2.0 Juni 2026 Neu

REST-API und PDF-Export

REST-API mit Bearer-Token-Authentifizierung
PDF-Export für Prüfprotokolle
Prüfergebnisse erfassen und signieren
Dashboard-Performance bei großen Inventaren verbessert
Import-Assistent zeigt jetzt eine Vorschau vor dem Import

Nächster Monat →

Auth

Anmeldung, Registrierung und Benutzerinfo

Statuscodes

200 Anmeldung erfolgreich

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "email": "benutzer@beispiel.de",
  "password": "MeinPasswort1!"
}

Response Beispiel

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Max Mustermann",
  "email": "max@musterfirma.de",
  "role": "Admin",
  "mandantId": 3,
  "mandantName": "Musterfirma GmbH"
}

Statuscodes

200 Benutzerdaten

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Max Mustermann",
  "email": "max@musterfirma.de",
  "role": "Admin",
  "mandantId": 3,
  "mandantName": "Musterfirma GmbH"
}

Statuscodes

202 Registrierung eingereicht – Bestätigungs-E-Mail wurde versandt

400 Validierungsfehler

403 Öffentliche Registrierung deaktiviert

409 E-Mail-Adresse/Unternehmen bereits vorhanden, oder Einladung (bei `type=Mitarbeiter`) ungültig, abgelaufen oder bereits verwendet

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "type": "Mitarbeiter",
  "inviteToken": "3f9a1c...",
  "adminFirstName": "Erika",
  "adminLastName": "Musterfrau",
  "adminEmail": "employee@firma.de",
  "adminPassword": "MeinPasswort1!",
  "newsSubscriptionEnabled": true
}

Response Beispiel

{
  "message": "Registrierung eingereicht. Bitte bestätigen Sie Ihre E-Mail-Adresse.",
  "tenantId": 3,
  "status": "Pending"
}

Statuscodes

200 Einladung gültig

404 Einladung ungültig, abgelaufen, widerrufen oder bereits verwendet

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "tenantName": "Muster GmbH",
  "email": "employee@firma.de"
}

Statuscodes

202 Registrierung eingereicht – wartet auf Freischaltung

400 Validierungsfehler

409 Unternehmen oder E-Mail bereits vorhanden

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "companyName": "Musterfirma GmbH",
  "adminName": "Erika Musterfrau",
  "adminEmail": "admin@musterfirma.de",
  "adminPassword": "Sicher1234!",
  "addressCompany": "Musterfirma GmbH",
  "addressStreet": "Musterstraße 1",
  "addressZip": "12345",
  "addressCity": "Musterstadt",
  "addressCountry": "Deutschland"
}

Statuscodes

200 Spalteneinstellungen

400 Fehler

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

[
  {
    "columnKey": "inventarnummer",
    "isVisible": true,
    "sortOrder": 1
  },
  {
    "columnKey": "ergebnis",
    "isVisible": true,
    "sortOrder": 2
  },
  {
    "columnKey": "naechstePruefung",
    "isVisible": true,
    "sortOrder": 3
  }
]

Statuscodes

204 Einstellungen gespeichert

400 Fehler

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

[
  {
    "columnKey": "inventarnummer",
    "isVisible": true,
    "sortOrder": 1
  },
  {
    "columnKey": "ergebnis",
    "isVisible": false,
    "sortOrder": 2
  }
]

Statuscodes

200 Gruppierebenen

400 Fehler

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

[
  {
    "columnKey": "customerName",
    "sortOrder": 0
  }
]

Statuscodes

204 Gruppierebenen gespeichert

400 Fehler

401 Nicht authentifiziert

422 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

[
  {
    "columnKey": "customerName",
    "sortOrder": 0
  }
]

Statuscodes

200 Passwort erfolgreich gesetzt

400 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "userId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "token": "CfDJ8...",
  "password": "NeuesPasswort1!",
  "confirmPassword": "NeuesPasswort1!"
}

Response Beispiel

{
  "message": "Passwort erfolgreich gesetzt. Sie können sich jetzt anmelden."
}

Inventar

Inventareinträge lesen, bearbeiten und exportieren

Statuscodes

200 Paginierte Inventarliste

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "items": [],
  "totalCount": 320,
  "page": 1,
  "pageSize": 25,
  "totalPages": 13
}

Statuscodes

201 Angelegter Inventareintrag

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 Inventarnummer bereits vergeben

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "inventoryNumber": "INV-1099",
  "deviceType": "Günzburger 3x10 Sprossen",
  "deviceCategory": "Leiter",
  "manufacturer": "Günzburger",
  "building": "Halle A",
  "floor": "EG",
  "room": "Lager",
  "result": "Offen",
  "lastInspectionDate": "2026-07-07",
  "nextInspectionDate": "2027-07-07",
  "customFields": []
}

Response Beispiel

{
  "id": 1042,
  "inventarnummer": "INV-1042",
  "arbeitsmitteltyp": "Günzburger 3x10 Sprossen",
  "arbeitsmittelart": "Leiter",
  "hersteller": "Günzburger",
  "gebaeude": "Halle A",
  "geschoss": "EG",
  "raum": "Lager",
  "ergebnis": "Bestanden",
  "letztePruefung": "2024-03-15",
  "naechstePruefung": "2025-03-15",
  "projectNumber": 2024001,
  "updatedAt": "2024-03-15T14:22:00Z",
  "schutzklasse": "I",
  "leitungslaenge": 3.5,
  "seriennummer": "SN-00042",
  "externalReference": "EXT-REF-042",
  "inspectionCount": 3,
  "customerId": 7,
  "customerName": "Musterfirma GmbH",
  "customFields": {}
}

Statuscodes

200 Inventareintrag

401 Nicht authentifiziert

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "id": 1042,
  "inventarnummer": "INV-1042",
  "arbeitsmitteltyp": "Günzburger 3x10 Sprossen",
  "arbeitsmittelart": "Leiter",
  "hersteller": "Günzburger",
  "gebaeude": "Halle A",
  "geschoss": "EG",
  "raum": "Lager",
  "ergebnis": "Bestanden",
  "letztePruefung": "2024-03-15",
  "naechstePruefung": "2025-03-15",
  "projectNumber": 2024001,
  "updatedAt": "2024-03-15T14:22:00Z",
  "schutzklasse": "I",
  "leitungslaenge": 3.5,
  "seriennummer": "SN-00042",
  "externalReference": "EXT-REF-042",
  "inspectionCount": 3,
  "customerId": 7,
  "customerName": "Musterfirma GmbH",
  "customFields": {}
}

Statuscodes

200 Aktualisierter Inventareintrag

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "deviceType": "Günzburger 3x10 Sprossen",
  "deviceCategory": "Leiter",
  "manufacturer": "Günzburger",
  "building": "Halle A",
  "floor": "EG",
  "room": "Lager",
  "result": "Bestanden",
  "lastInspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "customFields": []
}

Response Beispiel

{
  "id": 1042,
  "inventarnummer": "INV-1042",
  "arbeitsmitteltyp": "Günzburger 3x10 Sprossen",
  "arbeitsmittelart": "Leiter",
  "hersteller": "Günzburger",
  "gebaeude": "Halle A",
  "geschoss": "EG",
  "raum": "Lager",
  "ergebnis": "Bestanden",
  "letztePruefung": "2024-03-15",
  "naechstePruefung": "2025-03-15",
  "projectNumber": 2024001,
  "updatedAt": "2024-03-15T14:22:00Z",
  "schutzklasse": "I",
  "leitungslaenge": 3.5,
  "seriennummer": "SN-00042",
  "externalReference": "EXT-REF-042",
  "inspectionCount": 3,
  "customerId": 7,
  "customerName": "Musterfirma GmbH",
  "customFields": {}
}

Statuscodes

200 Filterwerte gruppiert nach Feldname

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "deviceCategory": [
    "Leiter",
    "Kran",
    "Hubarbeitsbühne"
  ],
  "building": [
    "Halle A",
    "Halle B"
  ],
  "result": [
    "Bestanden",
    "Nicht bestanden"
  ]
}

Statuscodes

200 MXP-Datei

400 Fehler

401 Nicht authentifiziert

422 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "ids": [
    101,
    102,
    103
  ]
}

Statuscodes

201 Dokument hochgeladen

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "id": 1,
  "inventoryId": 1042,
  "fileName": "pruefprotokoll_2024.pdf",
  "description": "Prüfprotokoll März 2024",
  "category": "Prüfberichte",
  "uploadedAt": "2024-03-15T14:00:00Z",
  "uploadedBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Statuscodes

200 Liste der Gefährdungsbeurteilungen

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

[
  {
    "id": 1,
    "inventoryItemId": 1042,
    "number": 1,
    "date": "2024-03-15",
    "description": "Regelmäßige Gefährdungsbeurteilung",
    "inspectorUserId": null,
    "inspectorName": "Hans Prüfer",
    "hazardClass": 2,
    "scopeVisualCheck": true,
    "scopeElectrical": true,
    "scopeMechanical": false,
    "scopeFunction": false,
    "createdAt": "2024-03-15T10:00:00Z"
  }
]

Statuscodes

201 Gefährdungsbeurteilung angelegt

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "date": "2024-03-15",
  "description": "Regelmäßige Gefährdungsbeurteilung",
  "inspectorUserId": null,
  "inspectorName": "Hans Prüfer",
  "hazardClass": 2,
  "scopeVisualCheck": true,
  "scopeElectrical": true,
  "scopeMechanical": false,
  "scopeFunction": false
}

Response Beispiel

{
  "id": 1,
  "inventoryItemId": 1042,
  "number": 1,
  "date": "2024-03-15",
  "description": "Regelmäßige Gefährdungsbeurteilung",
  "inspectorUserId": null,
  "inspectorName": "Hans Prüfer",
  "hazardClass": 2,
  "scopeVisualCheck": true,
  "scopeElectrical": true,
  "scopeMechanical": false,
  "scopeFunction": false,
  "createdAt": "2024-03-15T10:00:00Z"
}

Statuscodes

200 Aktualisierte Gefährdungsbeurteilung

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "date": "2024-03-15",
  "description": "Regelmäßige Gefährdungsbeurteilung",
  "inspectorUserId": null,
  "inspectorName": "Hans Prüfer",
  "hazardClass": 2,
  "scopeVisualCheck": true,
  "scopeElectrical": true,
  "scopeMechanical": false,
  "scopeFunction": false
}

Response Beispiel

{
  "id": 1,
  "inventoryItemId": 1042,
  "number": 1,
  "date": "2024-03-15",
  "description": "Regelmäßige Gefährdungsbeurteilung",
  "inspectorUserId": null,
  "inspectorName": "Hans Prüfer",
  "hazardClass": 2,
  "scopeVisualCheck": true,
  "scopeElectrical": true,
  "scopeMechanical": false,
  "scopeFunction": false,
  "createdAt": "2024-03-15T10:00:00Z"
}

Statuscodes

200 Liste der zugewiesenen Prüfvorschriften

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

[
  {
    "id": 5,
    "inventoryId": 1042,
    "inspectionRegulationId": 1,
    "name": "DGUV V3",
    "isActive": true,
    "sortOrder": 1
  }
]

Statuscodes

201 Prüfvorschrift angelegt

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "name": "DGUV V3"
}

Response Beispiel

{
  "id": 5,
  "inventoryId": 1042,
  "inspectionRegulationId": 1,
  "name": "DGUV V3",
  "isActive": true,
  "sortOrder": 1
}

Statuscodes

200 Katalogeinträge

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

[
  {
    "id": 1,
    "name": "DGUV V3"
  },
  {
    "id": 2,
    "name": "VDE 0701/0702"
  }
]

Statuscodes

204 Reihenfolge getauscht

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "pvId1": 5,
  "pvId2": 6
}

Statuscodes

200 Aktualisierte Prüfvorschrift

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "isActive": true,
  "sortOrder": 2
}

Response Beispiel

{
  "id": 5,
  "inventoryId": 1042,
  "inspectionRegulationId": 1,
  "name": "DGUV V3",
  "isActive": true,
  "sortOrder": 1
}

Statuscodes

200 Laufergebnis

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "mandantenProcessed": 5,
  "itemsArchived": 12,
  "errors": []
}

Statuscodes

200 Liste der zuweisbaren Benutzer

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Response Beispiel

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hans Prüfer"
  }
]

Statuscodes

204 Zuweisung erfolgreich gesetzt

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Request Beispiel

{
  "inventoryIds": [
    101,
    102,
    103
  ],
  "customerId": 7
}

Prüfberichte

Prüfergebnisse importieren und abrufen (MXP / JSON)

Statuscodes

200 Importergebnis

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "projectNumber": 2024001,
  "importedCount": 42,
  "autoCreatedInventoryItems": 3,
  "warnings": [
    "Inventarnummer 'INV-0099' konnte keinem Eintrag zugeordnet werden."
  ],
  "customerNo": "10042"
}

Statuscodes

200 Importergebnis

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "projectNumber": 2024001,
  "fileName": "pruefberichte_2024.json",
  "customer": [
    {
      "customerNo": 10042,
      "name": "Musterfirma GmbH",
      "street": "Musterstraße",
      "houseNumber": "1",
      "zipCode": "12345",
      "city": "Musterstadt",
      "country": "Deutschland"
    }
  ],
  "reports": [
    {
      "reportKey": "RPT-001",
      "reportNumber": "24-001",
      "inspectionDate": "2024-03-15",
      "nextInspectionDate": "2025-03-15",
      "result": "Bestanden",
      "deviceType": "Günzburger 3x10 Sprossen",
      "deviceCategory": "Leiter",
      "manufacturer": "Günzburger",
      "inventoryNumber": "INV-1042",
      "location": "Halle A",
      "inspector": "Hans Prüfer"
    }
  ]
}

Response Beispiel

{
  "projectNumber": 2024001,
  "importedCount": 42,
  "autoCreatedInventoryItems": 3,
  "warnings": [
    "Inventarnummer 'INV-0099' konnte keinem Eintrag zugeordnet werden."
  ],
  "customerNo": "10042"
}

Statuscodes

201 Prüfbericht angelegt

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

422 Geschäftsregel-Fehler oder semantisch ungültige Anfrage

Request Beispiel

{
  "inventoryItemId": 1042,
  "schutzklasse": "SK_I",
  "leitungslaenge": 3.5,
  "hatHeizelement": false,
  "inspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "pruefartNorm": "VDE0701",
  "inspector": "Hans Prüfer",
  "inspectorQualification": "VDSI-Fachkraft",
  "pruefplaketteFaellig": "2025-03-15",
  "visualChecks": [
    {
      "order": 1,
      "function": "Sichtprüfung",
      "step": "Gehäuse",
      "criterion": "Keine sichtbaren Schäden",
      "passed": true
    }
  ],
  "measurements": [
    {
      "order": 1,
      "measurementType": "Schutzleiterwiderstand",
      "unit": "Ω",
      "calculatedLimitValue": 0.3,
      "measuredValue": 0.12,
      "passed": true
    }
  ]
}

Response Beispiel

{
  "id": 301,
  "mandantId": 3,
  "projectNumber": 2024001,
  "inventoryItemId": 1042,
  "reportKey": "RPT-001",
  "reportNumber": "24-001",
  "inspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "standard": "DGUV V3",
  "inspector": "Hans Prüfer",
  "result": "Bestanden",
  "location": "Halle A",
  "department": "Produktion",
  "deviceType": "Günzburger 3x10 Sprossen",
  "deviceCategory": "Leiter",
  "manufacturer": "Günzburger",
  "inventoryNumber": "INV-1042",
  "customerName": "Musterfirma GmbH",
  "importedAt": "2024-03-16T08:00:00Z",
  "inspectorQualification": "VDSI-Fachkraft",
  "pruefartNorm": "DGUV V3 §5",
  "pruefplaketteFaellig": "2025-03-15",
  "isFinalized": true,
  "finalizedAt": "2024-03-16T09:00:00Z",
  "hasPdf": true,
  "externalReference": "EXT-RPT-042",
  "customFields": {}
}

Statuscodes

200 Prüfbericht mit Details (inkl. Prüfschritte und Messwerte)

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "id": 301,
  "mandantId": 3,
  "projectNumber": 2024001,
  "inventoryItemId": 1042,
  "reportKey": "RPT-001",
  "reportNumber": "24-001",
  "inspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "standard": "DGUV V3",
  "inspector": "Hans Prüfer",
  "result": "Bestanden",
  "location": "Halle A",
  "department": "Produktion",
  "deviceType": "Günzburger 3x10 Sprossen",
  "deviceCategory": "Leiter",
  "manufacturer": "Günzburger",
  "inventoryNumber": "INV-1042",
  "customerName": "Musterfirma GmbH",
  "importedAt": "2024-03-16T08:00:00Z",
  "inspectorQualification": "VDSI-Fachkraft",
  "pruefartNorm": "DGUV V3 §5",
  "pruefplaketteFaellig": "2025-03-15",
  "isFinalized": true,
  "finalizedAt": "2024-03-16T09:00:00Z",
  "hasPdf": true,
  "externalReference": "EXT-RPT-042",
  "customFields": {}
}

Statuscodes

200 Aktualisierter Prüfbericht

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Fehler

Request Beispiel

{
  "inventoryItemId": 1042,
  "schutzklasse": "SK_I",
  "leitungslaenge": 3.5,
  "hatHeizelement": false,
  "inspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "pruefartNorm": "VDE0701",
  "inspector": "Hans Prüfer",
  "inspectorQualification": "VDSI-Fachkraft",
  "pruefplaketteFaellig": "2025-03-15",
  "visualChecks": [
    {
      "order": 1,
      "function": "Sichtprüfung",
      "step": "Gehäuse",
      "criterion": "Keine sichtbaren Schäden",
      "passed": true
    }
  ],
  "measurements": [
    {
      "order": 1,
      "measurementType": "Schutzleiterwiderstand",
      "unit": "Ω",
      "calculatedLimitValue": 0.3,
      "measuredValue": 0.12,
      "passed": true
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 301,
  "mandantId": 3,
  "projectNumber": 2024001,
  "inventoryItemId": 1042,
  "reportKey": "RPT-001",
  "reportNumber": "24-001",
  "inspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "standard": "DGUV V3",
  "inspector": "Hans Prüfer",
  "result": "Bestanden",
  "location": "Halle A",
  "department": "Produktion",
  "deviceType": "Günzburger 3x10 Sprossen",
  "deviceCategory": "Leiter",
  "manufacturer": "Günzburger",
  "inventoryNumber": "INV-1042",
  "customerName": "Musterfirma GmbH",
  "importedAt": "2024-03-16T08:00:00Z",
  "inspectorQualification": "VDSI-Fachkraft",
  "pruefartNorm": "DGUV V3 §5",
  "pruefplaketteFaellig": "2025-03-15",
  "isFinalized": true,
  "finalizedAt": "2024-03-16T09:00:00Z",
  "hasPdf": true,
  "externalReference": "EXT-RPT-042",
  "customFields": {}
}

Statuscodes

200 Zusammenfassung der Prüfergebnisse

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "totalReports": 150,
  "passed": 130,
  "failed": 8,
  "overdueCount": 5,
  "dueSoonCount": 12
}

Statuscodes

200 Laufergebnis

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "mandantenProcessed": 3,
  "filesBackedUp": 47,
  "errors": []
}

Statuscodes

200 Berechnete Grenzwerte

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Response Beispiel

{
  "schutzleiterwiderstandMax": 0.3,
  "isolationswiderstandMin": 1,
  "ableitstromMax": 3.5
}

Statuscodes

200 Filterwerte

401 Nicht authentifiziert

Response Beispiel

{
  "projectNumbers": [
    2024001,
    2024002
  ],
  "results": [
    "Bestanden",
    "Nicht bestanden"
  ],
  "inspectors": [
    "Hans Prüfer"
  ],
  "locations": [
    "Halle A"
  ],
  "manufacturers": [
    "Günzburger"
  ]
}

Statuscodes

200 Finalisierter Prüfbericht

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Fehler

422 Geschäftsregel-Fehler oder semantisch ungültige Anfrage

Response Beispiel

{
  "id": 301,
  "mandantId": 3,
  "projectNumber": 2024001,
  "inventoryItemId": 1042,
  "reportKey": "RPT-001",
  "reportNumber": "24-001",
  "inspectionDate": "2024-03-15",
  "nextInspectionDate": "2025-03-15",
  "standard": "DGUV V3",
  "inspector": "Hans Prüfer",
  "result": "Bestanden",
  "location": "Halle A",
  "department": "Produktion",
  "deviceType": "Günzburger 3x10 Sprossen",
  "deviceCategory": "Leiter",
  "manufacturer": "Günzburger",
  "inventoryNumber": "INV-1042",
  "customerName": "Musterfirma GmbH",
  "importedAt": "2024-03-16T08:00:00Z",
  "inspectorQualification": "VDSI-Fachkraft",
  "pruefartNorm": "DGUV V3 §5",
  "pruefplaketteFaellig": "2025-03-15",
  "isFinalized": true,
  "finalizedAt": "2024-03-16T09:00:00Z",
  "hasPdf": true,
  "externalReference": "EXT-RPT-042",
  "customFields": {}
}

Import

Inventardaten per XLS-Datei oder JSON importieren

Statuscodes

200 Importergebnis

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "importedCount": 98,
  "skippedCount": 2,
  "errors": [
    "Zeile 5: Ungültiges Datumsformat in 'letztePruefung'."
  ],
  "folderPath": "/imports/2024-03-15",
  "customerNo": "10042"
}

Statuscodes

200 Importergebnis

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 Fehler

Request Beispiel

{
  "provider": "dropbox",
  "sourcePath": "Exports/2026-Inventar.xlsx"
}

Response Beispiel

{
  "importedCount": 98,
  "skippedCount": 2,
  "errors": [
    "Zeile 5: Ungültiges Datumsformat in 'letztePruefung'."
  ],
  "folderPath": "/imports/2024-03-15",
  "customerNo": "10042"
}

Statuscodes

200 Importergebnis

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "fileName": "inventar_export_2024.json",
  "customer": [
    {
      "customerNo": 10042,
      "name": "Musterfirma GmbH",
      "street": "Musterstraße",
      "houseNumber": "1",
      "zipCode": "12345",
      "city": "Musterstadt",
      "country": "Deutschland"
    }
  ],
  "rows": [
    {
      "inventarnummer": "INV-1042",
      "arbeitsmitteltyp": "Günzburger 3x10 Sprossen",
      "arbeitsmittelart": "Leiter",
      "hersteller": "Günzburger",
      "gebaeude": "Halle A",
      "geschoss": "EG",
      "raum": "Lager",
      "ergebnis": "Bestanden",
      "letztePruefung": "2024-03-15",
      "naechstePruefung": "2025-03-15",
      "projectNumber": 2024001
    }
  ]
}

Response Beispiel

{
  "importedCount": 98,
  "skippedCount": 2,
  "errors": [
    "Zeile 5: Ungültiges Datumsformat in 'letztePruefung'."
  ],
  "folderPath": "/imports/2024-03-15",
  "customerNo": "10042"
}

Dashboard

Statistiken für die Startseite

Statuscodes

200 Statistiken

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "totalItems": 320,
  "overdueCount": 5,
  "dueSoonCount": 18,
  "passed": 280,
  "failed": 8,
  "openCount": 32,
  "defectRateByProject": [
    {
      "projectNumber": "42",
      "total": 20,
      "defects": 5,
      "defectRatePercent": 25,
      "customerName": "Musterfirma GmbH"
    }
  ]
}

Statuscodes

200 Verfügbare Filteroptionen

401 Nicht authentifiziert

Response Beispiel

{
  "projectNumbers": [
    "100",
    "200"
  ],
  "customers": [
    {
      "id": 12,
      "name": "Musterfirma GmbH"
    }
  ]
}

Einstellungen

Mandantenspezifische Einstellungen und Branding

Statuscodes

200 Branding-Daten

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "companyName": "Musterfirma GmbH",
  "logoBase64": null,
  "primaryColor": "#0891b2",
  "accentColor": "#7c3aed",
  "dueSoonThresholdDays": 90,
  "addressCompany": "Musterfirma GmbH",
  "statusOkColor": "#059669",
  "statusWarningColor": "#d97706",
  "statusErrorColor": "#dc2626",
  "roleSuperAdminColor": "#92400e",
  "roleAdminColor": "#1d4ed8",
  "roleEditorColor": "#6d28d9",
  "roleViewerColor": "#374151",
  "roleApiClientColor": "#065f46"
}

Statuscodes

200 Einstellungen

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "companyName": "Musterfirma GmbH",
  "logoBase64": null,
  "primaryColor": "#0891b2",
  "accentColor": "#7c3aed",
  "defaultInspectionIntervalDays": 365,
  "dueSoonThresholdDays": 90,
  "notificationEmail": "benachrichtigung@musterfirma.de",
  "addressCompany": "Musterfirma GmbH",
  "addressStreet": "Musterstraße 1",
  "addressZip": "12345",
  "addressCity": "Musterstadt",
  "addressCountry": "Deutschland",
  "inventoryArchiveThresholdYears": 5,
  "inventoryAutoArchiveEnabled": false,
  "pruefberichtAutoBackupEnabled": false,
  "statusOkColor": "#059669",
  "statusWarningColor": "#d97706",
  "statusErrorColor": "#dc2626",
  "roleSuperAdminColor": "#92400e",
  "roleAdminColor": "#1d4ed8",
  "roleEditorColor": "#6d28d9",
  "roleViewerColor": "#374151",
  "roleApiClientColor": "#065f46"
}

Statuscodes

204 Erfolgreich gespeichert

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

422 Geschäftsregel-Fehler oder semantisch ungültige Anfrage

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "companyName": "Musterfirma GmbH",
  "logoBase64": null,
  "primaryColor": "#0891b2",
  "accentColor": "#7c3aed",
  "defaultInspectionIntervalDays": 365,
  "dueSoonThresholdDays": 90,
  "notificationEmail": "benachrichtigung@musterfirma.de",
  "addressCompany": "Musterfirma GmbH",
  "addressStreet": "Musterstraße 1",
  "addressZip": "12345",
  "addressCity": "Musterstadt",
  "addressCountry": "Deutschland",
  "inventoryArchiveThresholdYears": 5,
  "inventoryAutoArchiveEnabled": false,
  "pruefberichtAutoBackupEnabled": false,
  "statusOkColor": "#059669",
  "statusWarningColor": "#d97706",
  "statusErrorColor": "#dc2626",
  "roleSuperAdminColor": "#92400e",
  "roleAdminColor": "#1d4ed8",
  "roleEditorColor": "#6d28d9",
  "roleViewerColor": "#374151",
  "roleApiClientColor": "#065f46"
}

Admin – Benutzer

Benutzerverwaltung innerhalb eines Mandanten (Rolle Admin)

Statuscodes

200 Paginierte Benutzerliste

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "items": [],
  "totalCount": 320,
  "page": 1,
  "pageSize": 25,
  "totalPages": 13
}

Statuscodes

201 Benutzer angelegt

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 E-Mail-Adresse wird bereits verwendet

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "name": "Lena Beispiel",
  "email": "lena@musterfirma.de",
  "password": "Passwort123!",
  "role": "Editor"
}

Response Beispiel

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Max Mustermann",
  "email": "max@musterfirma.de",
  "role": "Editor",
  "isLockedOut": false,
  "emailConfirmed": true,
  "emailConfirmationAttempts": 1,
  "emailConfirmationLastSentAt": "2024-01-01T10:00:00Z",
  "emailConfirmationLastError": null,
  "mandantId": 3,
  "mandantName": "Musterfirma GmbH"
}

Statuscodes

204 Erfolgreich aktualisiert

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "name": "Lena Musterfrau",
  "email": "lena.neu@musterfirma.de",
  "role": "Admin",
  "mandantId": null
}

Statuscodes

201 Einladung erstellt

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 Ungültige Rolle(n) oder Lizenz-Benutzerlimit erreicht

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "email": "employee@firma.de",
  "roles": [
    "Editor"
  ]
}

Response Beispiel

{
  "id": 12,
  "email": "employee@firma.de",
  "roles": [
    "Editor"
  ],
  "createdAt": "2026-07-08T10:00:00Z",
  "expiresAt": "2026-07-15T10:00:00Z"
}

Admin – API-Keys

Verwaltung von API-Keys (Rolle Admin)

Statuscodes

200 Paginierte API-Key-Liste

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "items": [],
  "totalCount": 320,
  "page": 1,
  "pageSize": 25,
  "totalPages": 13
}

Statuscodes

201 API-Key erstellt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

422 Geschäftsregel-Fehler oder semantisch ungültige Anfrage

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "name": "Prüfgerät Halle A"
}

Response Beispiel

{
  "id": 12,
  "name": "Prüfgerät Halle A",
  "plainKey": "rw_a1b2c3d4e5f6g7h8i9j0klmnopqrstuvwxyz"
}

Admin – Visual-Check-Vorlagen

Verwaltung der Sichtprüfungs-Vorlagen (Rolle Admin)

Statuscodes

200 Liste der Sichtprüfungsschritte

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Response Beispiel

[
  {
    "order": 1,
    "function": "Sichtprüfung",
    "step": "Gehäuse",
    "criterion": "Keine sichtbaren Schäden",
    "source": "global"
  }
]

Statuscodes

200 Aktualisierte Vorlage

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Request Beispiel

[
  {
    "order": 1,
    "function": "Sichtprüfung",
    "step": "Gehäuse",
    "criterion": "Keine sichtbaren Schäden"
  }
]

Admin – Benachrichtigungskonfiguration

Benachrichtigungsschwellwerte und E-Mail-Adressen konfigurieren (Rolle Admin)

Statuscodes

200 Benachrichtigungskonfiguration

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Response Beispiel

{
  "thresholdDays": [
    30,
    60,
    90
  ],
  "notifyEmails": [
    "admin@musterfirma.de"
  ],
  "webhookUrl": null,
  "hasWebhookAuth": false
}

Statuscodes

200 Aktualisierte Konfiguration

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Request Beispiel

{
  "thresholdDays": [
    30,
    60,
    90
  ],
  "notifyEmails": [
    "admin@musterfirma.de"
  ],
  "webhookUrl": null,
  "webhookAuthHeader": null
}

Response Beispiel

{
  "thresholdDays": [
    30,
    60,
    90
  ],
  "notifyEmails": [
    "admin@musterfirma.de"
  ],
  "webhookUrl": null,
  "hasWebhookAuth": false
}

Benachrichtigungen

Benachrichtigungsläufe anstoßen (E-Mail / Webhook) – für Cron-Jobs

Statuscodes

200 Laufergebnis

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "mandantenProcessed": 5,
  "emailsSent": 3,
  "webhooksFired": 1,
  "errors": []
}

Kunden

Kundenverwaltung (Zuordnung von Inventareinträgen zu Kunden)

Statuscodes

201 Kunde angelegt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "name": "Musterfirma GmbH",
  "street": "Musterstraße 1",
  "postalCode": "12345",
  "city": "Musterstadt",
  "externalReference": "CRM-007",
  "customFields": []
}

Response Beispiel

{
  "id": 7,
  "mandantId": 3,
  "name": "Musterfirma GmbH",
  "street": "Musterstraße 1",
  "postalCode": "12345",
  "city": "Musterstadt",
  "inventoryCount": 42,
  "createdAt": "2024-01-10T10:00:00Z",
  "externalReference": "CRM-007",
  "customFields": {}
}

Statuscodes

200 Aktualisierter Kunde

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "name": "Musterfirma GmbH",
  "street": "Musterstraße 1",
  "postalCode": "12345",
  "city": "Musterstadt",
  "externalReference": "CRM-007",
  "customFields": []
}

Response Beispiel

{
  "id": 7,
  "mandantId": 3,
  "name": "Musterfirma GmbH",
  "street": "Musterstraße 1",
  "postalCode": "12345",
  "city": "Musterstadt",
  "inventoryCount": 42,
  "createdAt": "2024-01-10T10:00:00Z",
  "externalReference": "CRM-007",
  "customFields": {}
}

Produkte

Produktverwaltung (revuwork.suite, ab v0.7.0) — übergeordnete Warengruppen/Kategorien für den Artikelstamm

Statuscodes

201 Produkt angelegt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Request Beispiel

{
  "productNo": "P-100",
  "name": "Schutzausrüstung",
  "description": null,
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "productNo": "P-100",
  "name": "Schutzausrüstung",
  "description": null,
  "isArchived": false,
  "archivedAt": null,
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "customFields": {}
}

Statuscodes

200 Aktualisiertes Produkt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

Request Beispiel

{
  "productNo": "P-100",
  "name": "Schutzausrüstung",
  "description": null,
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "productNo": "P-100",
  "name": "Schutzausrüstung",
  "description": null,
  "isArchived": false,
  "archivedAt": null,
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "customFields": {}
}

Artikel

Artikelverwaltung (revuwork.suite, ab v0.7.0) — konkrete verkaufbare Positionen je Produkt, Grundlage für künftige Auftragspositionen

Statuscodes

201 Artikel angelegt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Referenziertes Produkt nicht gefunden oder gehört zu einem anderen Mandanten

Request Beispiel

{
  "productId": 1,
  "articleNo": "A-100",
  "name": "Erstprüfung ortsveränderliches Gerät",
  "description": null,
  "unit": "Stück",
  "defaultUnitPrice": 49.9,
  "customFields": []
}

Response Beispiel

{
  "id": 10,
  "tenantId": 3,
  "productId": 1,
  "productName": "Ortsveränderliches Gerät",
  "articleNo": "A-100",
  "name": "Erstprüfung ortsveränderliches Gerät",
  "description": null,
  "unit": "Stück",
  "defaultUnitPrice": 49.9,
  "isArchived": false,
  "archivedAt": null,
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "customFields": {}
}

Statuscodes

200 Aktualisierter Artikel

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

Request Beispiel

{
  "productId": 1,
  "articleNo": "A-100",
  "name": "Erstprüfung ortsveränderliches Gerät",
  "description": null,
  "unit": "Stück",
  "defaultUnitPrice": 49.9,
  "customFields": []
}

Response Beispiel

{
  "id": 10,
  "tenantId": 3,
  "productId": 1,
  "productName": "Ortsveränderliches Gerät",
  "articleNo": "A-100",
  "name": "Erstprüfung ortsveränderliches Gerät",
  "description": null,
  "unit": "Stück",
  "defaultUnitPrice": 49.9,
  "isArchived": false,
  "archivedAt": null,
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "customFields": {}
}

Aufträge

Auftragsverwaltung (revuwork.suite, ab v0.8.0) — Status-Workflow Draft → Confirmed → Fulfilled / Cancelled, Positionen wahlweise mit Artikelbezug (Snapshot) oder als Freitext

Statuscodes

201 Auftrag angelegt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Referenzierter Kunde/Kontakt/Artikel nicht gefunden oder gehört zu einem anderen Mandanten

422 Validierungsfehler

Request Beispiel

{
  "customerId": 7,
  "contactId": null,
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "lines": [
    {
      "articleId": 10,
      "description": "Erstprüfung ortsveränderliches Gerät",
      "quantity": 2,
      "unit": "Stück",
      "unitPrice": 49.9
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "orderNo": "A-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "confirmedAt": null,
  "fulfilledAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Auftrag

401 Nicht authentifiziert

404 Fehler

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "orderNo": "A-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "confirmedAt": null,
  "fulfilledAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Aktualisierter Auftrag

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Auftrag ist nicht im Status Draft

422 Validierungsfehler

Request Beispiel

{
  "customerId": 7,
  "contactId": null,
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "lines": [
    {
      "articleId": 10,
      "description": "Erstprüfung ortsveränderliches Gerät",
      "quantity": 2,
      "unit": "Stück",
      "unitPrice": 49.9
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "orderNo": "A-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "confirmedAt": null,
  "fulfilledAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Bestätigter Auftrag

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Auftrag ist nicht im Status Draft

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "orderNo": "A-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "confirmedAt": null,
  "fulfilledAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Erfüllter Auftrag

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Auftrag ist nicht im Status Confirmed

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "orderNo": "A-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "confirmedAt": null,
  "fulfilledAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Stornierter Auftrag

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Auftrag ist bereits Fulfilled oder Cancelled

Request Beispiel

{
  "reason": "Kunde hat storniert"
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "orderNo": "A-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "isTemplate": false,
  "orderDate": "2026-07-26",
  "requestedDeliveryDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-26T10:00:00Z",
  "updatedAt": "2026-07-26T10:00:00Z",
  "confirmedAt": null,
  "fulfilledAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Angebote

Angebotsverwaltung (revuwork.suite, ab v0.13.0) — Status-Workflow Draft → Sent → Accepted / Rejected, Accepted → Converted. Angebote werden per PDF ausgegeben und können per E-Mail versendet sowie bei Annahme in einen Auftrag umgewandelt werden.

Statuscodes

201 Angebot angelegt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Referenzierter Kunde/Kontakt/Artikel nicht gefunden oder gehört zu einem anderen Mandanten

422 Validierungsfehler

Request Beispiel

{
  "customerId": 7,
  "contactId": null,
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "lines": [
    {
      "articleId": 10,
      "description": "Erstprüfung ortsveränderliches Gerät",
      "quantity": 2,
      "unit": "Stück",
      "unitPrice": 49.9
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Angebot

401 Nicht authentifiziert

404 Fehler

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Aktualisiertes Angebot

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Angebot ist nicht im Status Draft

422 Validierungsfehler

Request Beispiel

{
  "customerId": 7,
  "contactId": null,
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "lines": [
    {
      "articleId": 10,
      "description": "Erstprüfung ortsveränderliches Gerät",
      "quantity": 2,
      "unit": "Stück",
      "unitPrice": 49.9
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Versendetes Angebot

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Angebot ist nicht im Status Draft, oder es ist kein Postfach verbunden

Request Beispiel

{
  "toEmail": "kunde@example.com",
  "mailboxConnectionId": null
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Angenommenes Angebot

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Angebot ist nicht im Status Sent

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Abgelehntes Angebot

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Angebot ist nicht im Status Sent

Request Beispiel

{
  "reason": "Kein Bedarf"
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Statuscodes

200 Umgewandeltes Angebot (inkl. convertedToSalesOrderId)

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Angebot ist nicht im Status Accepted

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "quoteNo": "AN-2026-000001",
  "customerId": 7,
  "contactId": null,
  "status": "Draft",
  "quoteDate": "2026-07-27",
  "validUntil": "2026-08-27",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "hasPdf": false,
  "convertedToSalesOrderId": null,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-27T10:00:00Z",
  "updatedAt": "2026-07-27T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "acceptedAt": null,
  "rejectedAt": null,
  "rejectedReason": null,
  "convertedAt": null,
  "lines": [],
  "subtotal": 0,
  "customFields": {}
}

Rechnungen

Rechnungsverwaltung (revuwork.suite, ab Phase 3) — Status-Workflow Draft → Sent → Paid / Overdue / Cancelled. Die Rechnungsnummer wird erst beim Versand vergeben (lückenlose Nummernkreise), Belege sind danach unveränderlich; ein Storno erzeugt eine Gutschrift als eigenen Beleg mit negierten Positionen. Erfordert das Lizenz-Feature `Invoicing`.

Statuscodes

201 Rechnung angelegt

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Referenzierter Kunde/Kontakt/Artikel/Auftrag nicht gefunden oder gehört zu einem anderen Mandanten

409 Der referenzierte Auftrag ist nicht im Status Fulfilled

422 Validierungsfehler

Request Beispiel

{
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "lines": [
    {
      "articleId": 10,
      "description": "Erstprüfung ortsveränderliches Gerät",
      "quantity": 2,
      "unit": "Stück",
      "unitPrice": 49.9
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "invoiceNo": null,
  "type": "Invoice",
  "status": "Draft",
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "sourceInvoiceId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": "2026-08-11",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "subtotal": 99.8,
  "vatAmount": 18.96,
  "grossTotal": 118.76,
  "hasPdf": false,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-28T10:00:00Z",
  "updatedAt": "2026-07-28T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "paidAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "customFields": {}
}

Statuscodes

200 Rechnung

401 Nicht authentifiziert

404 Fehler

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "invoiceNo": null,
  "type": "Invoice",
  "status": "Draft",
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "sourceInvoiceId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": "2026-08-11",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "subtotal": 99.8,
  "vatAmount": 18.96,
  "grossTotal": 118.76,
  "hasPdf": false,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-28T10:00:00Z",
  "updatedAt": "2026-07-28T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "paidAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "customFields": {}
}

Statuscodes

200 Aktualisierte Rechnung

400 Validierungsfehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Rechnung ist nicht im Status Draft

422 Validierungsfehler

Request Beispiel

{
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": null,
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "lines": [
    {
      "articleId": 10,
      "description": "Erstprüfung ortsveränderliches Gerät",
      "quantity": 2,
      "unit": "Stück",
      "unitPrice": 49.9
    }
  ],
  "customFields": []
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "invoiceNo": null,
  "type": "Invoice",
  "status": "Draft",
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "sourceInvoiceId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": "2026-08-11",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "subtotal": 99.8,
  "vatAmount": 18.96,
  "grossTotal": 118.76,
  "hasPdf": false,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-28T10:00:00Z",
  "updatedAt": "2026-07-28T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "paidAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "customFields": {}
}

Statuscodes

200 Versendete Rechnung (inkl. vergebener invoiceNo)

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Rechnung ist nicht im Status Draft, oder es ist kein Postfach verbunden

Request Beispiel

{
  "toEmail": "kunde@example.com",
  "mailboxConnectionId": null
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "invoiceNo": null,
  "type": "Invoice",
  "status": "Draft",
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "sourceInvoiceId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": "2026-08-11",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "subtotal": 99.8,
  "vatAmount": 18.96,
  "grossTotal": 118.76,
  "hasPdf": false,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-28T10:00:00Z",
  "updatedAt": "2026-07-28T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "paidAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "customFields": {}
}

Statuscodes

200 Bezahlte Rechnung

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Rechnung ist nicht im Status Sent oder Overdue

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "invoiceNo": null,
  "type": "Invoice",
  "status": "Draft",
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "sourceInvoiceId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": "2026-08-11",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "subtotal": 99.8,
  "vatAmount": 18.96,
  "grossTotal": 118.76,
  "hasPdf": false,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-28T10:00:00Z",
  "updatedAt": "2026-07-28T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "paidAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "customFields": {}
}

Statuscodes

200 Stornierte Originalrechnung

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Rechnung ist nicht im Status Sent oder Overdue

422 Validierungsfehler

Request Beispiel

{
  "reason": "Falscher Rechnungsempfänger"
}

Response Beispiel

{
  "id": 1,
  "tenantId": 3,
  "invoiceNo": null,
  "type": "Invoice",
  "status": "Draft",
  "customerId": 7,
  "contactId": null,
  "sourceSalesOrderId": null,
  "sourceInvoiceId": null,
  "invoiceDate": "2026-07-28",
  "dueDate": "2026-08-11",
  "title": null,
  "notes": null,
  "currency": "EUR",
  "vatRate": 19,
  "subtotal": 99.8,
  "vatAmount": 18.96,
  "grossTotal": 118.76,
  "hasPdf": false,
  "createdByUserId": "a1b2c3d4",
  "createdAt": "2026-07-28T10:00:00Z",
  "updatedAt": "2026-07-28T10:00:00Z",
  "sentAt": null,
  "sentToEmail": null,
  "paidAt": null,
  "cancelledAt": null,
  "cancelledReason": null,
  "lines": [],
  "customFields": {}
}

Mailbox-Verbindungen

Office365-Postfach-Verbindungen je Mandant (revuwork.suite, ab v0.13.0) — OAuth2 gegen Microsoft Graph (Mail.Send), genutzt zum Versand von Angeboten im Namen des Mandanten

Custom Fields

Benutzerdefinierte Felder (revuwork.suite) — mandantenspezifische Feld-Definitionen für Customer/Contact, verwaltet über die Suite-Administration "Entitäten" (Rolle Admin)

Statuscodes

201 Feld-Definition angelegt

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

409 Schlüssel existiert für diese Entität bereits

422 Validierungsfehler

Request Beispiel

{
  "entityType": "Contact",
  "key": "kundenkategorie",
  "label": "Kundenkategorie",
  "fieldType": "DropdownSingle",
  "options": [
    "Premium",
    "Standard"
  ],
  "isRequired": false,
  "sortOrder": 0
}

Response Beispiel

{
  "id": 3,
  "entityType": "Contact",
  "key": "kundenkategorie",
  "label": "Kundenkategorie",
  "fieldType": "DropdownSingle",
  "options": [
    "Premium",
    "Standard"
  ],
  "referenceEntityType": null,
  "isRequired": false,
  "sortOrder": 0,
  "isArchived": false,
  "hasValues": true,
  "createdAt": "2026-07-25T10:00:00Z",
  "updatedAt": "2026-07-25T10:00:00Z"
}

Statuscodes

200 Aktualisierte Feld-Definition

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

409 Feldtyp ist eingefroren (bereits Werte gespeichert) oder Schlüssel-Konflikt

422 Validierungsfehler

Request Beispiel

{
  "entityType": "Contact",
  "key": "kundenkategorie",
  "label": "Kundenkategorie",
  "fieldType": "DropdownSingle",
  "options": [
    "Premium",
    "Standard"
  ],
  "isRequired": false,
  "sortOrder": 0
}

Response Beispiel

{
  "id": 3,
  "entityType": "Contact",
  "key": "kundenkategorie",
  "label": "Kundenkategorie",
  "fieldType": "DropdownSingle",
  "options": [
    "Premium",
    "Standard"
  ],
  "referenceEntityType": null,
  "isRequired": false,
  "sortOrder": 0,
  "isArchived": false,
  "hasValues": true,
  "createdAt": "2026-07-25T10:00:00Z",
  "updatedAt": "2026-07-25T10:00:00Z"
}

Statuscodes

204 Reihenfolge gespeichert

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

Request Beispiel

{
  "entityType": "Contact",
  "entries": [
    {
      "id": 3,
      "sortOrder": 0
    },
    {
      "id": 5,
      "sortOrder": 1
    }
  ]
}

PDF Templates

Mandantenspezifisch anpassbare PDF-Layouts für Prüfberichte, Angebote und Inventarlisten (ab v0.60.0). Ist ein Layout als Standard markiert, nutzen PdfReportService/SalesQuotePdfService/ InventoryExportService es automatisch (ab v0.62.0, siehe Issue #169) — ohne Standard-Layout bleibt das bisherige interne Layout als Fallback erhalten. Rolle Admin/SuperAdmin.

Lizenz

Lizenzstatus des eigenen Mandanten (Rolle Admin)

Statuscodes

200 Lizenzstatus

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "status": "Active",
  "isInGrace": false,
  "graceDaysRemaining": null,
  "validFrom": "2024-01-01",
  "validUntil": "2024-12-31",
  "graceDays": 14,
  "notes": null,
  "isTrial": false,
  "templateName": "Pro",
  "price": 299,
  "inventoryItemOveragePrice": 0.03,
  "inspectionReportOveragePrice": 0.2,
  "userOveragePrice": 3.5,
  "addinOveragePrice": 40,
  "apiRequestOveragePrice": 0.0015,
  "features": {
    "mxpExport": true,
    "pdfExport": true,
    "inspections": true,
    "import": true,
    "externalIntegration": false,
    "addins": []
  },
  "limits": {
    "maxInventoryItems": 500,
    "currentInventoryItems": 320,
    "inventoryItemsWarning": false,
    "maxUsers": 10,
    "currentUsers": 7,
    "usersWarning": false,
    "maxInspectionReports": 125000,
    "currentInspectionReports": 4200,
    "inspectionReportsWarning": false,
    "maxAddins": 1,
    "currentAddins": 0,
    "addinsWarning": false,
    "maxApiRequestsPerMonth": 5000,
    "currentApiRequests": 120,
    "apiRequestsWarning": false
  }
}

Statuscodes

204 Budget gespeichert

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

422 Validierungsfehler (z.B. negativer Betrag oder nicht budgetierbare Kontingent-Art)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "maxOverageQuantity": 10000,
  "stopUsageWhenReached": true,
  "alertsEnabled": true
}

Audit

Audit-Log für Änderungen (Rolle Admin/SuperAdmin)

Statuscodes

200 Paginiertes Audit-Log

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "items": [],
  "totalCount": 320,
  "page": 1,
  "pageSize": 25,
  "totalPages": 13
}

Admin – Webhooks

Webhook-Konfiguration (Rolle Admin)

Statuscodes

200 Webhook gespeichert

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "url": "https://example.com/webhook",
  "headers": [
    {
      "key": "Authorization",
      "value": "Bearer mytoken"
    }
  ]
}

Response Beispiel

{
  "eventType": "inspection.completed",
  "url": "https://example.com/webhook",
  "headers": [],
  "hasAuthHeader": false
}

Statuscodes

200 Testergebnis

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}

Admin – Navigation & Rollen

Rollenzuordnung pro Admin-Navigationseintrag der Administration-Übersichtsseite (ab v0.69.1, Issue #81) — pro Mandant zur Laufzeit editierbar. Lesen für alle authentifizierten Nutzer (gefiltert auf die eigene Rolle), Schreiben nur Rolle SuperAdmin.

Support

Support-Tickets und Nachrichten

Statuscodes

200 Paginierte Ticket-Liste

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "Bug",
      "status": "Open",
      "title": "Fehler beim Excel-Export",
      "createdByName": "Max Mustermann",
      "createdAt": "2024-03-15T10:00:00Z",
      "updatedAt": "2024-03-15T10:00:00Z",
      "messageCount": 2
    }
  ],
  "totalCount": 1,
  "page": 1,
  "pageSize": 25,
  "totalPages": 1
}

Statuscodes

201 Ticket erstellt

400 Validierungsfehler

401 Nicht authentifiziert

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "type": "Bug",
  "title": "Fehler beim Excel-Export",
  "description": "Beim Export der Inventarliste wird ein leeres Dokument erzeugt.",
  "errorLocation": "Inventar → Export → XLSX",
  "expectedBehavior": "Eine Excel-Datei mit allen Inventareinträgen sollte heruntergeladen werden."
}

Response Beispiel

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "Bug",
  "status": "Open",
  "title": "Fehler beim Excel-Export",
  "errorLocation": "Inventar → Export → XLSX",
  "description": "Beim Export wird ein leeres Dokument erzeugt.",
  "expectedBehavior": "Eine Excel-Datei mit allen Inventareinträgen.",
  "createdByName": "Max Mustermann",
  "createdByUserId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "createdAt": "2024-03-15T10:00:00Z",
  "messages": []
}

Statuscodes

200 Ticket-Details inkl. Nachrichten

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Response Beispiel

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "Bug",
  "status": "Open",
  "title": "Fehler beim Excel-Export",
  "errorLocation": "Inventar → Export → XLSX",
  "description": "Beim Export wird ein leeres Dokument erzeugt.",
  "expectedBehavior": "Eine Excel-Datei mit allen Inventareinträgen.",
  "createdByName": "Max Mustermann",
  "createdByUserId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "createdAt": "2024-03-15T10:00:00Z",
  "messages": []
}

Statuscodes

200 Aktualisiertes Ticket

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "status": "Closed"
}

Response Beispiel

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "Bug",
  "status": "Open",
  "title": "Fehler beim Excel-Export",
  "errorLocation": "Inventar → Export → XLSX",
  "description": "Beim Export wird ein leeres Dokument erzeugt.",
  "expectedBehavior": "Eine Excel-Datei mit allen Inventareinträgen.",
  "createdByName": "Max Mustermann",
  "createdByUserId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "createdAt": "2024-03-15T10:00:00Z",
  "messages": []
}

Statuscodes

200 Hinzugefügte Nachricht

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

429 Rate Limit überschritten – zu viele Anfragen von dieser IP

Request Beispiel

{
  "body": "Ich habe das Problem reproduziert und sende weitere Details."
}

Response Beispiel

{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "authorName": "Max Mustermann",
  "authorRole": "Admin",
  "authorUserId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "body": "Ich habe das Problem reproduziert und sende weitere Details.",
  "createdAt": "2024-03-15T11:00:00Z",
  "attachments": []
}

Statuscodes

200 Anhang hochgeladen

400 Fehler

401 Nicht authentifiziert

403 Keine Berechtigung (falsche Rolle)

404 Fehler

Response Beispiel

{
  "fileName": "screenshot.png",
  "mimeType": "image/png",
  "sizeBytes": 45210
}

Tour

Geführte Onboarding-Touren für Benutzer

Statuscodes

200 Tour-Daten

204 Tour abgeschlossen oder nicht vorhanden

401 Nicht authentifiziert

Response Beispiel

{
  "tourId": 1,
  "steps": [
    {
      "id": 10,
      "nextStepId": 11,
      "title": "Willkommen",
      "body": "Hier finden Sie Ihr Inventar."
    },
    {
      "id": 11,
      "nextStepId": null,
      "title": "Filter nutzen",
      "body": "Filtern Sie nach Gebäude oder Kategorie."
    }
  ],
  "lastStepId": null
}

Spalten-Ansichten

Gespeicherte, benannte Spaltenlayouts je Grid (ab v0.80.0, Issue #265) — beliebig viele Ansichten pro (Benutzer, Mandant, Grid), genau eine davon ist die feste Standard-Ansicht, die beim Öffnen des Grids geladen wird

Statuscodes

201 Ansicht angelegt

401 Nicht authentifiziert

409 Es existiert bereits eine Ansicht mit diesem Namen für dieses Grid

422 Geschäftsregel-Fehler oder semantisch ungültige Anfrage

Request Beispiel

{
  "gridKey": "inventory",
  "viewName": "Wartung",
  "columns": [
    {
      "columnKey": "inventarnummer",
      "isVisible": true,
      "sortOrder": 0
    }
  ]
}

Response Beispiel

{
  "id": 12,
  "gridKey": "inventory",
  "viewName": "Standard",
  "columns": [
    {
      "columnKey": "inventarnummer",
      "isVisible": true,
      "sortOrder": 0
    }
  ],
  "isDefault": true
}

Statuscodes

200 Ansicht aktualisiert

401 Nicht authentifiziert

404 Ansicht existiert nicht oder gehört nicht zum aktuellen Benutzer/Mandanten

409 Es existiert bereits eine andere Ansicht mit diesem Namen für dieses Grid

Response Beispiel

{
  "id": 12,
  "gridKey": "inventory",
  "viewName": "Standard",
  "columns": [
    {
      "columnKey": "inventarnummer",
      "isVisible": true,
      "sortOrder": 0
    }
  ],
  "isDefault": true
}

Statuscodes

200 Ansicht ist jetzt Standard

401 Nicht authentifiziert

404 Ansicht existiert nicht oder gehört nicht zum aktuellen Benutzer/Mandanten

Response Beispiel

{
  "id": 12,
  "gridKey": "inventory",
  "viewName": "Standard",
  "columns": [
    {
      "columnKey": "inventarnummer",
      "isVisible": true,
      "sortOrder": 0
    }
  ],
  "isDefault": true
}