Salto KS-koppeling instellen: stappen aan de Salto- en i-Reserve-kant
De Salto KS-koppeling vereist configuratie aan twee kanten: eerst de Salto-installatie (Site + IQ + sloten + account), daarna de koppeling in i-Reserve, inclusief het activeren van de IQ-PIN.
1. Aan de Salto-kant
- Zorg dat er een Site bestaat en noteer de Site UID (bijv.
NL6254340082). - Zorg dat de IQ online gateway is gekoppeld aan de site en online is; noteer het IQ-id.
- Zorg dat de te bedienen sloten in de site zijn geregistreerd en bereikbaar via de IQ.
- Maak/gebruik een Salto KS-account (gebruikersnaam + wachtwoord) met voldoende rechten op de site.
De OAuth client-credentials voor Salto KS worden op platformniveau door i-Reserve beheerd; jij levert het account aan.
2. Aan de i-Reserve-kant — Authenticatie-tab
| Veld | Wat in te vullen |
|---|---|
| Omgeving | Acceptance (testen) of Production (live). Verplicht. |
| Site UID | De leesbare site-code uit Salto (bijv. NL6254340082). Verplicht. |
| Site ID | Het interne site-id (UUID). Klik op Resolve site ID om dit automatisch op te halen uit de Site UID. Alleen-lezen. |
| Gebruikersnaam | De gebruikersnaam van het Salto KS-account. Verplicht. |
| Wachtwoord | Het wachtwoord van het Salto KS-account. Verplicht. |
Klik op Test / toegang aanvragen om een token op te halen en de verbinding te controleren.
2.1 IQ OTP-setup (PIN activeren)
In het blok IQ OTP setup activeer je de IQ-gateway met een PIN. Dit is verplicht voordat sloten geopend kunnen worden.
- Vul het IQ-id in (UUID van de IQ-gateway).
- Klik op GET PIN om de huidige PIN van de IQ op te halen (verschijnt in current pin).
- Vul bij new pin de gewenste 4-cijferige PIN in.
- Klik op Set PIN: i-Reserve zet de nieuwe PIN op de IQ (ondertekend met een OTP op basis van de huidige PIN + het IQ-secret).
- Bij succes verandert de status naar “IQ is activated”. Vanaf nu kan i-Reserve geldige open-commando’s ondertekenen.
3. Details-tab
| Veld | Wat het doet |
|---|---|
| Slot mag openen vanaf status | De reserveringsstatus(sen) waarbij het openen van het slot is toegestaan. Meervoudige selectie. |
| Tijd vooraf (minuten) | Aantal minuten vóór de starttijd dat openen al mag (0–1440). |
| Laatste open-actie opslaan in veld | Reserveringsveld waarin het tijdstip van openen wordt vastgelegd. Optioneel. |
| Status na openen (check-in) | Reservering wordt na een geslaagde opening automatisch naar deze status gezet. Optioneel. |
3.1 Mapping: object → slot
Op het Mapping-tabblad koppel je per i-Reserve-object (product) een slot. Kies links het product en rechts het slot uit de keuzelijst; die lijst vul je met de knop GET locks (haalt de sloten van de site op). Een object zonder eigen mapping kan op een standaardslot (wildcard) vallen.
Objecten én sub-objecten. De objecten-keuzelijst links toont nu zowel hoofdobjecten als hun sub-objecten. Zo kun je een mapping leggen op het niveau van een specifiek sub-object (bijvoorbeeld één studio binnen een verzamelobject), niet alleen op het hoofdobject. Bij een reservering op een sub-object draagt de boeking dat sub-object, waardoor de meest specifieke mapping wordt gebruikt. Bestaande hoofdobject-mappings blijven gewoon werken.
4. Activeren
Sla op en zet de koppeling op actief. Test door een reservering naar de ingestelde status te brengen en de open-actie uit te voeren; controleer dat het slot opent en dat (indien ingesteld) de open-tijd en de check-in-status worden bijgewerkt.
