Developer
Instruction
Difficulty level: Easy
Reservering > Actieblok > Salto KS slot

With an active Salto KS integration, the action block of every booking has a Salto KS lock button. It opens the lock check: at a glance you see whether the customer can open the lock with this booking, and you have the customer link right at hand.

The criteria

The lock check runs the same checks as the page the customer opens via the link. Each criterion gets a green check or a red cross. Below a red cross you see the message the customer would see at that moment.

CriterionWhat you seeRed? How to fix it
Active Salto KS integration–Set the integration to active in Administration > Integrations.
Lock mapped to the objectThe object and the lock, for example Sports hall → Keypad lock.Link the object (or a wildcard *) to a lock on the Mapping tab of the integration.
Booking status allows openingThe current status and the allowed statuses.Move the booking to an allowed status, or add the status under Lock may open from status.
Within the opening time windowFrom when until when the customer can open: start time minus Time before until the end time.Usually nothing: before the window, “not yet” is normal. Adjust Time before if needed.

Below that is a summary: green when the customer can open the lock now, orange when that is not possible (yet). Even when it is orange you can send the link already: it works as soon as all criteria are met.

The customer link

At the bottom of the lock check you find the personal link of this booking, with two buttons:

  • Copy link – copies the link to the clipboard, for example to send it by SMS on the spot or paste it in a chat message.
  • Open link – opens the customer page in a new tab. Useful for testing yourself; note: the Open door button on that page really opens the lock.

Sending the link automatically

You do not want to send the link by hand every time. Include the variable {OPENLOCKLINK} in an e-mail or SMS template the customer receives before the start. See Sending the open link to the customer.

PIN

When PIN when possible is on (see Opening with a PIN), the lock check also shows the PIN:

  • Lock without keypad: the customer opens with the link.
  • PIN created: the PIN with a green check. Revoke PIN stops it from working on the lock; you are asked to confirm first. A new PIN is not the one the customer already received.
  • No PIN yet: it comes as soon as the booking gets a status the lock may open in. Create PIN creates it right away, for example when that failed at the status change.

Use when testing

The lock check is the first step of the end-to-end test in the implementation checklist: only when all criteria are green does it make sense to open the lock via the link.