Salto KS-Verbindung einrichten: Schritte auf Salto- und i-Reserve-Seite
Die Salto KS-Verbindung erfordert Konfiguration auf zwei Seiten: zuerst die Salto-Installation (Site + IQ + Schlösser + Konto), danach die Verbindung in i-Reserve, einschließlich der Aktivierung der IQ-PIN.
1. Auf Salto-Seite
- Stellen Sie sicher, dass eine Site existiert, und notieren Sie die Site UID (z. B.
NL6254340082). - Stellen Sie sicher, dass das IQ online gateway mit der Site verbunden und online ist; notieren Sie die IQ-ID.
- Stellen Sie sicher, dass die zu bedienenden Schlösser in der Site registriert und über das IQ erreichbar sind.
- Erstellen/verwenden Sie ein Salto KS-Konto (Benutzername + Passwort) mit ausreichenden Rechten auf der Site.
Die OAuth-Client-Credentials für Salto KS werden auf Plattformebene von i-Reserve verwaltet; Sie liefern das Konto.
2. Auf i-Reserve-Seite — Authentifizierungs-Tab
| Feld | Was einzutragen ist |
|---|---|
| Umgebung | Acceptance (Testen) oder Production (Live). Erforderlich. |
| Site UID | Der lesbare Site-Code aus Salto (z. B. NL6254340082). Erforderlich. |
| Site ID | Die interne Site-ID (UUID). Klicken Sie auf Resolve site ID, um diese automatisch aus der Site UID abzurufen. Nur Lesen. |
| Benutzername | Der Benutzername des Salto KS-Kontos. Erforderlich. |
| Passwort | Das Passwort des Salto KS-Kontos. Erforderlich. |
Klicken Sie auf Test / Zugang anfordern, um ein Token abzurufen und die Verbindung zu prüfen.
2.1 IQ OTP-Setup (PIN aktivieren)
Im Block IQ OTP setup aktivieren Sie das IQ-Gateway mit einer PIN. Dies ist erforderlich, bevor Schlösser geöffnet werden können.
- Tragen Sie die IQ-ID ein (UUID des IQ-Gateways).
- Klicken Sie auf GET PIN, um die aktuelle PIN des IQ abzurufen (erscheint in current pin).
- Tragen Sie bei new pin die gewünschte 4-stellige PIN ein.
- Klicken Sie auf Set PIN: i-Reserve setzt die neue PIN auf dem IQ (signiert mit einem OTP auf Basis der aktuellen PIN + des IQ-Secrets).
- Bei Erfolg ändert sich der Status auf “IQ is activated”. Ab jetzt kann i-Reserve gültige Öffnungsbefehle signieren.
3. Details-Tab
| Feld | Was es bewirkt |
|---|---|
| Schloss darf öffnen ab Status | Der/die Reservierungsstatus, bei dem/denen das Öffnen des Schlosses erlaubt ist. Mehrfachauswahl. |
| Zeit im Voraus (Minuten) | Anzahl der Minuten vor der Startzeit, ab der das Öffnen bereits erlaubt ist (0–1440). |
| Letzte Öffnungsaktion in Feld speichern | Reservierungsfeld, in dem der Zeitpunkt des Öffnens erfasst wird. Optional. |
| Status nach Öffnen (Check-in) | Die Reservierung wird nach erfolgreichem Öffnen automatisch auf diesen Status gesetzt. Optional. |
3.1 Mapping: Objekt → Schloss
Auf dem Mapping-Tab verbinden Sie pro i-Reserve-Objekt (Produkt) ein Schloss. Wählen Sie links das Produkt und rechts das Schloss aus der Auswahlliste; diese Liste füllen Sie mit der Schaltfläche GET locks (ruft die Schlösser der Site ab). Ein Objekt ohne eigenes Mapping kann auf ein Standardschloss (Wildcard) zurückfallen.
Objekte und Sub-Objekte. Die Objekt-Auswahlliste links zeigt nun sowohl Hauptobjekte als auch deren Sub-Objekte. So können Sie ein Mapping auf der Ebene eines bestimmten Sub-Objekts anlegen (zum Beispiel ein einzelnes Studio innerhalb eines Sammelobjekts), nicht nur auf dem Hauptobjekt. Bei einer Reservierung auf einem Sub-Objekt trägt die Buchung dieses Sub-Objekt, wodurch das spezifischste Mapping verwendet wird. Bestehende Hauptobjekt-Mappings funktionieren weiterhin.
4. Aktivieren
Speichern Sie und setzen Sie die Verbindung auf aktiv. Testen Sie, indem Sie eine Reservierung in den eingestellten Status bringen und die Öffnungsaktion ausführen; prüfen Sie, dass das Schloss öffnet und dass (falls eingestellt) die Öffnungszeit und der Check-in-Status aktualisiert werden.
