If you need to reset the connection between FYI and Xero Practice Manager, first take into consideration the following factors about the user who resets the connection:
- The user should be a long-term user of FYI and Xero Practice Manager and FYI into the future as the connection is dependent on their active status in both Xero Practice Manager and FYI.
- The user needs to have 3rd party application rights assigned. They must have Full API Access Privileges - Authorise 3rd Party Access enabled in Xero Practice Manager. If they do not, an error displays. Refer to "You don't have access to connect to any Xero Practice Manager Accounts” when connecting FYI to XPM.
Note: This access only needs to be set for the Xero Administrator connecting FYI to Xero Practice Manager or Xero Tax, and is not needed for other users.
- User must be an FYI Admin.
- User must have Administrator access in Xero Practice Manager.
Important note: If you have more than one account for Xero practice Manager (such as for branches in different cities) when the user is connecting FYI they need to ensure that they are connecting to the correct Xero Practice Manager when prompted by Xero to authorise the connection. Connecting to the wrong account will cause the wrong data to sync and it will be difficult to correct.
Resetting the Connection for Xero Integration
- Login to FYI as an FYI Admin who is also a Xero Practice Manager Administrator, with Authorise 3rd party Full Access enabled.
- From FYI, click the Automation menu option.
- Go to the Apps tab.
- In the Xero Practice Manager app, click the cog icon to edit it.
The Xero Practice Manager Settings displays.
Maintain Jobs in FYI
Maintain Jobs in FYI is set as default to "Off"
When Maintain Jobs in FYI is set as "On", the Sync button is not available in the Jobs list and in the Client - Jobs tab in the Client workspace. This disables the option for users to manually Sync Jobs and ensures that any changes made to Jobs in FYI, such as the Job State, are not updated back to the original state in Xero Practice Manager if a manual Job Sync is requested before the change in FYI has been updated to Xero Practice Manager.
Sync Custom Fields From XPM
When Sync Custom Fields From XPM option is set to "On", any changes made in Xero Practice Manager to the Custom Fields values for a Client or Job, or to the definitions, will still sync to FYI overnight
The overnight sync of Custom Fields to FYI can be disabled by setting the Sync Custom Fields From XPM option to "Off". When this is disabled, Client and Job Custom Fields are maintained in FYI and synced to Xero Practice Manager. The Sync from PM can still be used to sync the values for Custom Fields selected for the specific Client or specific Job from Xero Practice Manager to FYI. Refer to Managing Custom Fields, Client Custom Fields and Job Custom Fields.
Maintain Invoices in FYI
This is for a future release and should be set as "Off".
To Reset the Connection
- Click Reconnect XPM and you will be prompted to login to Xero.
- Enter your login details. This must be a Xero Practice Manager Administrator account.
Click Log in.
- Follow the prompts for any verification or to answer your security questions.
You are then prompted to allow access to FYI
- Click Allow access.
Note: If your Xero login has access to more than one Xero practice, you are prompted to select which one you wish to connect to FYI. Ensure you are connecting to the correct Xero Practice Manager.
- Perform a manual sync of Jobs, Clients, Staff and Xero Tax Returns. Refer to Running a Manual Sync with Xero Practice Manager and Additional Notes on Syncing.
Important Note: After resetting the connection, if the Xero Administrator account who made the connection needs to be made inactive or deleted, please first contact the FYI Support Team at email@example.com.