> ## 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. # Nuki mit anny verbinden > Automatisiere den schlüssellosen Zugang zu deinen Räumen über Nuki Smart Locks und anny Buchungen. [Nuki](https://nuki.io/de/) ist ein Smart-Lock-System, das auf bestehende Türschlösser montiert wird und schlüssellosen Zugang per App oder Keypad-PIN ermöglicht. Mit der Integration erstellt anny automatisch Zugangscodes für deine Kund:innen, sobald eine Buchung bestätigt wird. Mit Nuki kannst du in anny: * Zugangscodes automatisch bei Buchungsbestätigung erstellen und nach Ablauf entfernen * Kund:innen per Keypad-PIN oder Nuki-App Zutritt gewähren * Türen per Remote Open direkt aus der anny Buchungsansicht oder Homepage öffnen Die Integration passt, wenn du Räume oder Flächen vermietest und deinen Kund:innen automatisierten, schlüssellosen Zugang ohne manuelle Schlüsselübergabe bieten möchtest. Verfügbar ab dem Professional-Plan. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :-------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | | Meetingräume im Coworking-Space | **Automatischer Zugang nur im gebuchten Zeitfenster.** Kund:innen erhalten den PIN per Mail und betreten den Raum ohne Rezeption. | | Ferienwohnungen und Apartments | **Schlüssellose Übergabe ohne persönlichen Kontakt.** Gäste erhalten vor Check-in ihren Zugangscode und können eigenständig einchecken. | | Gemeinschaftsräume mit Community-Zugang | **Dauerhafte Zugangsrechte für Mitglieder.** Community-Mitglieder erhalten permanenten Zugang zu definierten Schlössern. | | Universitätsräume und Labore | **Zeitlich begrenzter Zugang für gebuchte Slots.** Studierende erhalten Zugang nur für den reservierten Zeitraum. | ## Wie die Nuki-Verbindung funktioniert Du autorisierst anny in deinem Nuki-Account, und anny erhält Zugriff auf deine registrierten Smart Locks. anny erstellt und entfernt Zugangscodes automatisch basierend auf deinen konfigurierten Regeln. Wenn du die Autorisierung im Nuki-Account widerrufst oder die Verbindung abläuft, verliert anny den Zugriff und kann keine neuen Zugänge erstellen. Du musst die Verbindung in diesem Fall neu autorisieren. Einzelbuchungen erhalten ihren Zugangscode sofort bei der Bestätigung. Bei Serienbuchungen erstellt anny den Zugang erst kurz vor dem jeweiligen Termin (etwa 48 Stunden vorher). Bis dahin steht der Zugang auf **Geplant**. | Daten | Richtung | Häufigkeit | | ---------------------------------- | ----------- | ---------------------------------- | | Zugangscodes (Erstellen/Entfernen) | anny → Nuki | Bei Buchungserstellung und -ablauf | | Keypad-PIN-Codes | anny → Nuki | Bei Buchungserstellung | ## Nuki verbinden ### Voraussetzungen Bevor du Nuki verbindest, stelle sicher, dass du Folgendes hast: * Ein Nuki Smart Lock mit WiFi-Funktion (Smart Lock 3.0 Pro oder Smart Lock + Bridge) * Optional: ein [Nuki Keypad](https://nuki.io/de/keypad/) für den Zugang per PIN-Code * Einen Nuki-Account mit Zugangsdaten Für anny-Buchungen ist ein Nuki-Schloss mit WiFi (Fernzugriff) zwingend erforderlich. Ohne WiFi kann anny keine Zugänge erstellen. ### Verbindung einrichten Öffne aus der Menüleiste die **Integrationen** und gehe zu **Nuki**. Autorisiere Nuki, indem du dich mit deinen Zugangsdaten von Nuki anmeldest. Du gibst anny damit die Berechtigung, Zugänge auf deinen Smart Locks zu verwalten. Nach erfolgreicher Autorisierung richtest du Zugangsregeln ein. Du hast zwei Möglichkeiten: **Zugang durch Buchungen:** 1. Klicke auf **Hinzufügen** im Bereich "Zugang durch Buchungen". 2. Wähle die **Ressource** aus, deren Buchung Zugang zum Schloss gewähren soll. 3. Wähle unter **Zylinder auswählen** ein oder mehrere Schlösser aus, zu denen Zugang gewährt wird. 4. Lege über **Zugang vor der Buchung** und **Zugang nach der Buchung** fest, wie viele Minuten der Zugang vor und nach der Buchung aktiv ist. 5. Falls ein Nuki Keypad vorhanden ist, aktiviere **Zugang über Keypad verwenden**. Kund:innen erhalten dann einen PIN-Code per Mail. Ohne diese Option lädst du Kund:innen als Nuki-App-Nutzer:innen per E-Mail ein. **Zugang durch Communities:** 1. Klicke auf **Hinzufügen** im Bereich "Zugang durch Communities". 2. Wähle die **Community** aus, deren Mitglieder dauerhaften Zugang erhalten sollen. 3. Wähle unter **Zylinder auswählen** ein oder mehrere Schlösser aus, zu denen Zugang gewährt wird. Sobald Regeln konfiguriert sind, erstellt anny automatisch Zugänge bei neuen Buchungen. Pro Ressource ist eine Buchungsregel möglich, du kannst darin aber mehrere Schlösser hinterlegen. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen. Die Nutzung des Keypads ist empfohlen: Kund:innen benötigen keine App-Installation und erhalten den PIN direkt in der Buchungsbestätigung. ## Einstellungen & Optionen ### Remote Open Mit der Remote-Open-Funktion können Kund:innen Türen direkt über die anny Homepage oder Buchungsansicht per Knopfdruck öffnen, ohne PIN oder App. Aktiviere dazu in der jeweiligen Regel den Schalter **Fernöffnung verwenden**: in einer Buchungsregel für den Zugang über die Buchungsansicht, in einer Community-Regel für den Zugang über die Homepage. In der Regel-Tabelle erscheint die Spalte **Fernöffnung**. Kund:innen sehen den Button **Tür entriegeln** in ihrer Buchungsansicht und im Bereich **Schlüsselloser Zugang** ihres anny-Kontos. Er ist nur während des gültigen Zugangszeitraums aktiv. Als Admin kannst du in der Buchungsübersicht über **Schloss entsperren** öffnen. Für Remote Open muss die Integration neu autorisiert werden, falls sie vor der Aktivierung dieser Funktion eingerichtet wurde. ### Zugänge im Admin-Bereich einsehen In der Buchungsdetailansicht findest du unter **Smartlock Zugänge** die aktiven und inaktiven Zugänge. Pro Zugang siehst du: * Status * **Zugang beginnt am** und **Zugang endet am** * **Türschloss** * **Erstellt am** * Zugang (z. B. PIN-Code) | Status | Bedeutung | | -------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Geplant | Die Erstellung ist geplant. Der Zugang wird kurz vor dem Termin erstellt (etwa 48 Stunden vorher, vor allem bei Serienbuchungen). | | In Bearbeitung | Die Einrichtung des Zugangs läuft gerade. | | Unbestätigt | Der Zugang wurde angefragt und wird in Kürze bestätigt. Ein Keypad-PIN ist bereits nutzbar. | | Erfolgreich | Der Zugang ist aktiv. Kund:innen können das Schloss im angezeigten Zeitraum bedienen. | | Fehlgeschlagen | Das Erstellen des Zugangs ist fehlgeschlagen. | | Entfernt | Der Zugang wurde vom System oder Admin entfernt. Kein Zugriff mehr. | ## Einschränkungen Die Nuki-Integration unterstützt nicht: * Mehr als 200 gleichzeitig offene/zukünftige Zugänge pro Schloss. Wenn das Limit erreicht ist, kann anny keine neuen Zugänge erstellen. * Mehrere gespeicherte Zugriffszeiträume pro Nutzer:in in der Nuki-App. Bei aufeinanderfolgenden Buchungen muss das alte Schloss zunächst aus der App entfernt werden. * Synchronisation im Batteriesparmodus. Wenn das Nuki-Schloss in den Energiesparmodus wechselt, trennt es die WiFi-Verbindung. Nuki eignet sich am besten für kleinere Unternehmen mit moderatem Buchungsvolumen (unter 200 gleichzeitig aktive Zugänge). Bei höherem Volumen prüfe alternative Smart-Lock-Integrationen. ## Verbindung trennen 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 unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**. ## FAQ Du benötigst ein Nuki Smart Lock mit WiFi-Funktion: entweder das Nuki Smart Lock 3.0 Pro (mit integriertem WiFi) oder ein älteres Smart Lock mit separater Nuki Bridge. Ohne WiFi ist keine Fernsteuerung über anny möglich. Ja. Bei Einzelbuchungen erstellt anny den Zugang sofort nach der Bestätigung. Bei Serienbuchungen entsteht er erst kurz vor dem jeweiligen Termin und steht bis dahin auf **Geplant**. Bei aktiviertem Keypad erhalten Kund:innen den PIN-Code per E-Mail in der Buchungsbestätigung. Ohne Keypad bekommen sie eine Einladung als Nuki-App-Nutzer:in. Ja. Pro Zugangsregel kannst du ein oder mehrere Schlösser auswählen, die bei Buchung der Ressource freigeschaltet werden. anny entfernt den Zugang automatisch nach Ablauf des konfigurierten Zeitfensters (Buchungszeit plus Puffer). Kund:innen haben danach keinen Zugriff mehr. ## Troubleshooting Prüfe, ob die Nuki-Integration in den Integrationen als aktiv angezeigt wird und ob das Smart Lock online ist. Falls das Schloss im Batteriesparmodus ist, trennt es die WiFi-Verbindung und anny kann keinen Zugang erstellen. Stelle sicher, dass das Schloss ausreichend Strom hat oder deaktiviere den Energiesparmodus. Dies kann passieren, wenn der Refresh-Token abgelaufen ist. Öffne Nuki in den **Integrationen**, lösche die Verbindung über die drei Punkte oben rechts und autorisiere erneut mit deinen Nuki-Zugangsdaten. Nuki erlaubt maximal 200 gleichzeitig aktive/zukünftige Zugänge pro Schloss. Prüfe im Nuki-Admin, ob alte Zugänge noch aktiv sind, und entferne nicht mehr benötigte Einträge manuell. Alternativ warte, bis abgelaufene Zugänge automatisch entfernt werden. > Wichtige Informationen für Agenten: > > **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Nuki** → Autorisieren (OAuth-Redirect zu Nuki Web). Regeln: gleicher Ort, Panels **Zugang durch Buchungen** und **Zugang durch Communities** → **Hinzufügen**. Buchungsregel-Felder: **Ressource**, **Zylinder auswählen** (Schloss-Auswahl; für Nuki heißt das Label „Zylinder", nicht „Schlösser"), **Zugang vor der Buchung**, **Zugang nach der Buchung**, Schalter **Zugang über Keypad verwenden**, Schalter **Fernöffnung verwenden**. Regel-Tabellen-Spalten: Ressource, Zylinder, Zugang vor/nach der Buchung, **Verwendet Tastatur-Pin**, **Fernöffnung**. Deaktivieren: **Toggle** oben rechts; Löschen: **drei Punkte** → **Löschen**. > > **Authentifizierung:** OAuth (Nuki Web API), Scopes account/smartlock.readOnly/smartlock.auth/smartlock.action. Refresh-Token kann ablaufen → Re-Autorisierung nötig. Reine Passwortänderung widerruft die Autorisierung nicht zwingend. > > **Zugangsarten:** Pro Regel entweder Keypad-PIN (Keypad-Schalter an) ODER Nuki-App-Einladung per E-Mail (Keypad-Schalter aus), diese schließen sich aus. **Remote Open** ist zusätzlich und unabhängig (eigener Grant-Typ). Keypad-PIN: 6 Ziffern, nur 1–9 (keine 0), beginnt nie mit „12", pro Konto eindeutig. > > **Timing/Status:** Einzelbuchungen → Zugang sofort bei Bestätigung. Serien-/wiederkehrende Buchungen → Status **Geplant**, Erstellung ca. 48 h vor Termin. Nach Anlage Status **Unbestätigt**, nach ca. 2 Min Prüfung → **Erfolgreich**/**Fehlgeschlagen**. Weitere Status: In Bearbeitung, Aufräumen, Entfernt, Nicht autorisiert. Zugang läuft am Buchungsende + „Zugang nach der Buchung" ab (Nuki-seitig erzwungen); anny räumt den Eintrag etwa einen Tag später auf. > > **Quirks:** (1) Nur bestätigte/angenommene Buchungen; angefragte, abgelehnte, stornierte Buchungen und interne Blocker erhalten keinen Zugang. Blocker→Buchung erstellt Zugang, Buchung→Blocker entfernt ihn. (2) Statuswechsel weg von „angenommen" entfernt den Zugang; Zeitänderung aktualisiert das Fenster; Ressourcenwechsel erstellt neu. (3) Eine Buchungsregel pro Ressource (Duplikat wird beim Speichern blockiert), mehrere Schlösser pro Regel erlaubt. (4) Regel auf Oberressource greift auch für Unterressourcen. (5) Community-Zugang ist dauerhaft (kein Enddatum). (6) Keypad-Regel: Aktivierung schlägt fehl, wenn ein gewähltes Schloss kein gekoppeltes Keypad hat oder ein referenziertes Schloss fehlt; Integration bleibt inaktiv. (7) Remote Open braucht neue Scopes → Re-Autorisierung; Schalter „Fernöffnung verwenden" erscheint erst danach. > > **Remote-Open-Button:** Kund:innen „**Tür entriegeln**" in Buchungsansicht + Bereich „Schlüsselloser Zugang" (Homepage/Konto, Browser), nur im gültigen Zeitfenster. Admin „**Schloss entsperren**" in der Buchungsübersicht. > > **Nuki-Plattform (nicht aus anny-Code, vor Nutzung verifizieren):** 200 gleichzeitige Zugänge pro Schloss, WiFi-Pflicht (Bridge oder Pro), Batteriesparmodus trennt WiFi, nur ein Zugriffszeitraum pro Nutzer:in pro Schloss in der Nuki-App (Keypad-PIN betroffen nicht). > > **Beziehungen:** Feature INTEGRATIONS\_SMART\_LOCKS, Plan-Stufe („ab Professional") DB-seitig, nicht code-verifiziert. Verwandte Artikel: Smart-Lock-Integrationen (Übersicht), KleverKey, Salto KS, Tapkey, Dormakaba Resivo.