Entwickler
Anleitung
Schwierigkeitsgrad: Mittel

An einer Salto KS-Verbindung sind drei Parteien beteiligt: der Kunde (Eigentümer des Standorts und der i-Reserve-Lizenz), der Salto-Installateur (installiert und verwaltet die Schlösser und die Salto KS-Site) und i-Reserve (richtet die Verbindung ein). Diese Seite zeigt, wer was macht und welche Angaben und Rechte nötig sind. Den Link zu dieser Seite können Sie direkt an den Salto-Installateur weiterleiten.

Kurz gesagt: was i-Reserve braucht

AngabeWas ist dasWer liefert
UmgebungBei einem echten Kunden immer Production (app.saltoks.com). Acceptance ist nur für Tests.Installateur
Site UIDDer lesbare Code der Site, zum Beispiel NL6254340082. Die interne Site ID holt i-Reserve selbst.Installateur
IQ-IDDie ID des IQ-Gateways vor Ort. Das IQ muss mit der Site verknüpft und online sein.Installateur
Salto KS-KontoBenutzername und Passwort eines eigenen Kontos für i-Reserve mit Administratorrechten auf der Site (siehe unten).Installateur oder Kunde
Aktuelle IQ-PINDie 4-stellige PIN dieses Kontos auf dem IQ. i-Reserve kann sie auch selbst abrufen und eine neue setzen.Installateur (oder i-Reserve)
SchlosslisteWelches Schloss zu welchem Raum oder Produkt gehört und welche Schlösser eine Tastatur haben.Kunde + Installateur

Senden Sie das Passwort nicht in einer normalen E-Mail, sondern über einen sicheren Weg, zum Beispiel einen einmaligen Freigabelink.

Aufgaben des Salto-Installateurs

  1. Die Site in Salto KS (Produktion) einrichten und die Site UID notieren.
  2. Das IQ-Gateway installieren, mit der Site verknüpfen und dafür sorgen, dass es online ist. Die IQ-ID notieren.
  3. Die Schlösser in der Site registrieren, erreichbar über das IQ. Geben Sie ihnen erkennbare Namen (zum Beispiel „Haupteingang“, „Saal 1“): Diese Namen sieht der Kunde bei der Zuordnung in i-Reserve.
  4. Ein eigenes Salto KS-Konto für i-Reserve anlegen (zum Beispiel ireserve@<Kundendomain>) und ihm mit einer Administratorrolle Zugriff auf die Site geben (siehe „Benötigte Rechte“).
  5. Die Angaben aus der Tabelle oben an den Kunden oder an i-Reserve weitergeben.
  6. Beim ersten Test erreichbar sein, falls ein Schloss oder das IQ nicht reagiert.

Benötigte Rechte des i-Reserve-Kontos

Das Konto erledigt im Namen des Kunden alles, was mit Reservierungen zu tun hat. Auf der Site muss es deshalb:

Recht in Salto KSWofür i-Reserve es nutzt
Sites und Schlösser einsehenSite ID abrufen, die Schlossliste für die Zuordnung und sehen, welche Schlösser eine Tastatur haben.
IQs verwaltenDas IQ für dieses Konto aktivieren (IQ-PIN abrufen und setzen). Ohne aktives IQ öffnet sich keine Tür.
Schlösser aus der Ferne öffnenDie Tür öffnen, wenn der Gast den Öffnungslink drückt.
Benutzer verwalten (anlegen, ändern, löschen)Nur bei PIN-Codes: pro Reservierung ein temporärer Benutzer mit der Standardrolle site user und einem PIN-Code, der danach wieder gelöscht wird.
Zugangsgruppen und Zeitpläne verwaltenNur bei PIN-Codes: den PIN-Code nur am richtigen Schloss und im Zeitfenster der Reservierung gültig machen.

In der Praxis: Geben Sie dem Konto eine Administratorrolle auf der Site (die Standardrolle für die Site-Verwaltung oder eine eigene Rolle unter Roles mit mindestens den Rechten oben). Eine normale Benutzerrolle reicht nicht: Dann schlägt schon der Verbindungstest oder die IQ-Aktivierung fehl.

Warum ein eigenes Konto?

  • Das IQ wird pro Konto mit einer PIN aktiviert. Ändert jemand diese PIN außerhalb von i-Reserve, oder wird ein persönliches Konto gelöscht oder sein Passwort geändert, stoppt die Verbindung.
  • Im Salto-Protokoll ist dann sofort zu sehen, welche Aktionen von i-Reserve kommen.

Was der Installateur in Salto sieht

  • Öffnungsaktionen an Schlössern durch das i-Reserve-Konto.
  • Bei PIN-Codes: temporäre Benutzer mit dem Namen i-Reserve <Reservierungsnummer>, jeweils mit eigener Zugangsgruppe. i-Reserve räumt sie selbst auf, einen Tag nach Ende der Reservierung. Löschen oder ändern Sie sie nicht von Hand.

Aufgaben des Kunden

  1. Den Salto-Installateur beauftragen und diese Seite weiterleiten.
  2. Festlegen, welche Räume oder Produkte welches Schloss öffnen.
  3. Wählen, ab welchem Reservierungsstatus die Tür öffnen darf, wie viele Minuten vorher und ob Gäste einen PIN-Code erhalten (nur bei Schlössern mit Tastatur).
  4. Den Öffnungslink ({OPENLOCKLINK}) und gegebenenfalls den PIN-Code ({LOCKPIN}) in die Bestätigungs-E-Mail oder -SMS aufnehmen.
  5. Am Test vor Ort teilnehmen: eine Testreservierung anlegen und die Tür über den Link öffnen.

Aufgaben von i-Reserve

  1. Die Verbindung mit den gelieferten Angaben anlegen und die Verbindung testen.
  2. Das IQ aktivieren (IQ OTP setup), bis der Status IQ is activated lautet.
  3. Zusammen mit dem Kunden die Schlösser Räumen oder Produkten zuordnen (Mapping) und die Details einstellen.
  4. Die erste Live-Öffnung prüfen. Siehe die Implementierungs-Checkliste und Salto KS-Verbindung einrichten.