Casavi

Mit der Casavi-Integration können Sie Liegenschaften, Einheiten und Kontakte aus Casavi in deep.rent nutzen und fertige Protokoll-PDFs direkt an Casavi zurückspielen.

Voraussetzungen

• Ein aktives deep.rent-Konto
• Ein aktiver Casavi-Zugang
• API-Schlüssel und API-Secret vom Casavi-Connectivity-Team
• Internetverbindung während der Ersteinrichtung und Synchronisation

Funktion der Schnittstelle

• Die Schnittstelle ermöglicht die sichere Anbindung von Casavi an die Protocol-App zur Nutzung vorhandener Stammdaten.
• Liegenschaften, Einheiten und Kontakte werden beim Synchronisieren importiert und unter Objekten zur Auswahl bereitgestellt.
• Einheiten sind ihrer übergeordneten Liegenschaft zugeordnet (Hierarchie über parentObjectId).
• Beziehungen zwischen Objekten und Kontakten (z. B. Eigentümer, Mieter) werden erkannt und zugeordnet.
• Protokolle werden als PDF aus der Protocol-App an die betreffende Liegenschaft oder Einheit in Casavi hochgeladen (asynchron über jobId).
• Importierte Daten:
  • Objektdaten (Adresse, Typ, Hierarchie)
  • Kontaktdaten (Name, E-Mail, Telefon)
  • Kontaktverknüpfungen über Verantwortlichkeiten und Verträge

Technische Hinweise

• API-Schlüssel und Secret werden ausschließlich serverseitig verarbeitet und verschlüsselt gespeichert. Sie werden nicht im Frontend angezeigt.
• Alle Zugriffe auf Casavi erfolgen über gesicherte Backend-Endpunkte. Direkte Client-zu-Casavi-Kommunikation findet nicht statt.
• Die Integration nutzt minimal erforderliche Berechtigungen (Least-Privilege):
  • Lesen von Kontakten, Liegenschaften und Einheiten
  • Schreiben (Upload) von Dokumenten
  • Kein Löschen oder Verändern bestehender Daten in Casavi
• Sensible Daten werden nicht in Logs ausgegeben und nicht in Klartext gespeichert.
• Zugriffe sind organisationsgebunden und durch Authentifizierung sowie Rollenprüfungen (Admin/Owner für Zugangsdaten) abgesichert.
• Alle Verbindungen erfolgen verschlüsselt über HTTPS.

Einrichtung in Casavi

1. Wenden Sie sich an das Casavi-Connectivity-Team, um API-Schlüssel und Secret für die Anbindung zu erhalten.
2. Dokumentation der Manager-API: api.mycasavi.com/v1/docs/manager

Einrichtung in der Protocol App

1. Öffnen Sie Einstellungen → Integrationen.
2. Wählen Sie Casavi.
3. Hinterlegen Sie API-Schlüssel und API-Secret.
4. Bestätigen Sie die Verbindung.
5. Starten Sie Mit Casavi synchronisieren, damit die Daten verfügbar sind.

Nach der Verbindung

• Aktualisierte Stammdaten aus Casavi werden über den Sync in die Protocol App übernommen.
• Wählen Sie importierte Liegenschaften oder Einheiten unter Objekte und erstellen Sie Protokolle.
• Fertige Protokoll-PDFs werden nach Abschluss automatisch an Casavi hochgeladen (sofern das Objekt verknüpft ist).

Fehlerbehebung

• Verbindung fehlgeschlagen: API-Schlüssel und Secret prüfen und Verbindung erneut herstellen.
• Keine Daten sichtbar: Manuelle Synchronisation ausführen und prüfen, ob Liegenschaften und Einheiten in Casavi vorhanden sind.
• Unvollständige Kontakte: In Casavi prüfen, ob Verantwortlichkeiten und aktive Verträge gepflegt sind.
• PDF-Upload: Upload ist asynchron; ein jobId in der Antwort bedeutet, dass Casavi die Verarbeitung übernimmt.