Docs — revuwork

Mai 2026

inventory v0.1.1 Mai 2026 Neu

Neu

Mehrere Mandanten in einer Installation nutzbar
Protokollierung aller Datenänderungen (Audit-Trail)
JSON-Import-Schnittstelle

Fehlerbehebungen

Datumsformat-Fehler beim Excel-Import behoben
Sortierung in der Inventarliste korrigiert

inventory v0.1.0 Mai 2026 Erstveröffentlichung

Willkommen bei revuwork

Inventarverwaltung mit Volltextsuche
Prüffristen und Fälligkeitsübersicht
Datenimport aus bestehenden Excel-Listen
Benutzerverwaltung mit Rollensystem

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
}