Salto KS-koppeling implementeren: checklist test en productie
Ontwikkelaar
Instructie
Moeilijkheidsgraad: Gemiddeld
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).
- ☐ Open-link
{OPENLOCKLINK}opgenomen in een e-mail- of sms-template dat de klant op tijd ontvangt. - ☐ Koppeling op actief gezet.
- ☐ Alleen bij sloten met toetsenbord: Pincode indien mogelijk op Ja, reserveringsveld voor de pincode gekozen,
{LOCKPIN}in de bevestiging, en de pincode van de testreservering opent het slot. - ☐ End-to-end getest: reservering in toegestane status → Slotcontrole vanuit de reservering: alle criteria groen → link uit het template openen → Open deur → 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.
- ☐ Productie-template met
{OPENLOCKLINK}actief en op het juiste moment verstuurd. - ☐ 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).
Neem de variabele {OPENLOCKLINK} op in een e-mail- of sms-template dat de klant vóór aanvang ontvangt (bijvoorbeeld de bevestiging of een herinnering). De koppeling verstuurt zelf niets: zonder deze link kan de klant het slot niet openen.
Zet de koppeling actief en breng een testreservering in een toegestane status. Controleer in het actieblok met Salto KS slot dat alle criteria groen zijn (zie het artikel Slotcontrole vanuit de reservering). Open daarna de link uit het template en druk op Open deur; controleer dat het slot opent en dat open-tijd/check-in worden bijgewerkt.
