> ## 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 exivo mit anny verbinden

> Vergib bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu deinen exivo-Schlössern.

[dormakaba exivo](https://www.dormakaba.com/de-de/exivo) ist ein cloudbasiertes Zutrittskontrollsystem für kleine und mittlere Objekte. Mit der Integration kann anny bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu exivo-Komponenten vergeben.

Mit dormakaba exivo kannst du in anny:

* Buchungsbasierte Zugänge mit Vorlauf- und Nachlaufzeit automatisch erstellen
* Community-Mitgliedern dauerhafte Zugänge zu bestimmten Schlössern zuweisen
* Zugangsstatus und Pin-Codes direkt in der Buchungsdetailansicht einsehen

Besonders praktisch ist die Integration, wenn du Räume oder Coworking-Flächen mit dormakaba exivo absicherst und den Zugang vollständig automatisieren möchtest.

<Info>
  Verfügbar ab Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall                           | Beschreibung                                                                                                                                                                                  |
| :--------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Coworking-Räume automatisch freischalten | **Kund:innen erhalten nach der Buchung automatisch einen zeitlich begrenzten Zugangslink plus Pin.** Du musst keine Schlüssel mehr übergeben oder manuell Zugänge anlegen.                    |
| Community-Zugang für Mitglieder          | **Mitglieder einer Community erhalten dauerhaften Zugang zu definierten Schlössern.** So steuerst du Berechtigungen zentral über anny, ohne jeden Zugang einzeln im Schließsystem zu pflegen. |
| Gebäudezugang bei Tagestickets           | **Tagesgäste bekommen nur für die gebuchte Dauer Zutritt.** Der Zugang wird nach Ablauf automatisch entfernt, ohne dass du eingreifen musst.                                                  |

## Wie die Exivo-Verbindung funktioniert

Die Integration nutzt die dormakaba exivo REST-API. Du authentifizierst dich mit der **ID der Anlage**, einem **API Schlüssel** und einem **API Geheimnis**, die du in deiner exivo-App findest. Damit autorisierst du anny, Zugänge (Zutrittsrechte mit Zeitfenster und Pin) für die Komponenten deiner Anlage zu erstellen und zu entfernen. Den Pin erzeugt anny dabei automatisch.

Wenn die Zugangsdaten in der exivo-App widerrufen oder neu erzeugt werden, verliert anny den Zugriff. Du musst die Integration in anny dann mit den neuen Zugangsdaten erneut authentifizieren.

| Daten                         | Richtung     | Häufigkeit                       |
| ----------------------------- | ------------ | -------------------------------- |
| Zugänge (erstellen/entfernen) | anny → exivo | Echtzeit bei Buchung/Stornierung |
| Komponenten (Liste)           | exivo → anny | Bei Regelkonfiguration           |

## dormakaba Exivo verbinden

### Voraussetzungen

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

* Einen aktiven dormakaba exivo Account mit Adminrechten
* Deine Zugangsdaten aus der exivo-App: **ID der Anlage**, **API Schlüssel** und **API Geheimnis**
* Mindestens eine Komponente, die im dormakaba Adminbereich eingerichtet und online ist
* anny Professional-Plan oder höher

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **exivo**. Trage die **ID der Anlage**, den **API Schlüssel** und das **API Geheimnis** aus deiner exivo-App ein. Klicke auf **Authentifizierung überprüfen**.
  </Step>

  <Step title="Konfigurieren">
    Erstelle Regeln für buchungsbasierte (**Zugang durch Buchungen**) oder Community-basierte Zugänge (**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 **Komponenten auswählen** eine oder mehrere Komponenten aus
    4. Lege bei Buchungszugängen **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (jeweils in Minuten)
    5. Aktiviere optional **Zugang über Keypad verwenden**, wenn Kund:innen den Pin direkt an der Tastatur des Schlosses eingeben sollen
  </Step>
</Steps>

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.
</Tip>

### 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                                                                                      |
| Zugang über Keypad verwenden | Ist der Schalter aus, bekommen Kund:innen einen Link plus Pin per E-Mail. Ist er an, bekommen sie nur einen Pin für die Tastatur am Schloss |
| Komponenten                  | Eine oder mehrere exivo-Komponenten pro Regel                                                                                               |

## Buchungsprozess für Kund:innen

So erleben deine Kund:innen die Integration:

<Steps>
  <Step title="Raum buchen">
    Kund:innen buchen eine Ressource über anny.
  </Step>

  <Step title="Zugangslink erhalten">
    anny generiert automatisch einen individuellen Zugangslink plus Pin und versendet beides in der Buchungsbestätigung per E-Mail.
  </Step>

  <Step title="Schloss öffnen">
    Kund:innen öffnen den **Link aus der E-Mail**, geben den **Pin** ein und klicken auf **Login**. Dort werden die Zugänge angezeigt, die zur gebuchten Ressource gehören. Ist für die Regel **Zugang über Keypad verwenden** aktiv, geben Kund:innen den Pin stattdessen direkt an der Tastatur des Schlosses ein.
  </Step>
</Steps>

## Zugänge im Adminbereich einsehen

In der **Buchungsdetailansicht** werden aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details einzusehen:

| Status         | Bedeutung                                                                                                          |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| 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 das Schloss im definierten Zeitraum bedienen                            |
| Geplant        | Der Zugang ist vorgemerkt und wird kurz vor dem Termin erstellt. Das betrifft Serien- und wiederkehrende Buchungen |
| Fehlgeschlagen | Der Zugang konnte nicht erstellt werden. anny benachrichtigt die hinterlegten Admins                               |
| Entfernt       | Der Zugang wurde vom System oder einem Admin entfernt                                                              |

<Tip>
  Über die **drei Punkte** in der Zugangsdetailansicht kannst du den Zugang über **Zugang beim Anbieter anzeigen** im exivo-Besucherportal öffnen, die **Integrationseinstellungen** aufrufen oder mit **Zugänge neu erstellen** einen fehlgeschlagenen Zugang erneut anlegen.
</Tip>

## Einschränkungen

Die dormakaba exivo-Integration unterstützt nicht:

* Remote Open (Türöffnung per Knopfdruck aus anny heraus): Kund:innen nutzen stattdessen den Zugangslink plus Pin oder den Tastatur-Pin am Schloss
* Mehrere Anlagen pro Integration: Pro Integration kann nur eine exivo-Anlage verbunden werden
* Automatische Erneuerung der Zugangsdaten: Bei neuen Zugangsdaten 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.
</Warning>

Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Welche Hardware ist mit exivo kompatibel?">
    Alle Informationen zur unterstützten Hardware findest du auf der [dormakaba exivo Webseite](https://www.dormakaba.com/de-de/exivo). anny kommuniziert über die exivo Cloud-API, die Hardware-Kompatibilität wird von dormakaba bestimmt.
  </Accordion>

  <Accordion title="Können Kund:innen mehrere Komponenten mit einer Buchung öffnen?">
    Ja. Du kannst pro Regel mehrere Komponenten zuweisen. Alle zugewiesenen Komponenten erscheinen nach dem Login auf der Zugangsseite.
  </Accordion>

  <Accordion title="Bekommen meine Kund:innen einen Link oder einen Pin für die Tastatur?">
    Das steuerst du pro Regel über **Zugang über Keypad verwenden**. Ist der Schalter aus, bekommen deine Kund:innen einen Zugangslink plus Pin per E-Mail. Ist er an, bekommen sie nur einen Pin, den sie direkt an der Tastatur des Schlosses eingeben. Den Pin erzeugt anny in beiden Fällen automatisch.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Bei Stornierung der Buchung wird der Zugang automatisch entfernt. Der Status wechselt auf "Entfernt" und Kund:innen können das Schloss nicht mehr bedienen.
  </Accordion>

  <Accordion title="Kann ich unterschiedliche Zugangszeiten pro Ressource setzen?">
    Die Zeiten **Zugang vor der Buchung** und **Zugang nach der Buchung** gelten pro Regel. Pro Ressource ist nur eine Regel möglich. Brauchst du für dieselben Komponenten unterschiedliche Zeiten, verknüpfe sie über getrennte Ressourcen mit eigenen Regeln.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Zugang bleibt im Status 'In Bearbeitung'">
    Die Komponente ist möglicherweise offline oder nicht erreichbar. Prüfe im dormakaba Adminbereich, ob die Komponente online ist und eine aktive Verbindung zur exivo Cloud hat.
  </Accordion>

  <Accordion title="Authentifizierung schlägt fehl">
    Die Zugangsdaten sind ungültig oder abgelaufen. Prüfe **ID der Anlage**, **API Schlüssel** und **API Geheimnis** in deiner exivo-App und trage sie erneut in anny ein.
  </Accordion>

  <Accordion title="Komponenten erscheinen nicht in der Auswahl">
    Stelle sicher, dass die Komponenten im dormakaba Adminbereich der korrekten Anlage zugeordnet und eingerichtet sind. Nur Komponenten der authentifizierten Anlage werden in anny angezeigt. Drahtlose Gateways erscheinen bewusst nicht in der Auswahl.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Menüleiste → Integrationen → exivo. Authentifizierungsfelder (offizielle Labels): **ID der Anlage**, **API Schlüssel**, **API Geheimnis**; Button **Authentifizierung überprüfen**. Die Zugangsdaten stammen aus der exivo-App (dormakaba nennt in der Doku auch das Portal customer.exivo.io). Plan-Gating: Feature INTEGRATIONS\_SMART\_LOCKS, laut Doku ab Professional (Plan-Stufe nicht aus dem Code verifizierbar). Env-Flag: EXIVO\_ACTIVE.
>
> Regeltypen: **Zugang durch Buchungen** (mit Ressource, Komponenten, **Zugang vor der Buchung**, **Zugang nach der Buchung**, **Zugang über Keypad verwenden**) und **Zugang durch Communities** (mit Community, Komponenten, Keypad-Schalter; keine Vor-/Nachlaufzeit). Regel-Tabellenspalten u. a.: Ressource, Komponenten, Zugang vor/nach der Buchung, **Verwendet Tastatur-Pin**. Die Schloss-Auswahl heißt bei exivo **Komponenten** / **Komponenten auswählen** (nicht „Schlösser", nicht „Zylinder"). Gateways (wireless-gateway) werden aus der Auswahl gefiltert.
>
> Zugangsformat: Keypad aus → Link + Pin per E-Mail (Kund:in wird als Besucher:in mit E-Mail angelegt); Keypad an → nur Pin für die Tastatur. Pin wird von anny automatisch generiert (4- bis 6-stellig), nicht konfigurierbar.
>
> Timing: Einzelbuchungen erhalten den Zugang sofort. Serien-/wiederkehrende Buchungen werden vorgemerkt (Status **Geplant**) und \~48 h vor dem Termin erstellt. Nur bestätigte Buchungen; angefragte/abgelehnte/stornierte Buchungen und interne Blocker erhalten keinen Zugang. Eine Regel pro Ressource (Speichern einer zweiten Regel für dieselbe Ressource wird blockiert). Regeln wirken auch für Unterressourcen. Community-Zugänge ohne Enddatum erhalten intern ein \~3-Jahres-Fenster.
>
> Statuswerte für exivo: In Bearbeitung, Erfolgreich, Geplant, Fehlgeschlagen, Nicht autorisiert, Entfernt. „Unbestätigt" und „Aufräumen" werden bei exivo nicht verwendet (exivo setzt Erfolg synchron, kein zweistufiger Verify-Schritt; abgelaufene Zugänge räumt exivo selbst ab). Zugangsdetail-Aktionen: **Zugang beim Anbieter anzeigen** (öffnet customer.exivo.io/visitors), **Integrationseinstellungen**, **Zugangs-URL kopieren**, **Zugänge neu erstellen**. Kein Remote Open (im Regel-Editor erscheint für exivo kein Fernöffnung-Schalter).
>
> Abgrenzung: exivo ist eine von drei dormakaba-Integrationen mit eigenem Integration-Key (`exivo`). Nicht verwechseln mit exos-9300 (`kabaExos9300`, „Profile", optionale Mobilnummer/SMS) und resivo (`resivo`, „Sites"/Autorisierungen, Tastatur-Pin). Alle drei teilen sich den Zugangskontroll-Unterbau in anny, unterscheiden sich aber in Authentifizierung und Zustellung.
>
> Verbindung trennen: Menüleiste → Integrationen → exivo → Toggle (deaktivieren, bestehende Zugänge bleiben) oder drei Punkte → Löschen (setzt in anny alles zurück).
