Upgrading your Xero PM to Nimbus connection
As a result of a recent security upgrade implemented by Xero, all Xero app partners connecting to Xero Practice Manager, WorkflowMax and Xero SME have to comply with the new security standard by 30 September 2020.
The library which allows Nimbus to pull information from your XPM account has recently been upgraded by Xero (this is the Xero API library for all 3rd party providers).
This means that the way your Nimbus account connects to your XPM account will change.
To assist with this change, the connection between your Xero account and Nimbus must be upgraded before the 30th of September, 2020.
Note: as part of the upgrade, Xero requires that Two Factor Authentication (2FA) be enforced for ALL STAFF. This will be switched on automatically during the upgrade if not already enabled. When a staff member logs in to their Nimbus account, the 2FA pin will be sent via SMS. If there is no mobile number entered against the Employee profile, it will be sent via email. 2FA is required for both the Nimbus web browser login and login via the CDM AddIns.
The following article explains the steps involved in upgrading the connection between your XPM account and Nimbus.
Watch the Video
Overview of steps involved:
Enable your XPM Staff API access privileges via your XPM account
Ensure NO STAFF are modifying your XPM account
Upgrade your XPM to Nimbus connection
1. Enable your XPM Staff API access privileges
When you connect your Nimbus account to XPM, a staff member will be required to login to XPM and confirm the connection.
Prior to connection, this staff member MUST authorise 3rd Party Full Access within their XPM account. To do this, please perform the following:
Login to your XPM account
Via the Business tab, select Settings
Under Practice Settings, click Staff
Select the Staff Member whose XPM Login credentials will be used to connect Nimbus with your XPM account
Scroll to the bottom of the page and locate the API Access Privileges section
Ensure the Full option is enabled. The following will display:
Click the Save button to save your changes.
2. Ensure no staff are modifying your XPM account
It is VITAL that staff are not modifying data within your XPM account whilst the Nimbus connection upgrade is taking place. If necessary, please ask ALL STAFF to logout of XPM prior to the upgrade. Depending on the number of Client Entities you are syncing from XPM to Nimbus, the upgrade process may take over 1 hour.
3. Upgrading your XPM to Nimbus connection
Before proceeding ensure you have the XPM login credentials for the Staff Member who has been granted Authorise 3rd Party Full Access within your XPM account AND ensure all staff are logged out of XPM.
Login to your Nimbus account with Admin access
Select Admin / AutoMate
Click the Perform Upgrade button
The system will display a warning relating to item 1.6 above. Please ensure you have performed step 1.6 before proceeding.
If the staff member who has been granted API Access privileges is NOT logged into your XPM account, they will be asked to login via the following screen. If they are logged in, the system will jump to point 6 below.
NOTE: After clicking Yes to the question “Have you enabled your full API Access Privileges” your browser’s Pop-up blocker might prevent the Xero/WFM login page to launch. If the Xero/WFM login page does not open at this point, please check and allow your browser pop-ups as follows:
NOTE: If your browser settings blocked the Xero login dialog to pop-up, you will need to wait 5 mins for the Perform Upgrade button to re-display:
The system will then display the following screen requesting you to confirm the XPM account your Nimbus account will connect to:
To proceed with the upgrade, click the Allow access button.
Note, if you fail to click the Allow access button (i.e., you click the Cancel button instead), your Nimbus connection will NOT be upgraded and you must refer to step 3 above.
The system will now display the progress of the upgrade. This information is displayed above the ServerGate buttons as shown below:
When the upgrade is complete, the system will then display the XPM connection and will allow you to again perform a Manual, or a Full Client Sync at any time.
After you have upgraded the connection to your Xero Account
The change in the library which allows Nimbus to pull information from your XPM account has also changed the Client Code reference in Nimbus.
Prior to the upgrade, Client Entities in XPM which did NOT have a defined Client Code, would display in Nimbus as follows:
After the upgrade, these same Client Entities will display in Nimbus as follows:
If your Business does not use Client Codes, you can simply remove the field from the Client Grid as follows:
Option to remove the Client Code from the Document menu Folder list
Nimbus provides an option to customise the display of the Document menu Folder list. This may be changed to simply just display the Client Name as follows:
If your business requires this change, please submit a support ticket via the Nimbus Service Desk and one of our consultants will contact you to discuss the change.