> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# dormakaba resivo mit anny verbinden

> Vergib bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu deinen resivo-Türen.

[dormakaba Resivo](https://resivo.dormakaba.com/) ist ein cloudbasiertes Zutrittskontrollsystem, das speziell für die Verwaltung von Liegenschaften und Mietobjekten konzipiert ist. Mit der Integration kann anny bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu Resivo-Schlössern vergeben.

Mit dormakaba Resivo kannst du in anny:

* Buchungsbasierte Zugänge mit Vorlauf- und Nachlaufzeit automatisch erstellen
* Community-Mitgliedern dauerhafte Zugänge zu bestimmten Türen zuweisen
* Zugangsstatus und Zugangsdaten direkt in der Buchungsdetailansicht einsehen

Besonders praktisch ist die Integration, wenn du Liegenschaften oder Gemeinschaftsräume mit dormakaba Resivo absicherst und den Zugang für Buchungen oder Mieter:innen automatisieren möchtest.

> [!NOTE]
>
> Verfügbar ab Professional-Plan.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Gemeinschaftsräume in Liegenschaften | **Mieter:innen erhalten nach der Buchung automatisch einen zeitlich begrenzten Zugang per Pincode oder resivo-App.** Die Hausverwaltung muss keine Schlüssel oder Karten ausgeben. |
| Community-Zugang für Mietparteien | **Mitglieder einer Community erhalten dauerhaften Zugang zu definierten Türen.** So steuerst du Berechtigungen zentral über anny, z. B. für Waschküchen, Fitnessräume oder Paketboxen. |
| Gebäudezugang für externe Dienstleister | **Externe erhalten nur für die gebuchte Dauer Zutritt.** Der Zugang wird nach Ablauf automatisch entfernt, ohne dass die Hausverwaltung eingreifen muss. |

## Wie die Resivo-Verbindung funktioniert

Die Integration nutzt die dormakaba resivo API. Du authentifizierst dich mit der **ID des Eigentümers der Liegenschaft**, einer **Client ID** und einem **Client Geheimnis**, die du in den resivo-API-Einstellungen generierst. Damit autorisierst du anny, Zugänge (Zutrittsrechte mit Zeitfenster) für die Türen deiner Liegenschaft zu erstellen und zu entfernen. Je nach **Zugangsart** ist das ein Pincode für ein Keypad, eine Einladung in die resivo-App oder der persönliche Badge der buchenden Person. Zusätzlich kannst du **Fernöffnung** aktivieren.

Wenn die Zugangsdaten in den resivo-API-Einstellungen widerrufen oder neue Credentials generiert werden, verliert anny den Zugriff. Du musst die Integration in anny dann mit den neuen Credentials erneut authentifizieren.

> [!WARNING]
>
> Das **Client Geheimnis** ist nur einmalig bei Erstellung sichtbar. Speichere es sofort sicher ab.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugänge (erstellen/entfernen) | anny → resivo | Echtzeit bei Buchung, Serien rund 48 Stunden vorab |
| Türen (Liste) | resivo → anny | Bei Regelkonfiguration |

## dormakaba Resivo verbinden

### Voraussetzungen

Bevor du dormakaba Resivo verbindest, stelle sicher, dass du Folgendes hast:

* Einen aktiven dormakaba resivo Account mit Eigentümer-Rechten
* API-Credentials aus den resivo-API-Einstellungen (ID des Eigentümers der Liegenschaft, Client ID, Client Geheimnis)
* Mindestens eine Tür, die im resivo-Adminbereich eingerichtet und online ist
* anny Professional-Plan oder höher

### Verbindung einrichten

**1. Autorisieren**

Öffne in der Seitenleiste **Account** → **Apps & Integrationen**, wähle unter **Alle Apps und Integrationen** die Kachel **Resivo** und klicke auf **Einrichten**. Füge die **ID des Eigentümers der Liegenschaft**, die **Client ID** und das **Client Geheimnis** aus den resivo-API-Einstellungen ein. Klicke auf **Authentifizierung überprüfen**.

**2. Liegenschaft wählen**

Wähle unter **Aktive Liegenschaft** die Liegenschaft aus, die du über anny steuern möchtest, und klicke auf **Liegenschaft speichern**. Erst danach erscheinen die Regel-Bereiche. Über **Liegenschaft zurücksetzen** kannst du die Auswahl später ändern, wobei alle bestehenden Regeln entfernt werden.

**3. Konfigurieren**

Erstelle Regeln unter **Zugang durch Buchungen** oder **Zugang durch Communities**:

1. Klicke auf **Hinzufügen**, um eine neue Regel zu erstellen
2. Wähle eine **Ressource** (für Buchungszugänge) oder eine **Community** (für Mitgliederzugänge)
3. Wähle unter **Türen auswählen** eine oder mehrere Türen aus
4. Lege bei Buchungszugängen **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (in Minuten)
5. Wähle die **Zugangsart**: **E-Mail-Link** (Einladung in die resivo-App), **PIN-Code** oder **Persönlicher Badge**. Bei **Persönlicher Badge** legst du zusätzlich eine **Fallback-Zugangsart** fest (PIN-Code oder E-Mail-Link), falls die Person im Schließsystem nicht eindeutig zugeordnet werden kann
6. Aktiviere bei Bedarf **Fernöffnung verwenden**, damit Kund:innen das Schloss per Knopfdruck aus anny öffnen können

Sobald die Verbindung aktiv ist, werden Zugänge automatisch bei neuen Buchungen erstellt und bei Stornierungen entfernt.

> [!TIP]
>
> Bestehende Regeln kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen.

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten, die der Zugang vor Buchungsbeginn aktiv ist |
| Zugang nach der Buchung | Minuten, die der Zugang nach Buchungsende aktiv bleibt |
| Zugangsart | **E-Mail-Link** (Standard): Einladung in die resivo-App. **PIN-Code**: anny erzeugt automatisch einen 6-stelligen Pincode. **Persönlicher Badge**: Kund:innen nutzen ihren hinterlegten Badge an der Tür |
| Fallback-Zugangsart | Nur bei **Persönlicher Badge**. PIN-Code oder E-Mail-Link, wenn die buchende Person im Schließsystem nicht eindeutig zugeordnet werden kann |
| Fernöffnung verwenden | Aktiv: Kund:innen öffnen das Schloss per Knopfdruck aus ihrem anny-Konto. Unabhängig von der Zugangsart, Standard aus |
| Türen | Eine oder mehrere resivo-Türen pro Regel |

## Buchungsprozess für Kund:innen

So erleben deine Kund:innen die Integration:

**1. Raum buchen**

Kund:innen buchen eine Ressource über anny.

**2. Zugang erhalten**

anny erstellt automatisch den Zugang und teilt ihn in der Buchungsbestätigung per E-Mail mit. Je nach Regel ist das ein **Pincode**, eine **Einladung in die resivo-App**, der Hinweis auf den **persönlichen Badge** oder zusätzlich ein Button zur **Fernöffnung**.

**3. Tür öffnen**

Im Bereich **Schlüsselloser Zugang** sehen Kund:innen ihre Zugänge für die gebuchte Ressource. Sie geben den **Pincode** am Keypad ein, öffnen die Tür über die **resivo-App**, nutzen den **persönlichen Badge** oder drücken bei aktiver Fernöffnung den Öffnen-Button in anny.

## Zugänge im Adminbereich einsehen

In der **Buchungsdetailansicht** werden im Abschnitt **Verbundene Daten** unter **Smartlock Zugänge** aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details einzusehen:

| Status | Bedeutung |
| - | - |
| Geplant | Der Zugang für eine Serien- oder Zukunftsbuchung wird erst rund 48 Stunden vor Beginn erstellt |
| In Bearbeitung | Der Zugang wurde von anny angefordert, aber noch nicht vom Schließsystem vergeben |
| Erfolgreich | Der Zugang ist aktiv und Kund:innen können die Tür im definierten Zeitraum bedienen |
| Fehlgeschlagen | Der Zugang konnte nicht erstellt werden, etwa weil die Tür nicht erreichbar war |
| Entfernt | Der Zugang wurde vom System oder einem Admin entfernt |

> [!TIP]
>
> Über die **drei Punkte** in der Zugangsdetailansicht kannst du den Zugang direkt im resivo-Adminbereich öffnen oder zu den Integrationseinstellungen in anny navigieren.

## Einschränkungen

Die dormakaba resivo-Integration unterstützt nicht:

* Mehrere Liegenschaften pro Integration: Pro Integration kann nur eine Liegenschaft verbunden werden
* Automatische Credential-Rotation: Bei neuen API-Credentials muss die Integration manuell neu authentifiziert werden

## Verbindung trennen

> [!WARNING]
>
> Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.

Beides findest du in der Integration unter **Account** → **Apps & Integrationen** → **Deine Apps**: Deaktivieren über den **Toggle** im Seitenkopf, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

> **Welche Hardware ist mit Resivo kompatibel?**
>
> Alle Informationen zur unterstützten Hardware findest du auf der [dormakaba Resivo Webseite](https://resivo.dormakaba.com/). anny kommuniziert über die Resivo Cloud-API, die Hardware-Kompatibilität wird von dormakaba bestimmt.

> **Können Kund:innen mehrere Türen mit einer Buchung öffnen?**
>
> Ja. Du kannst pro Regel mehrere Türen zuweisen. Alle zugewiesenen Türen erscheinen im Bereich **Schlüsselloser Zugang**.

> **Was passiert bei einer Stornierung?**
>
> Bei Stornierung der Buchung wird der Zugang automatisch entfernt. Der Status wechselt auf "Entfernt" und Kund:innen können die Tür nicht mehr bedienen.

> **Erhalten meine Kund:innen den Zugang sofort?**
>
> Bei Einzelbuchungen wird der Zugang sofort erstellt. Bei Serien- und weit im Voraus gebuchten Terminen erstellt anny den Zugang erst rund 48 Stunden vor Beginn. Bis dahin steht er auf "Geplant", und Pincode, App-Einladung, Badge-Zugang oder Fernöffnung folgen kurz vor dem Termin.

> **Mein Client Geheimnis ist verloren gegangen. Was tun?**
>
> Das Client Geheimnis ist nur einmalig sichtbar. Generiere in den resivo-API-Einstellungen neue Credentials und authentifiziere die Integration in anny erneut.

## Troubleshooting

> **Zugang bleibt in Bearbeitung oder wird 'Fehlgeschlagen'**
>
> Die Tür ist möglicherweise offline oder nicht erreichbar. Prüfe im resivo-Adminbereich, ob die Tür online ist und eine aktive Verbindung zur resivo-Cloud hat.

> **Authentifizierung schlägt fehl**
>
> Die API-Credentials sind ungültig oder das Client Geheimnis wurde falsch kopiert. Generiere in den resivo-API-Einstellungen neue Credentials und trage sie erneut in anny ein. Achte darauf, das Client Geheimnis sofort nach Erstellung zu sichern.

> **Türen erscheinen nicht in der Auswahl**
>
> Stelle sicher, dass die Türen im resivo-Adminbereich der korrekten Liegenschaft zugeordnet und eingerichtet sind. Nur Türen, die der authentifizierten Liegenschaft gehören, werden in anny angezeigt.

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Seitenleiste Account → Apps & Integrationen (`/apps`) → neu: „Alle Apps und Integrationen" → Resivo → „Einrichten"; bestehend: „Deine Apps" → Resivo; Toggle, Aktionsmenü (drei Punkte) und „Speichern" im Seitenkopf der Detailseite. Feature-Gating: INTEGRATIONS\_SMART\_LOCKS (laut Doku ab Professional-Plan, DB-seitig, nicht aus Code verifizierbar).
>
> Auth: ID des Eigentümers der Liegenschaft + Client ID + Client Geheimnis (aus den resivo-API-Einstellungen; Maschinen-Token gegen api.resivo.io; Client Geheimnis nur einmalig sichtbar). NICHT customer.exivo.io, das ist die Exivo-Integration. Button: „Authentifizierung überprüfen". Zugangsdaten nur bei deaktivierter Integration änderbar; schlägt die Prüfung fehl, werden die eingegebenen Secrets verworfen.
>
> Pflicht-Setup nach Auth: „Aktive Liegenschaft" wählen und speichern („Liegenschaft speichern"). Erst danach erscheinen die Regel-Bereiche. „Liegenschaft zurücksetzen" entfernt alle Regeln.
>
> Zwei Regel-Typen: „Zugang durch Buchungen" (Ressource) und „Zugang durch Communities" (Community). Feld „Türen auswählen" (Konzept „Türen", nicht Schlösser/Zylinder), mehrere Türen pro Regel. Nur „Zugang vor der Buchung"/„Zugang nach der Buchung" bei Buchungsregeln (Minuten). Community-Zugänge dauerhaft (kein Enddatum). Eine Regel pro Ressource (Doppelbelegung wird beim Speichern blockiert). Regel auf Oberressource greift auch für Unterressourcen.
>
> Zugangsart pro Regel über Dropdown **Zugangsart** (`access_mode`, Default `remote` = **E-Mail-Link** / resivo-App). Weitere Werte: `pin` = **PIN-Code** (6-stellig), `badge` = **Persönlicher Badge**. Bei Badge erscheint **Fallback-Zugangsart** (`fallback_mode`, PIN oder E-Mail-Link). Tabellenspalte **Zugangsart**. Legacy-Regeln ohne `access_mode` nutzen weiter `use_keypad`. Toggle **Fernöffnung verwenden** (`remote_open`, Default aus, unabhängig von der Zugangsart; Spalte **Fernöffnung**). Shop-Button Badge: **Nutze deinen persönlichen Badge an der Tür**. Admin-Grant: **Persönlicher Badge von {name}**. Kundenbereich: **Schlüsselloser Zugang**.
>
> Timing: Einzelbuchungen sofort; Serien-/Zukunftsbuchungen rund 48 h vor Beginn (Status „Geplant", Kund:innen-Hinweis „Zugang geplant, Erstellung nach {Zeitpunkt}"). Statuslabels: Geplant, In Bearbeitung, Erfolgreich, Fehlgeschlagen, Entfernt. Nur bestätigte Buchungen; Blocker, angefragte, abgelehnte und stornierte Buchungen erhalten keinen Zugang. Stornierung widerruft den Zugang bei resivo.
>
> Verbindung trennen: Account → Apps & Integrationen → Deine Apps → Resivo → Toggle im Seitenkopf (deaktivieren, behält bestehende Zugänge) oder drei Punkte → Löschen. Achtung: Beim Löschen entfernt anny nur die eigenen Zugangs-Datensätze und ruft resivo NICHT zum Widerruf auf; bereits erstellte Pins/App-Zugänge können bis zu ihrem Enddatum aktiv bleiben.
>
> Abgrenzung: Resivo, Exos 9300 und Exivo teilen denselben anny-Zutritts-Unterbau (Regel-Typen, Status, 48-h-Planung, eine Regel pro Ressource). Resivo-spezifisch: Auth mit ID des Eigentümers/Client ID/Client Geheimnis, Pflicht-Liegenschaftswahl, „Türen", Keypad-Pin vs. resivo-App, Deeplink portal.resivo.io. Exivo nutzt customer.exivo.io; Exos 9300 hat eine Handynummer-Pflicht pro Regel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.