Ontwikkelaar
Instructie
Moeilijkheidsgraad: Gemiddeld

Een Salto KS-koppeling heeft drie partijen: de klant (eigenaar van de locatie en de i-Reserve-licentie), de Salto-installateur (plaatst en beheert de sloten en de Salto KS-site) en i-Reserve (stelt de koppeling in). Deze pagina zet op een rij wie wat doet en welke gegevens en rechten nodig zijn. Je kunt de link naar deze pagina direct doorsturen naar de Salto-installateur.

In het kort: wat i-Reserve nodig heeft

GegevenWat is hetWie levert
OmgevingBij een echte klant altijd Production (app.saltoks.com). Acceptance is alleen voor tests.Installateur
Site UIDDe leesbare code van de site, bijvoorbeeld NL6254340082. Het interne Site ID haalt i-Reserve er zelf bij op.Installateur
IQ-idHet id van de IQ-gateway op de locatie. De IQ moet aan de site gekoppeld zijn en online staan.Installateur
Salto KS-accountGebruikersnaam en wachtwoord van een apart account voor i-Reserve, met beheerrechten op de site (zie hieronder).Installateur of klant
Huidige IQ-PINDe 4-cijferige PIN van dit account op de IQ. i-Reserve kan hem ook zelf ophalen en een nieuwe zetten.Installateur (of i-Reserve)
SlotenlijstWelk slot hoort bij welke ruimte of welk product, en welke sloten een toetsenbord hebben.Klant + installateur

Stuur het wachtwoord niet in een gewone e-mail mee, maar via een beveiligde weg, bijvoorbeeld een eenmalige deellink.

Taken van de Salto-installateur

  1. Site inrichten in Salto KS (productie) en de Site UID noteren.
  2. IQ-gateway plaatsen, aan de site koppelen en zorgen dat hij online is. Noteer het IQ-id.
  3. Sloten registreren in de site, bereikbaar via de IQ. Geef ze herkenbare namen (bijvoorbeeld “Hoofdingang”, “Zaal 1”): die namen ziet de klant terug bij het koppelen in i-Reserve.
  4. Een apart Salto KS-account voor i-Reserve aanmaken (bijvoorbeeld ireserve@<klantdomein>) en het toegang geven tot de site met een beheerdersrol (zie “Benodigde rechten”).
  5. De gegevens uit de tabel hierboven aan de klant of i-Reserve geven.
  6. Bij de eerste test bereikbaar zijn, voor het geval een slot of de IQ niet reageert.

Benodigde rechten van het i-Reserve-account

Het account handelt namens de klant alles af wat met reserveringen te maken heeft. Het moet daarom op de site:

Recht in Salto KSWaarvoor gebruikt i-Reserve het
Sites en sloten inzienSite ID ophalen, de slotenlijst voor de mapping en zien welke sloten een toetsenbord hebben.
IQ’s beherenDe IQ activeren voor dit account (IQ-PIN ophalen en zetten). Zonder actieve IQ gaat er geen deur open.
Sloten op afstand openenDe deur openen als de gast op de open-link drukt.
Gebruikers beheren (aanmaken, wijzigen, verwijderen)Alleen bij pincodes: per reservering een tijdelijke gebruiker met de standaardrol site user en een pincode, die na afloop weer wordt verwijderd.
Toegangsgroepen en tijdschema’s beherenAlleen bij pincodes: de pincode alleen geldig maken op het juiste slot en binnen het tijdvenster van de reservering.

In de praktijk betekent dit: geef het account een beheerdersrol op de site (de standaardrol voor sitebeheer, of een eigen rol onder Roles met minimaal de rechten hierboven). Een gewone gebruikersrol is niet genoeg: dan mislukt al de verbindingstest of de IQ-activatie.

Waarom een apart account?

  • De IQ wordt per account geactiveerd met een PIN. Wijzigt iemand die PIN buiten i-Reserve om, of wordt een persoonlijk account verwijderd of het wachtwoord gewijzigd, dan stopt de koppeling.
  • In het Salto-logboek is dan meteen te zien welke acties van i-Reserve komen.

Wat de installateur in Salto terugziet

  • Open-acties op sloten door het i-Reserve-account.
  • Bij pincodes: tijdelijke gebruikers met de naam i-Reserve <reserveringsnummer>, elk met een eigen toegangsgroep. i-Reserve ruimt deze zelf op, een dag na afloop van de reservering. Verwijder of wijzig ze niet met de hand.

Taken van de klant

  1. Opdracht geven aan de Salto-installateur en deze pagina doorsturen.
  2. Bepalen welke ruimtes of producten welk slot openen.
  3. Kiezen vanaf welke reserveringsstatus de deur open mag, hoeveel minuten vooraf, en of gasten een pincode krijgen (alleen bij sloten met toetsenbord).
  4. De open-link ({OPENLOCKLINK}) en eventueel de pincode ({LOCKPIN}) opnemen in de bevestigingsmail of sms.
  5. Meedoen aan de test op locatie: een testreservering maken en de deur via de link openen.

Taken van i-Reserve

  1. De koppeling aanmaken met de aangeleverde gegevens en de verbinding testen.
  2. De IQ activeren (IQ OTP setup) tot de status IQ is activated.
  3. Samen met de klant de sloten aan ruimtes of producten koppelen (mapping) en de details instellen.
  4. De eerste live opening controleren. Zie de implementatie-checklist en Salto KS-koppeling instellen.