{"id":"salto.rules","app":"salto","title":"PIN categories and automatic access rules","summary":"Choose when each category assigns, rotates and releases access.","url":"https://www.simultem-apps.com/wiki/salto#rules","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/salto.rules","resourceUri":"wiki://salto/rules","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02","keywords":["automatic","unique per reservation","rotate","assignment","release","events","custom category","defaults","webhooks","mappingReady","koodin vaihto"],"sections":[{"title":"Default PIN behavior","steps":["Accommodation unit defaults to Enabled, Automatic and Unique to reservation. Its assignment event is Unit assigned; Generate a fresh PIN when access is assigned is off, and Replace the old PIN when access is released is on.","Assignment reuses the locally recorded user PIN when possible. A missing PIN or a PIN already used by another unique reservation causes a new PIN to be generated even when fresh-PIN-on-assignment is off.","The default release events include checkout, no-show, unit unassignment, cancellation and deletion. A room move can release the old unit’s access and replace its PIN.","Other common area and Public entrance default to shared PINs with Automatic and both PIN replacement options off. Review saved rules because they can override defaults."],"notes":["Mappings ready does not gate reservation processing. To pause event-driven PIN changes while preserving read access, save Automatic off before assigning live users to the category."]},{"title":"Configure a category","steps":["Open Rules in an authorized account context and select the category and property scope.","Review whether the category is enabled and whether Automatic should process reservation events.","Choose assignment and release events for that category.","Review Unique to reservation, Generate a fresh PIN when access is assigned and Replace the old PIN when access is released.","Add a custom category only when it represents a real access policy and map the appropriate users to it.","Save the rules, then test the intended event sequence and inspect the reservation PIN record."],"notes":["Property-context rules can be read-only because a rule can affect several properties. Unique, rotate-on-assignment and rotate-on-release are separate settings."]}],"text":"# Salto: PIN categories and automatic access rules\n\nChoose when each category assigns, rotates and releases access.\n\n## Default PIN behavior\n\n1. Accommodation unit defaults to Enabled, Automatic and Unique to reservation. Its assignment event is Unit assigned; Generate a fresh PIN when access is assigned is off, and Replace the old PIN when access is released is on.\n\n2. Assignment reuses the locally recorded user PIN when possible. A missing PIN or a PIN already used by another unique reservation causes a new PIN to be generated even when fresh-PIN-on-assignment is off.\n\n3. The default release events include checkout, no-show, unit unassignment, cancellation and deletion. A room move can release the old unit’s access and replace its PIN.\n\n4. Other common area and Public entrance default to shared PINs with Automatic and both PIN replacement options off. Review saved rules because they can override defaults.\n\nNote: Mappings ready does not gate reservation processing. To pause event-driven PIN changes while preserving read access, save Automatic off before assigning live users to the category.\n\n## Configure a category\n\n1. Open Rules in an authorized account context and select the category and property scope.\n\n2. Review whether the category is enabled and whether Automatic should process reservation events.\n\n3. Choose assignment and release events for that category.\n\n4. Review Unique to reservation, Generate a fresh PIN when access is assigned and Replace the old PIN when access is released.\n\n5. Add a custom category only when it represents a real access policy and map the appropriate users to it.\n\n6. Save the rules, then test the intended event sequence and inspect the reservation PIN record.\n\nNote: Property-context rules can be read-only because a rule can affect several properties. Unique, rotate-on-assignment and rotate-on-release are separate settings.","related":[{"id":"salto.mapping","app":"salto","title":"Map Apaleo units to Salto users","summary":"Match the exact assigned unit with the correct site, access user and category.","url":"https://www.simultem-apps.com/wiki/salto#mapping","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/salto.mapping","resourceUri":"wiki://salto/mapping","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"},{"id":"salto.reservation-pins","app":"salto","title":"Generate, set and inspect reservation PINs","summary":"Check reservation eligibility, unit mapping and stay dates before changing access.","url":"https://www.simultem-apps.com/wiki/salto#reservation-pins","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/salto.reservation-pins","resourceUri":"wiki://salto/reservation-pins","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"},{"id":"salto.troubleshooting","app":"salto","title":"Access checks, test lab and support","summary":"Separate reservation, mapping, PIN, delivery and physical lock problems.","url":"https://www.simultem-apps.com/wiki/salto#troubleshooting","apiUrl":"https://www.simultem-apps.com/api/wiki/v1/articles/salto.troubleshooting","resourceUri":"wiki://salto/troubleshooting","revision":"2026-11-02.1","lastReviewedAt":"2026-11-02"}]}