Instructie
Moeilijkheidsgraad:
Salto KS-koppeling implementeren: checklist test en productie
Praktische implementatiegids voor de Salto KS-koppeling (toegangscontrole met IQ-gateway en sloten), met een checklist voor test en productie. De stappen beschrijven de volgorde; gebruik daarna de checklists per omgeving.
Aandachtspunten
- De IQ-gateway moet online zijn en met een PIN geactiveerd ("IQ is activated").
- De PIN + het IQ-secret vormen de tijdgebonden OTP; verander de PIN niet buiten i-Reserve om zonder opnieuw te activeren.
- Test eerst volledig in acceptance; production heeft een eigen account, site en IQ.
- Server-tijdzone moet correct staan (OTP en tijdvenster rekenen met UTC).
Checklist — testomgeving (acceptance)
- ☐ Salto-site bestaat; Site UID genoteerd.
- ☐ IQ online gateway gekoppeld en online; IQ-id genoteerd.
- ☐ Sloten geregistreerd in de site en bereikbaar via de IQ.
- ☐ Salto KS-account (gebruikersnaam + wachtwoord) met rechten op de site.
- ☐ i-Reserve Auth-tab: omgeving = Acceptance, Site UID ingevuld, Site ID via "Resolve site ID" opgehaald, account ingevuld; verbinding getest.
- ☐ IQ OTP-setup: IQ-id ingevuld, GET PIN, nieuwe PIN gezet via Set PIN; status = "IQ is activated".
- ☐ Details-tab: "slot mag openen vanaf status", tijd vooraf, open-actie-veld en check-in-status ingesteld.
- ☐ Mapping: producten gekoppeld aan de juiste sloten (GET locks).
- ☐ Koppeling op actief gezet.
- ☐ End-to-end getest: reservering → status → open-actie → slot opent; open-tijd en check-in-status gecontroleerd.
Checklist — productieomgeving
- ☐ Omgeving op Production; productie-account, productie-site (Site UID) en productie-IQ gebruikt.
- ☐ IQ in productie online en met een PIN geactiveerd ("IQ is activated").
- ☐ Echte sloten correct gemapt aan de productie-producten.
- ☐ Statussen (openen toegestaan + check-in) afgestemd op de echte boekingsflow.
- ☐ Eerste live opening geverifieerd (slot opent + open-tijd/check-in bijgewerkt).
- ☐ Rollback bekend: koppeling op inactief zetten stopt nieuwe open-acties.
Zorg dat de Site bestaat (noteer de Site UID), de IQ-gateway online is (noteer het IQ-id) en de sloten zijn geregistreerd; regel een Salto KS-account met rechten op de site.
Voeg in Beheer > Integraties een Salto KS-koppeling toe; kies de omgeving, vul Site UID + account in, haal het Site ID op met Resolve site ID en test de verbinding.
Vul in het IQ OTP-setup-blok het IQ-id in, klik GET PIN, zet een nieuwe 4-cijferige PIN via Set PIN en controleer dat de status "IQ is activated" toont.
Stel op de Details-tab "slot mag openen vanaf status", tijd vooraf, open-actie-veld en check-in-status in; koppel in de mapping elk product aan het juiste slot (GET locks).
Zet de koppeling actief, breng een testreservering naar de status en voer de open-actie uit; controleer dat het slot opent en dat open-tijd/check-in worden bijgewerkt.
