> ## 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. # SALTO KS mit anny verbinden > Automatisiere zeitlich begrenzte Zutritte per SALTO-KS-App, PIN-Code oder Remote Open für Buchungen und Communities. [SALTO KS](https://saltosystems.com/de-de/technologieplattformen/salto-ks/) ist ein cloudbasiertes Zutrittssystem für elektronische Türschlösser. Mit der Integration erstellt anny automatisch passende Zutrittsrechte für Buchungen und Community-Mitglieder. Mit SALTO KS kannst du in anny: * Zutritte automatisch anhand von Buchungen erstellen * Community-Mitgliedern Zugang zu ausgewählten Schlössern geben * zeitlich begrenzte Zugänge per SALTO-KS-App, PIN-Code oder Remote Open bereitstellen Besonders praktisch ist die Integration für Räume, Arbeitsplätze und Coworking-Flächen, die ohne manuelle Schlüsselübergabe genutzt werden sollen. > [!NOTE] > > Verfügbar ab dem **Professional-Plan**. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | :- | :- | | Räume nach Buchung öffnen | **Kund:innen erhalten automatisch zeitlich begrenzten Zutritt.** anny verknüpft die gebuchte Ressource mit den ausgewählten SALTO-KS-Schlössern. | | Zutritt für Community-Mitglieder | **Mitglieder erhalten Zugang unabhängig von einzelnen Buchungen.** Du ordnest einer Community ein oder mehrere Schlösser zu. | | Zugang ohne App ermöglichen | **Ein PIN-Code ersetzt die Anmeldung in der SALTO-KS-App.** Voraussetzung ist ein kompatibles Schloss mit Keypad. | ## Wie die SALTO-KS-Verbindung funktioniert Du autorisierst anny mit einem SALTO-KS-Admin-Account. Danach kann anny die verfügbaren Schlösser laden und zeitlich begrenzte Zutrittsrechte anhand deiner Regeln erstellen. Bei einer Buchungsregel verknüpfst du eine anny Ressource mit einem oder mehreren Schlössern. anny erstellt den Zugang für das festgelegte Zeitfenster vor, während und nach der Buchung. Wird eine Buchung storniert, entzieht anny auch das zugehörige Zutrittsrecht. Bei Einzelbuchungen legt anny den Zugang sofort an. Bei Serienbuchungen bereitet anny jeden Zugang erst kurz vor dem Termin vor. Bis dahin trägt das Zutrittsrecht den Status **Geplant**. Bei einer Community-Regel erhalten die Mitglieder der ausgewählten Community Zugang zu den zugeordneten Schlössern. Wenn die Autorisierung widerrufen wird oder nicht mehr gültig ist, kann anny keine neuen Zutrittsrechte erstellen. Autorisiere die Integration dann erneut. | Daten | Richtung | Häufigkeit | | - | - | - | | Schlösser | SALTO KS → anny | Beim Laden und Aktualisieren der Integration | | Buchungsbasierte Zutrittsrechte | anny → SALTO KS | Automatisch anhand der Buchung und Zutrittsregel | | Community-basierte Zutrittsrechte | anny → SALTO KS | Automatisch anhand der Community-Regel | | Status eines Zutrittsrechts | SALTO KS → anny | Nach Erstellung oder Änderung des Zutrittsrechts | ## SALTO KS verbinden ### Voraussetzungen Bevor du SALTO KS verbindest, stelle sicher, dass du Folgendes hast: * einen eingerichteten SALTO-KS-Admin-Account * mindestens ein in SALTO KS eingerichtetes und getestetes Schloss * den **Professional-Plan** oder höher in anny * eine eingerichtete Ressource oder Community, die du mit einem Schloss verknüpfen möchtest ### Verbindung einrichten **1. Autorisieren** Öffne in der Seitenleiste **Account** → **Apps & Integrationen**, wähle unter **Alle Apps und Integrationen** die Kachel **SALTO KS** und klicke auf **Einrichten**. Klicke dann auf **Autorisieren** und melde dich mit deinem SALTO-KS-Admin-Account an. Die Ansicht zeigt, wo du die SALTO-KS-Integration öffnest und die Autorisierung startest: ![SALTO KS in den Integrationen öffnen und autorisieren](https://downloads.intercomcdn.eu/i/o/5781272/b5c7d0477181a1036f5a1fd6/Frame+3.png?expires=1785256200\&signature=8e01c8a85e1c95076dbcfd529a355b2aa8bb3237348907d2a34ca8e3c54114d7\&req=1dJnxFr9rnsp0xr0v9tnrl6Rm7yqGXy6kO7CgXIgWKHlA7bI9Vs2%2FElHBknX%0A9mc8UyZBWkJcKTQ%3D%0A) **2. Anlage wählen** Wähle nach der Autorisierung die **Anlage** aus, mit der die Integration arbeiten soll. Sie bestimmt, welche Schlösser in anny verfügbar sind. Du kannst nur eine Anlage je Integration nutzen. Wenn du die Anlage später wechselst, entfernt anny alle bestehenden Regeln. Verbundene IQs und die OTP-Einrichtung gehören zur alten Anlage. Behandle den Wechsel wie eine komplette Neueinrichtung. **3. Konfigurieren** Lege anschließend die Regeln für deine Zutritte fest: 1. Klicke bei Buchungen oder Communities auf **Hinzufügen**. 2. Wähle die Ressource oder Community aus. 3. Ordne ein oder mehrere SALTO-KS-Schlösser zu. 4. Lege bei Buchungsregeln **Zugang vor der Buchung** und **Zugang nach der Buchung** fest. 5. Aktiviere bei einem kompatiblen Keypad bei Bedarf **Zugang über Keypad verwenden** für den PIN-Zutritt. 6. Aktiviere bei Bedarf **Fernöffnung verwenden**, damit Kund:innen das Schloss direkt aus anny öffnen können. Der Schalter erscheint erst, wenn unter **Remote-Open** mindestens ein IQ bereit ist. Regeln, die Fernöffnung bereits nutzen, behalten den Schalter. 7. Ist Fernöffnung aktiv, kannst du zusätzlich **Zusätzlich App-Zugang senden** einschalten. Dann erhalten Kund:innen neben der Fernöffnung den normalen Zugang über die SALTO-KS-App. Diese Ansicht zeigt die Regel für buchungsbasierte Zutritte: ![Buchungsregel für SALTO KS konfigurieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295080/861d6475dbb035954bbb6011accd/Frame-2B10-284-29.png?expires=1785256200\&signature=9d3e53330fee37698e1548b3e2b463308cf61b031228c6c9811b1c3168ed718b\&req=09FtzF36pDdk2hL085ZhoSrCd2IgowwhFs%2BJzxoBbn0Y%2BfXATb9JnDgDcwoN%0ASyHfIMYPukzZgVBb%0A) Die Detailansicht zeigt die Auswahl von Ressource, Schloss und Zutrittszeitraum: ![Details einer buchungsbasierten SALTO-KS-Regel](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295079/5745074df0e7eaf17bb8d01073b8/Frame%2B10%2B-%2B2025-01-16T172911_733.png?expires=1785256200\&signature=d7a9a2466a7da4120babbbc3ff5f706abbea132021c7daf86881216ec5108e46\&req=09FtzF36qz5k2hL085ZhoUAx0nV2KGgDajiF7GT0qKU74aAstvkXUT%2BAeBdK%0Ap2qIrunVOousrlL9%0A) Diese Ansicht zeigt die Zuordnung einer Community zu SALTO-KS-Schlössern: ![Community-Regel für SALTO KS konfigurieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295082/4bcdf032d888818c6c2e3adcd924/Frame-2B10-285-29.png?expires=1785256200\&signature=19dac4e6ade33f515a7e7be85b8e19402267db4bccbe4bc8ec2dbe6d09244c64\&req=09FtzF36pDVk2hL085ZhoVOb4wp0lEFD%2BLFbRxyJKBk%2FA0kNnVe945xTTdnk%0A%2BzQnERO4I62YFfaU%0A) Sobald die Verbindung aktiv ist, erstellt anny Zutrittsrechte automatisch nach deinen Regeln. > [!TIP] > > Über die **drei Punkte** neben einer Regel kannst du bestehende Zuordnungen bearbeiten oder löschen. ### Einstellungen & Optionen | Einstellung | Funktion | | - | - | | Ressource | Bestimmt, welche Buchung ein Zutrittsrecht auslöst. | | Community | Bestimmt, welche Community-Mitglieder Zugang erhalten. | | Schlösser | Legt fest, welche Türen mit der Regel geöffnet werden können. | | Zugang vor der Buchung | Erweitert den Zugang um einen festgelegten Zeitraum vor dem Buchungsbeginn. | | Zugang nach der Buchung | Erweitert den Zugang um einen festgelegten Zeitraum nach dem Buchungsende. | | Zugang über Keypad | Ermöglicht den Zutritt per PIN ohne SALTO-KS-App bei einem kompatiblen Schloss mit Keypad. | | Fernöffnung verwenden | Erstellt Fernöffnungs-Zugänge, mit denen Kund:innen das Schloss aus anny öffnen. Ohne **Zusätzlich App-Zugang senden** ersetzt die Fernöffnung App- oder PIN-Zugang. | | Zusätzlich App-Zugang senden | Nur bei aktiver Fernöffnung. Kund:innen erhalten zusätzlich zur Fernöffnung den normalen Zugang über die SALTO-KS-App. Keypad-PIN entfällt in dieser Kombination. | ### Remote Open Mit Remote Open können Kund:innen Türschlösser per Knopfdruck über anny öffnen. Die Einrichtung liegt unter **Account → Apps & Integrationen → SALTO KS** im Bereich **Remote-Open** und ist optional. **1. IQ verbinden** Klicke auf **IQ hinzufügen**, wähle den IQ und verbinde ihn. anny versucht, das **IQ-Secret** von SALTO KS abzurufen. Fehlt es, trägst du es über **Secret manuell eingeben** ein oder holst es später mit **Secret erneut von Salto abrufen**. Die Tabelle zeigt pro IQ die Spalten **IQ**, **Status** und **IQ-Secret**. Der Status ist **Remote-Open bereit**, **Secret fehlt** oder **OTP ausstehend**. **2. OTP aktivieren** Klicke auf **Remote-Open via OTP hinzufügen**. Die Aktivierung ist dauerhaft: Jede Fernöffnung braucht danach ein Einmalpasswort. Wähle, ob Salto den Aktivierungs-PIN **Per SMS** oder **Per E-Mail** schickt. Gib den PIN ein und klicke auf **OTP aktivieren**. Über **OTP & PINs anzeigen** siehst du die **Aktuelle OTP-PIN** und je IQ ein Einmalpasswort (ca. 3 Minuten gültig). **3. In der Buchungsregel einschalten** Aktiviere in der Buchungsregel **Fernöffnung verwenden**. Optional **Zusätzlich App-Zugang senden**. Nur Schlösser hinter einem bereiten IQ stehen für die Fernöffnung zur Verfügung. | Ort | Wo öffnest du die Tür? | | - | - | | E-Mail | Der Button **Öffnen** in der Buchungs-E-Mail leitet in den Browser weiter. Dort öffnest du das Schloss. | | anny App | Der Button **Schloss entsperren** erscheint auf der Home-Seite und in deiner Buchung. | | Browser | Der Button **Schloss entsperren** erscheint auf der Home-Seite und in deiner Buchung. | Die Fernöffnung steht nur für Buchungsregeln zur Verfügung. Community-Regeln bieten Zugang per App oder PIN, aber keine Fernöffnung. ### Zutrittsrechte prüfen Öffne eine Buchung und wähle das zugehörige Zutrittsrecht aus. Dort siehst du den Status, den Zutrittszeitraum, das Türschloss, das Erstellungsdatum und gegebenenfalls den PIN-Code. Du kannst außerdem die Zugangs-URL kopieren. Die Buchungsdetailansicht zeigt aktive und inaktive Zutrittsrechte: ![SALTO-KS-Zutrittsrechte in einer Buchung prüfen](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295081/72020dae24cc69073a9729c23c8f/Frame-2B10-286-29.png?expires=1785256200\&signature=21c7bedc3b9c7dc8645ab333b7b8c010545dfcc8db0e7fda55847991ae9cb647\&req=09FtzF36pDZk2hL085ZhoRQIFMcum4Z2SXc7Ycys0YuzXXHP2M7NlbFlZvs8%0AdrNLgKG06W88aRPG%0A) | Status | Bedeutung | | - | - | | Geplant | Der Zutritt wird kurz vor dem Termin erstellt. Dieser Status tritt vor allem bei Serienbuchungen auf. | | In Bearbeitung | anny hat den Zutritt angefordert, SALTO KS hat ihn aber noch nicht vergeben. | | Erfolgreich | Der Zutritt ist aktiv und kann im angezeigten Zeitraum verwendet werden. | | Entfernt | Das System oder ein:e Admin hat den Zutritt entfernt. Die Person kann das Schloss nicht mehr öffnen. | ## Einschränkungen Die SALTO-KS-Integration unterstützt nicht: * PIN-Zutritt an Schlössern ohne kompatibles Keypad * die Erstellung neuer Zutrittsrechte, wenn die Integration deaktiviert oder nicht mehr autorisiert ist * die Nutzung von Smart-Lock-Integrationen in einem Plan unterhalb von Professional Die Anzahl verfügbarer Zutrittsrechte kann zusätzlich von deinem SALTO-KS-Vertrag abhängen. ## 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 > **Wie erhalten Kund:innen ihren SALTO-KS-Zugang?** > > Je nach Regel öffnen Kund:innen die Tür über die SALTO-KS-App, einen PIN-Code am Keypad oder Remote Open in anny. > **Brauchen Kund:innen einen SALTO-KS-Account?** > > Für den Zugang über die SALTO-KS-App melden sie sich mit derselben E-Mail-Adresse an, die sie für die Buchung verwendet haben. Für PIN-Zutritt ist kein SALTO-KS-Account nötig. > **Wann ist ein Zutrittsrecht gültig?** > > Das Zutrittsrecht gilt während der Buchung sowie für die in der Regel festgelegten Zeiträume vor und nach der Buchung. > **Was passiert bei einer Stornierung?** > > Wenn eine Buchung in anny storniert wird, entfernt anny auch das zugehörige Zutrittsrecht. > **Kann eine Ressource mehrere Schlösser öffnen?** > > Ja. Du kannst einer Ressource mehrere SALTO-KS-Schlösser zuordnen. ## Troubleshooting > **Für meine Buchung wurde kein Zutritt erstellt** > > Prüfe in der Buchungsdetailansicht im Abschnitt **Verbundene Daten**, ob ein Zutrittsrecht vorhanden ist. Kontrolliere anschließend unter **Account → Apps & Integrationen → SALTO KS**, ob die Integration aktiv und autorisiert ist und ob die Ressource einer Regel zugeordnet wurde. Bei Serienbuchungen steht der Zutritt zunächst auf **Geplant** und wird erst kurz vor dem Termin erstellt. > **Meine SALTO-KS-Schlösser werden nicht angezeigt** > > Prüfe zuerst, ob du unter **Account → Apps & Integrationen → SALTO KS** eine **Anlage** ausgewählt hast, denn erst dann sind Schlösser verfügbar. Kontrolliere danach, ob die Schlösser im SALTO-KS-Adminbereich eingerichtet und funktionsfähig sind. Autorisiere die Integration bei Bedarf erneut, damit anny die verfügbaren Schlösser neu lädt. > **Der PIN-Code öffnet die Tür nicht** > > Prüfe, ob das Schloss ein kompatibles Keypad besitzt und der Zutrittszeitraum bereits begonnen hat. Vergleiche anschließend den PIN-Code mit der Buchungsbestätigung und dem Zutrittsrecht in der Buchungsdetailansicht. > **Die Fernöffnung funktioniert nicht** > > Fernöffnung setzt einen verbundenen IQ mit aktiver OTP-Einrichtung voraus. Prüfe in der IQ-Tabelle den **Status** und in der Regel-Übersicht die Spalte **Mögliche Fehler**: Steht dort „OTP inaktiv", verbinde den IQ, schließe OTP unter **Remote-Open** ab und aktiviere in der Regel **Fernöffnung verwenden**. > **Die PIN-SMS oder PIN-E-Mail kommt nicht an** > > Salto sendet den Aktivierungs-PIN nur einmal pro Benutzer. Existiert bereits ein PIN, zeigt anny die Anleitung **IQ-PIN zurücksetzen**: Ein zweiter SALTO-KS-Administrator setzt den IQ-PIN zurück. Danach klickst du in anny erneut auf **OTP senden**. > Wichtige Informationen für Agenten: > > **Einordnung:** SALTO KS ist eine Smart-Lock-/Zutritts-Integration (Untergruppe „Zutritt & Smart-Locks"), technisch eine Access-Control-Integration wie Nuki, klever-key, Comydo, UniFi Access, Key-Cafe. Plan-Gating über das Feature INTEGRATIONS\_SMART\_LOCKS (laut Artikel ab Professional; genaue Plan-Grenze nicht aus dem Code verifizierbar). > > **Setup-Reihenfolge:** Seitenleiste **Account** → **Apps & Integrationen** (`/apps`) → **Alle Apps und Integrationen** → **SALTO KS** → **Einrichten** (bestehend: **Deine Apps** → **SALTO KS**; Toggle, Aktionsmenü und **Speichern** im Seitenkopf der Detailseite) → **Autorisieren** (OAuth, SALTO-KS-Admin-Account) → **Anlage** wählen (Pflicht; bestimmt verfügbare Schlösser; nur eine Anlage je Integration; Anlagenwechsel löscht alle Buchungsregeln und macht IQ/OTP der alten Anlage ungültig) → optional Bereich **Remote-Open**: **IQ hinzufügen** (Secret automatisch, manuell oder **Secret erneut von Salto abrufen**) + **Remote-Open via OTP hinzufügen** (Kanal **Per SMS** / **Per E-Mail**, Schalter **OTP aktivieren**, dauerhaft) → **OTP & PINs anzeigen** (aktuelle PIN + je-IQ-OTP, ca. 3 Min.) → Regeln unter „Zugang durch Buchungen" / „Zugang durch Communities" anlegen. Schalter **Fernöffnung verwenden** nur sichtbar, wenn `remote_open.otp_setup_complete` und mindestens ein IQ `remote_open_ready` (bestehende remote\_open-Regeln behalten den Schalter). > > **Regel-Felder (Buchung):** Ressource, Schlösser (Auswahl-Label „Zylinder auswählen", Spalte „Schlösser"), „Zugang vor der Buchung", „Zugang nach der Buchung", Schalter „Zugang über Keypad verwenden" (Spalte „Verwendet Tastatur-Pin"), Schalter „Fernöffnung verwenden" (Spalte „Fernöffnung"), Schalter „Zusätzlich App-Zugang senden" (`send_app_access`, nur wenn Fernöffnung an), Warnspalte „Mögliche Fehler" („OTP inaktiv: {Schloss} ({IQ})"). Community-Regeln haben KEINEN Fernöffnungs-Schalter, nur Keypad/App. > > **Zugangsarten pro Regel:** Standard exklusiv Fernöffnung (REMOTE\_OPEN, Button „Schloss entsperren"; E-Mail-Button „Öffnen" führt auf die Buchungsseite) ODER Keypad-PIN (PIN + „#") ODER SMARTPHONE\_APP (Einladung an die Buchungs-E-Mail). Ausnahme: `remote_open` + `send_app_access` erzeugt Fernöffnung UND App-Zugang und überspringt Keypad. > > **Quirks:** (1) Nur angenommene Buchungen mit Kund:in lösen Zugänge aus; interne Blocker nicht. Blocker→Buchung erstellt Zugang, Buchung→Blocker entfernt ihn. (2) Buchungsregel auf einer übergeordneten Ressource greift auch für Unterressourcen. (3) Pro Ressource ist nur eine Buchungsregel erlaubt (doppelte Ressource wird beim Speichern abgelehnt). (4) Einzelbuchungen: Zugang sofort. Serien-/wiederkehrende Buchungen: Zugang „Geplant", Erstellung ca. 48 h vor Zutrittsbeginn. (5) Einzelbuchungen erhalten eine zusätzliche Zugangs-E-Mail, Serienbuchungen nicht. (6) Community-Zugänge sind unbefristet (kein Enddatum); fehlende Zugänge für Bestandsmitglieder über „Fehlende Zutrittsrechte … erstellen" nachziehbar. (7) Änderung von Schlössern/Ressource einer Regel bzw. Löschen einer Regel passt künftige Zugänge automatisch an/entfernt sie. (8) Deaktivieren: keine neuen Zugänge, bestehende bleiben. Löschen: interne Zutrittsrechte werden entfernt und Ressourcenverknüpfungen gelöst. > > **Statuswerte:** Geplant, In Bearbeitung, Erfolgreich, Entfernt, Unbestätigt, Fehlgeschlagen, Nicht autorisiert, Aufräumen. > > **Zutritts-Detailansicht** („Smartlock Zugänge" im Abschnitt „Verbundene Daten" der Buchung): Status, Zugang beginnt/endet am, Türschloss, Erstellt am, Zugangs-URL kopieren, „Zugang beim Anbieter anzeigen", bei Fernöffnung „Schloss entsperren". > > **Terminologie:** UI nutzt gemischt „Zylinder" (Auswahl), „Schlösser" (Spalte), „Türschloss" (Detail) sowie „Zugang"/„Smartlock Zugänge" (Detail) neben dem Artikelbegriff „Zutrittsrecht". Für Zutritt allgemein siehe Übersicht „Zutritt & Smart-Locks". This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.