> ## 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.
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
Öffne aus der Menüleiste die **Integrationen** und gehe zu **SALTO KS**. Klicke 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:
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.
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 (setzt einen verbundenen IQ mit aktivem OTP voraus).
Diese Ansicht zeigt die Regel für buchungsbasierte Zutritte:
Die Detailansicht zeigt die Auswahl von Ressource, Schloss und Zutrittszeitraum:
Diese Ansicht zeigt die Zuordnung einer Community zu SALTO-KS-Schlössern:
Sobald die Verbindung aktiv ist, erstellt anny Zutrittsrechte automatisch nach deinen Regeln.
Ü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 statt App- oder PIN-Zugängen Fernöffnungs-Zugänge, mit denen Kund:innen das Schloss aus anny öffnen. |
### Remote Open
Mit Remote Open können Kund:innen Türschlösser per Knopfdruck über anny öffnen. Du aktivierst die Fernöffnung pro Buchungsregel über den Schalter **Fernöffnung verwenden**. Voraussetzung ist ein in anny verbundener IQ mit abgeschlossener OTP-Einrichtung; nur dann sind die zugehörigen Schlösser für die Fernöffnung verfügbar.
| 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:
| 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
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
Je nach Regel öffnen Kund:innen die Tür über die SALTO-KS-App, einen PIN-Code am Keypad oder Remote Open in anny.
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.
Das Zutrittsrecht gilt während der Buchung sowie für die in der Regel festgelegten Zeiträume vor und nach der Buchung.
Wenn eine Buchung in anny storniert wird, entfernt anny auch das zugehörige Zutrittsrecht.
Ja. Du kannst einer Ressource mehrere SALTO-KS-Schlösser zuordnen.
## Troubleshooting
Prüfe in der Buchungsdetailansicht, ob ein Zutrittsrecht vorhanden ist. Kontrolliere anschließend unter **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.
Prüfe zuerst, ob du unter **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.
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.
Fernöffnung setzt einen verbundenen IQ mit aktiver OTP-Einrichtung voraus. Prüfe in der Regel-Übersicht die Spalte **Mögliche Fehler**: Steht dort „OTP inaktiv", richte den IQ und OTP unter **Integrationen → SALTO KS** ein und aktiviere in der Regel den Schalter **Fernöffnung verwenden**.
> 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:** Menüleiste → **Integrationen** → **SALTO KS** → **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) → optional **IQ verbinden** + **OTP aktivieren** (Voraussetzung für Fernöffnung) → Regeln unter „Zugang durch Buchungen" / „Zugang durch Communities" anlegen.
>
> **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"), Warnspalte „Mögliche Fehler" („OTP inaktiv: {Schloss} ({IQ})"). Community-Regeln haben KEINEN Fernöffnungs-Schalter, nur Keypad/App.
>
> **Zugangsarten pro Regel (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).
>
> **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" in 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".