Add-on: Sensorberg OCB v2

Connect your Storeganise account with Sensorberg to automate access control across the full customer lifecycle. When the Add-on is active, move-ins, move-outs, overdue lockouts, and unit transfers automatically update customer access in Sensorberg — no manual steps in the Sensorberg dashboard required.Note: Currently, all Add-ons must be installed by a Storeganise team member. Contact us to have this Add-on installed.

Prerequisites

Before setting up the Sensorberg v2 Add-on, make sure you have:
  • A Sensorberg OCB v2 account with an active API key
  • Your organisation's domain URL from the Sensorberg OCB dashboard (format: your-org.ocb.apps.sensorberg.com    )
  • The door ID for each unit you want the Add-on to manage (found in the Sensorberg dashboard)

Setting up the Sensorberg v2 Add-on

  1. In your Storeganise Admin Portal, navigate to Settings → Add-ons
  2. Locate Sensorberg and click Enable
  3. In the Add-on settings panel, enter your API key and your domain URL
  4. Click Save — the Add-on validates your credentials automatically
  5. For each unit, set the sensorberg_id   custom field to the corresponding door ID from the Sensorberg dashboard

A confirmation appears when the connection is active. If your credentials are invalid, a task is created on the Add-on settings — update your credentials and save again.Note: Units without sensorberg_id   populated will not have access provisioned automatically. A task is created on the unit rental if a move-in is attempted on an unmapped unit.

How access works

Move-in
When a move-in job is completed in Storeganise, the Add-on:
  • Creates the customer in Sensorberg if they don't already have an account, or reuses their existing one
  • Assigns the customer to the Permission Set configured for their unit
  • Generates a PIN and stores it on the unit rental and the customer's user record
If the customer already has a PIN from a previous rental, the existing PIN is reused — no new code is generated.
Move-out
When a move-out job is completed, the customer's Permission Set assignment for that unit is removed in Sensorberg. If the customer has other active rentals, their access to those units is unaffected.
Unit transfer
When a customer transfers to a different unit, access to the old unit is revoked and access to the new unit is provisioned automatically. If there is an issue revoking the old unit, the new unit is still provisioned — the two steps operate independently.

Overdue lockout and restoration

When a rental is marked overdue in Storeganise, the customer's access is suspended across all of their active units at the site. The Add-on retains the permission references so access can be restored when the account is brought current.When the overdue status is cleared, new Permission Set assignments are issued for all suspended rentals and the customer's access is restored automatically.Note: Overlock in Sensorberg v2 works via full access revocation. A new permission reference is issued on restoration — the original reference is no longer valid after lockout.

Manual overlock and unlock

Operators can manually suspend or restore a customer's access for a specific unit directly from the unit rental in the Management Portal.To manually overlock a unit:
  1. Open the unit rental
  2. Navigate to Custom fields
  3. Set Sensorberg - Overlocked (sensorberg_overlocked    ) to true    
  4. Save the rental
The customer's access for that unit is revoked in Sensorberg immediately. Other active rentals for the same customer are not affected.To unlock the unit:
  1. Set Sensorberg - Overlocked to false     and save
A new Permission Set assignment is issued and the customer's access is restored.

Managing PIN codes

A customer's PIN is stored on their Storeganise user record and on each of their active unit rentals. To update a customer's PIN:
  1. Open any of the customer's active unit rentals
  2. Update the Sensorberg PIN (sensorberg_pin    ) custom field to the new value
  3. Save the rental
The Add-on updates the PIN on the customer's Sensorberg account and syncs the new value to all of their other active unit rentals automatically.

Migrating existing customers

If you have customers who were already renting before the Add-on was installed, contact Storeganise support to set up a migration. Existing rentals can be brought under Add-on management without running new move-in jobs.

Troubleshooting

A task appears on the unit rental after a move-inThe most common cause is a missing or incorrect sensorberg_id    on the unit. Verify the door ID is correctly set on the unit record in Storeganise and that it matches the door ID in the Sensorberg dashboard.A task appears after a manual overlock or unlockThis indicates the zone status update in Sensorberg failed. Check that your Add-on credentials are still valid (**Settings → Add-ons → Sensorberg v2**) and try the action again.The customer still has access after a move-outIf access was not revoked, check the unit rental for an error task. This typically indicates a connection issue at the time of the move-out. Contact Storeganise support if the issue persists.Invalid credentials task on the Add-onYour OCB v2 API key or domain URL is incorrect or has expired. Update the credentials in the Add-on settings and save — the Add-on will revalidate automatically.
Jump to
Related articles
Add-on: Sensorberg access control
Add-on: Sensorberg OCB v2