Dokumentation | API-Referenz

Überblick

Das Modul "Vermieterinventar" ermöglicht Immobilieneigentümern die Erfassung von Inventar (Möbel, Technik usw.), das dem Mieter zusammen mit den Räumlichkeiten zur Nutzung übergeben wird. Jedes Objekt kann Übersetzungen für mehrsprachige Unterstützung und angehängte Dokumente zur Zustandsdokumentation haben.

Inventarerfassung

Erfassung von Inventar mit Name, Datum, Beschreibung und Schätzwert.

Mehrsprachigkeit

Hinzufügen von Übersetzungen der Inventarnamen in verschiedenen Sprachen.

Dokumente und Fotos

Anhängen von Fotos und Dokumenten zur Dokumentation des Inventarzustands.

Wertschätzung

Angabe des Schätzwerts in verschiedenen Währungen für Versicherungszwecke.

Arbeitsprozess

Typischer Prozess zur Dokumentation des Vermieterinventars:

1

Inventar erfassen

Eigentümer erfasst Inventar mit Name, Datum und Beschreibung.

2

Wert angeben

Optional Schätzwert und Währung für Versicherung angeben.

3

Fotos hinzufügen

Fotos zur Dokumentation des Inventarzustands mit Kommentaren hochladen.

4

Übersetzungen hinzufügen

Übersetzungen des Inventarnamens für mehrsprachige Dokumentation hinzufügen.

Zugriffsrechte

Zugriffsrechte für Vermieterinventar:

Aktion	Wer kann
Erstellen	Eigentümer und ihre Vertreter
Anzeigen	Eigentümer, Mieter und ihre Vertreter
Bearbeiten	Eigentümer und ihre Vertreter
Löschen	Eigentümer und ihre Vertreter
Dokumente anhängen	Eigentümer und ihre Vertreter
Übersetzungen verwalten	Eigentümer und ihre Vertreter

REST API

Zugriff auf Inventar über REST API (JWT-Authentifizierung erforderlich):

Service-Layer-Hinweis

Inventar

GET    /api/v1/properties/{id}/tenant-assets            - Inventarliste
POST   /api/v1/properties/{id}/tenant-assets            - Erstellen
GET    /api/v1/properties/{id}/tenant-assets/{aid}      - Details
PUT    /api/v1/properties/{id}/tenant-assets/{aid}      - Aktualisieren
DELETE /api/v1/properties/{id}/tenant-assets/{aid}      - Löschen

Dokumente

POST   /api/v1/properties/{id}/tenant-assets/{aid}/documents      - Dokument anhängen
DELETE /api/v1/properties/{id}/tenant-assets/{aid}/documents/{did} - Dokument entfernen

Übersetzungen

GET    /api/v1/properties/{id}/tenant-assets/{aid}/translations       - Übersetzungsliste
POST   /api/v1/properties/{id}/tenant-assets/{aid}/translations       - Übersetzung hinzufügen
PUT    /api/v1/properties/{id}/tenant-assets/{aid}/translations/{tid} - Übersetzung aktualisieren
DELETE /api/v1/properties/{id}/tenant-assets/{aid}/translations/{tid} - Übersetzung löschen

Beispielantwort

{
  "data": [
    {
      "id": 1,
      "property_id": 5,
      "name": "Samsung TV 55\"",
      "description": "Smart TV with mounting bracket",
      "asset_date": "2025-03-15",
      "estimated_value": 15000.00,
      "currency": {
        "id": 1,
        "code": "UAH",
        "symbol": "₴"
      },
      "created_by": {
        "id": 8,
        "name": "Owner Name"
      },
      "documents_count": 3,
      "translations_count": 2,
      "created_at": "2025-03-15T10:30:00+00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "totalPages": 1
}

Swagger / OpenAPI

Vollständige API-Dokumentation ist in Swagger verfügbar /api/v1/doc