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. Den Öffnungslink an den Kunden senden
Die Verbindung versendet selbst nichts: Es geht keine E-Mail und kein Code automatisch an den Kunden, und eine Statusänderung öffnet das Schloss nicht. Der Kunde öffnet das Schloss über einen persönlichen Link. Diesen Link nehmen Sie mit der Variable {OPENLOCKLINK} in eine E-Mail- oder SMS-Vorlage auf (siehe Reservierungsvariablen).
- Wählen Sie die Vorlage, mit der der Kunde den Link erhält, zum Beispiel die Bestätigung oder eine Erinnerung kurz vor Beginn.
- Nehmen Sie den Link auf, zum Beispiel: Bei Ankunft öffnen Sie die Tür über diesen Link: {OPENLOCKLINK}
- Der Kunde öffnet den Link auf dem Telefon und sieht die Seite Tür öffnen mit der Reservierung. An der Tür drückt der Kunde auf die Schaltfläche Tür öffnen.
Beim Öffnen der Seite und beim Klicken prüft i-Reserve Folgendes. Schlägt eine Prüfung fehl, zeigt die Seite die Meldung aus der rechten Spalte und das Schloss bleibt zu.
| Prüfung | Meldung bei Fehlschlag |
|---|---|
| Der Link (Reservierungsnummer + Hashkey) ist gültig. | Dieser Zugangslink ist ungültig. |
| Es gibt eine aktive Salto KS-Verbindung. | Für diese Reservierung wurde keine aktive Schlossintegration gefunden. |
Das Objekt der Reservierung hat ein Schloss im Mapping (oder es gibt einen Platzhalter *). | Für das Objekt dieser Reservierung wurde kein Schloss-Mapping gefunden. |
| Der Status der Reservierung steht unter Schloss darf öffnen ab Status. Leer = jeder Status. | Das Öffnen der Tür ist beim aktuellen Reservierungsstatus nicht erlaubt (…). |
| Es ist jetzt zwischen Startzeit minus Vorlaufzeit und dem Ende der Reservierung. | Das Öffnen der Tür ist ab … möglich / Das Öffnen der Tür ist nicht mehr möglich (Reservierung endete um …). |
Nach einer erfolgreichen Öffnung schreibt i-Reserve den Zeitpunkt in das Öffnungs-Aktionsfeld und setzt die Reservierung auf den Check-in-Status. Diese Statusänderung läuft über die normale Statusverarbeitung, genau wie eine manuelle Änderung.
Tipp zum Testen: Senden Sie die Vorlage bei einer Testreservierung an sich selbst und öffnen Sie den Link im Browser. Die Meldung auf der Seite zeigt sofort, welche Prüfung noch nicht erfüllt ist.
4.1 Schlossprüfung aus der Reservierung
Mit einer aktiven Salto KS-Verbindung steht im Aktionsblock jeder Reservierung die Schaltfläche Salto KS Schloss. Sie zeigt je Kriterium einen grünen Haken oder ein rotes Kreuz und liefert den Kundenlink zum Kopieren oder Öffnen. Siehe Schlossprüfung aus der Reservierung.
4.2 Öffnen mit PIN
Hat ein Schloss eine Tastatur, kann der Kunde es auch mit einer PIN öffnen. Setzen Sie dazu in den Einstellungen der Verbindung unter PIN auf der Tastatur die Option PIN wenn möglich auf Ja (Standard Nein) und wählen Sie das Reservierungsfeld für die PIN.
- Ob ein Schloss eine Tastatur hat, erkennt i-Reserve am Schlosstyp in Salto. Der Einstellungsbildschirm zeigt diese Schlösser unter Schlösser mit Tastatur. Fügen Sie in Salto ein Schloss hinzu, rufen Sie die Schlösser erneut ab.
- Erhält eine Reservierung einen Status aus Schloss darf bei Status öffnen, legt i-Reserve in Salto einen eigenen Benutzer mit einer PIN an, gültig von der Startzeit minus Zeit zuvor bis zum Ende der Reservierung. Das geschieht vor der Status-E-Mail, sodass die PIN mit
{LOCKPIN}in die Bestätigung kann. - Bei einem Schloss ohne Tastatur bleibt es beim Link. Der Link funktioniert auch bei einem Schloss mit PIN weiterhin, zum Beispiel um ihn spontan per SMS zu senden.
- Verschieben Sie die Reservierung (Datum, Zeit oder Objekt), wandert der Zugang mit; die PIN bleibt gleich. Erhält die Reservierung einen anderen Status oder wird sie gelöscht, wird die PIN widerrufen. Einen Tag nach dem Ende entfernt i-Reserve den Benutzer in Salto.
- Der Kunde gibt die PIN am Schloss ein. Salto wählt die PIN selbst (6 Ziffern).
5. Aktivieren und testen
Speichern Sie und setzen Sie die Verbindung auf aktiv. Öffnen Sie eine Testreservierung und prüfen Sie mit Salto KS Schloss im Aktionsblock, dass alle Kriterien grün sind (siehe Schlossprüfung aus der Reservierung). Öffnen Sie danach den Link aus der Vorlage und drücken Sie auf Tür öffnen. Prüfen Sie, dass das Schloss öffnet und dass (falls eingestellt) die Öffnungszeit und der Check-in-Status aktualisiert werden.
