Add-on: PTI access control

The Storeganise PTI Add-on helps manage and synchronize access credentials, streamlining the entire process of unit rentals, move-ins, move-outs, and more.

This guide will walk you through setting up the PTI add-on, configuring unit synchronization, managing user access, and troubleshooting common issues.

Setting up the PTI Add-on

Install the PTI Add-On

• Go Sites > [Site] > Add-ons and click the + icon to select an Add-on
• Find and install the PTI Add-on. You may need to contact support to get this added.
• During installation, you will need to enter your PTI credentials:
  • PTI Site Code
  • PTI Site Key
  • PTI Username and Password
  • PTI Default Zone (timezone for units)

You can obtain these credentials from your PTI representative or system administrator. Typically, these credentials are provided when setting up the integration for a specific storage facility. If any credentials are missing, users should contact PTI support or their system administrator directly.

Once you’ve filled in your add-on settings, click “Enable”.

Credential syncing

Storeganise uses the PTI credentials provided during the Add-on setup to securely connect with Storlogix.

These credentials (PTI Site Key, Site Code, Username, and Password) allow Storeganise to communicate directly with PTI's backend and facilitate data exchange.

• Unit rentals synchronization: When unit rentals are updated in Storeganise (e.g., during a move-in or move-out), this information is automatically pushed to Storlogix.
• PTI Default Zone: Ensures time zone configurations are accurately synced across systems.

Syncing with Storlogix system

Storeganise integrates directly with Storlogix, PTI's backend management portal, to ensure that all actions related to unit rentals are reflected accurately in the PTI system.

• Real-time Synchronization: Storeganise acts as the ‘source of truth,’ so in most cases, you should make updates in Storeganise, not in Storlogix.
• Access Management: Storeganise handles customer move-ins by creating access codes, which are synced with Storlogix.
• Lock Status Updates: Storeganise automates locking and unlocking units based on payment status.
• Unit Status Check: Log in to Storlogix to manually verify the state of a unit or an access code.

Configuring PTI zones in Storeganise

Example of how PTI zones is set up in Storlogix:

You can manage access permissions using PTI zones. Here's how to configure the default PTI zone and override it for specific users.

Default PTI zone configuration

Global Add-on or Site Add-on:

• Go to Sites > Add-ons > PTI to edit the Add-on settings
• Configure the default PTI zone, which is typically used for all customers. This sets the base level of access for users. (example below: PTI Default Access Area set to 8  )

You can override the default PTI zone at the user level. For instance, if you want to grant a staff member access to a different zone, you can do this by going to the user custom field.

E.g. If a user is a staff member and needs unrestricted access:

1. Go to Users > [User] > Custom fields
2. Set the PTI Access Level field to 1  .

Synchronizing units and users

Move-ins and move-outs

• From the Customer Portal: Storeganise generates an access code for the customer, which is then synced with PTI.
• From the Management Portal: Schedule and complete a move-in, and Storeganise will communicate with PTI to create an access code. Verify the access code in PTI.

Handling unit name conflicts

• If a unit’s name exceeds 10 characters, PTI sets the unit name to NONE . Tasks will appear in Storeganise to prompt renaming the unit to fit within PTI’s limitations. After renaming, clear the task and retry synchronization.
• Units not found in PTI during move-in will automatically be created, provided the name fits the character limit.

Access code synchronization

• After the move-in, check your PTI account to ensure the access code matches the one generated in Storeganise.
• For move-outs, Storeganise will remove the access from PTI, making the unit available again.

Managing access

• Access Codes: Automatically generated and synced during new rentals.
• Overlocking Units: Automatically locks units for overdue payments.
• Resynchronizing Data: Manually trigger a synchronization from the unit rental page.

Overriding unit names

• Special units can have custom names set in Storeganise that differ from their PTI unit names by using the PTI Unit Name field. If no override is set, the default Storeganise unit name is used.

Multiple units for a customer

If a customer rents multiple units, Storeganise checks for existing unit rentals and assigns the same access code for all units under that customer.

Suspend units

Storeganise can automatically suspend access to units within PTI when invoices become overdue. You can also manually suspend or unsuspend access for specific units.

Resync data

Manually trigger a resynchronization of data from Storeganise to PTI in case of any discrepancies.

Generate new access codes

Storeganise allows you to generate new access codes for customers, which can be essential in ensuring your customers have the correct access.

Adjust customer access level

You can override the default access level for customers within PTI, tailoring access to individual users. This change may require a resynchronization to update PTI.

Move-out process

When a customer moves out, schedule the move-out in Storeganise, marking the unit as available. This process automatically removes access to that unit within PTI.

Troubleshooting common issues

Webhook errors

• Ensure that only one instance of the PTI Add-on is active for the site. Multiple instances can lead to conflicts.

Synchronization issues

• Verify that unit names and Add-on fields in Storeganise match those in PTI.
• For units with names exceeding 10 characters, rename them within Storeganise to fit PTI’s limitations and retry synchronization.

Checking PTI status

• Log in to Storlogix with your credentials and search by unit to confirm if changes are applied correctly.

Testing and verification

To test the integration:

1. Use a testing environment to simulate potential errors.
2. Make changes in Storeganise (e.g., moving a customer out) and verify in Storlogix.
3. Always ensure that only one PTI Add-on is active per site to avoid errors.

Legacy - Migration from previous integration

1. Configure units and zones
   • Use the PTI unit name field in Storeganise to match each unit with its corresponding name in PTI.
   • If a unit name in Storeganise must be different from the one in Storlogix, you can set the unit’s PTI ID to the name in Storlogix. This will override the ‘default’ Storeganise unit name so that syncing can still work.
   • Set the Default PTI zone for each site in the PTI Add-on settings. This default zone will apply to all units unless overridden.

Further assistance

If you need more help setting up or troubleshooting PTI integration, feel free to contact our support team at support@storeganise.com. You can also explore our help docs for more detailed information and updates.