Docs — revuwork

August 2026

inventory v0.84.5 August 2026 Breaking

API: Format für benutzerdefinierte Felder geändert

Betrifft alle API-Antworten mit benutzerdefinierten Feldern (Betriebsmittel, Prüfberichte, Kunden, Kontakte, Artikel, Produkte, Angebote, Aufträge, Rechnungen).

customFields ist in GET-Antworten nicht mehr eine Liste von Objekten, sondern ein einfaches Schlüssel-Wert-Objekt (Schlüssel = Feldname, Wert = der eigentliche Feldwert). Felder ohne Wert sind mit null statt fehlendem Schlüssel enthalten.
Betroffen ist nur das Lesen; das Speichern von Feldwerten ist unverändert.
Zusätzlich liefert POST /inventory/{id}/unarchive jetzt keinen Datensatz mehr zurück (nur noch Erfolg/Fehler), analog zu den bereits bestehenden Sammel-Endpunkten für Archivieren/Entarchivieren.

Bitte prüfen Sie eigene Integrationen, die diese Endpunkte verwenden.

inventory v0.84.3 August 2026 Fixes

API: Kleinere Fehler bei Betriebsmitteln behoben

Das Archivieren/Entarchivieren von Betriebsmitteln über einen API-Key wurde fälschlich mit “403 Forbidden” abgelehnt — behoben.
Der Inventory-Endpunkt lieferte in Einzelfällen nicht alle Felder eines Betriebsmittels zurück (u. a. Prüfungsanzahl und benutzerdefinierte Felder nach dem Entarchivieren) — behoben.

inventory v0.84.0 August 2026 Features

Benutzerdefinierte Felder für Betriebsmittel und Prüfberichte

Sie können jetzt eigene Felder für Betriebsmittel und Prüfberichte anlegen — Text, Zahl, Datum, Checkbox, E-Mail, URL oder Dropdown. Neuer Bereich Entitätsfelder in der Administration.
Die Felder erscheinen automatisch im Bearbeiten-Formular und auf der Detailseite.
Sie lassen sich jetzt auch als zusätzliche Spalte in der Inventarliste einblenden und danach filtern.
Auch der JSON-Import für Betriebsmittel unterstützt jetzt Werte für diese Felder.

inventory v0.82.7 August 2026 Fixes

Kleinere Fehler bei den gespeicherten Ansichten behoben

Ein Wechsel der Ansicht zeigte im Inventar-/Prüfberichte-Grid manchmal keine sichtbare Änderung.
Im Kunden-Grid überschrieb das Anpassen der Spalten ungefragt die zuletzt aktive Ansicht, statt nur die aktuelle Anzeige zu ändern.

inventory v0.82.5 August 2026 Fixes

Startprobleme bei neu eingerichteten Konten behoben

Bei einigen frisch eingerichteten Konten blieb die Administrationsseite ohne erkennbaren Grund leer.
Die Einrichtung neuer Konten läuft jetzt zuverlässig durch; tritt trotzdem ein Ladefehler auf, wird das jetzt klar angezeigt statt einer stillen, leeren Seite.

inventory v0.80.0 August 2026 Features

Mehrere gespeicherte Ansichten für Ihre Tabellen

Sie können jetzt beliebig viele benannte Ansichten Ihrer Spalteneinstellungen speichern und jederzeit wechseln — bisher gab es pro Tabelle nur eine einzige Einstellung.
Neuer Ansichten-Umschalter: Ansicht wählen, aktuelle Ansicht aktualisieren, unter neuem Namen speichern, umbenennen, löschen oder als Standard festlegen.
Verfügbar für Inventar, Prüfberichte und Kunden.

suite v0.80.0 August 2026 Features

Mehrere gespeicherte Ansichten für Ihre Tabellen

Sie können jetzt beliebig viele benannte Ansichten Ihrer Spalteneinstellungen speichern und jederzeit wechseln.
Neu verfügbar für Kunden, Aufträge, Angebote, Rechnungen, Artikel und Mailbox-Verbindungen — dort gab es bisher noch gar keine Spaltenkonfiguration.

inventory v0.78.13 August 2026 Fixes

API: Nutzungszählung korrigiert, Rate-Limit deutlich angehoben

API-Zugriffe über einen API-Key wurden bei manchen Mandanten nicht in der monatlichen Nutzungsstatistik gezählt — behoben.
Das allgemeine Rate-Limit wurde von 60 auf 250 Anfragen pro Minute angehoben.

inventory v0.78.10 August 2026 Features

Lizenz-Budgets jetzt auch für Prüfberichte und API-Zugriffe

Zusätzliche Budgets über das lizenzierte Kontingent hinaus lassen sich jetzt auch für Prüfberichte und API-Zugriffe festlegen (bisher nur für Betriebsmittel und Benutzer).
Die Eingabe erfolgt jetzt als Menge statt als Euro-Betrag; der resultierende Preis wird direkt im Bearbeiten-Dialog angezeigt.
Wichtig: Die Sperre bei Erreichen des Budgets ist jetzt standardmäßig aktiv (vorher standardmäßig aus).

inventory v0.78.4 August 2026 Fixes

Lizenzseite: mehrere Anzeigefehler behoben

Eine Lizenzänderung mit demselben Startdatum wie die bisherige wurde nicht wirksam.
Die Nutzungsanzeige auf der Lizenzseite blieb in manchen Fällen leer.
Die angezeigte Nutzung konnte in Einzelfällen dem falschen Mandanten zugeordnet sein.

inventory v0.76.4 August 2026 Features

Dashboard: neue Auswertungen und bessere Übersicht

Neues Diagramm “Fehlerquote” im Dashboard, jetzt zusätzlich nach Projekt und/oder Kunde filterbar.
Kunde und Projekt werden jetzt überall gemeinsam angezeigt: in den Dashboard-Widgets, in Prüfberichten und in der Inventar-Kartenansicht.

inventory v0.76.0 August 2026 Features

Kleinere Verbesserungen

Doppelklick auf einen Eintrag in der Kundenliste öffnet jetzt direkt die zugehörige Inventarliste.
Die Nutzungsbalken auf der Lizenzseite sind jetzt farbig (grün/gelb/rot je nach Auslastung).

inventory v0.70.0 August 2026 Features

MXP-Export im echten MEBEDO-ElektroManager-Format

Der “Als MXP exportieren”-Export erzeugt jetzt Dateien im echten MEBEDO-ElektroManager-Format und lässt sich direkt in die MEBEDO-Software re-importieren.
Im Anschluss wurden mehrere Nachbesserungen vorgenommen, damit der Re-Import zuverlässig funktioniert (u. a. bei Herstellern, Normen, Geräte-Arten und Personaldaten).
Hinweis: einzelne Sichtprüfungs-Ergebnisse und Messwerte werden in dieser Version noch nicht aus revuwork übernommen.

suite v0.67.1 August 2026 Features

Neues Dashboard für revuwork.suite

Die Startseite zeigt jetzt ein echtes, individuell anpassbares Dashboard statt der bisherigen Platzhalterseite.
Erste Widgets: offene Aufträge und offene Rechnungen, jeweils mit direktem Link zur jeweiligen Liste.
Optional dazu buchbar: ein Widget mit dem aktuellen Lizenz-Status.

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
}