Xplan is a comprehensive financial planning and wealth management software program, designed for practices of any size. It helps to reduce administration, maximise your business opportunities and deliver high-impact financial advice.
FYI and Xplan integrate so you can import your critical financial documents into FYI to file.
Overview of the Xplan Integration
When Xplan is integrated with FYI, you have access to features such as the following:
- Automatically import critical financial documents from Xplan overnight into FYI
- Match clients between systems to automatically file documents (using a Client Custom Field in FYI)
- Import only the selected Document Types for complete control
Note: All clients are synchronised, there is no option to exclude clients if the Client Custom Field is blank.
This integration is available to all users on an FYI Pro Plan, and you must hold an active account with Xplan. Refer to Join the Xplan Beta.
Join the Xplan Beta
Ready to get started? Contact us now at email@example.com and request to be added to the Xplan Beta. Our team will let you know the next steps and help you get underway.
Create Matching Client Codes in Xplan and FYI
To automatically file documents against a client, you will need to have a matching code for each client in both Xplan and FYI (using a Client Custom Field in FYI). Otherwise, the document will be imported and added to the In Tray, rather than being filed against the client.
Note: All clients are synchronised - there is no option to exclude clients if the Client Custom Field is blank.
Step 1 - Update the Client in Xplan
To start with, select which of the Xplan Properties you'll be using. For example, the "External Identifier" field in Xplan.
Ensure the client in Xplan has been updated with a unique code in the field you select. For example, if using the External Identifier field in Xplan, we would enter code "284892". Any code can be used, as long as it's not used by any other client.
Step 2 - Create a matching Custom Field in FYI
You will need to create a Client Custom Field in FYI used to enter the same unique code created in Step 1.
Note: We recommend creating a new Custom Field called "Xplan ID", to make the purpose of the field easily identifiable.
For instructions on creating Custom Fields, refer to Managing Custom Fields.
Step 3 - Update the Custom Field for Clients in FYI
Once the Custom Field has been created you will need to update the Client records in FYI to insert the code matching their account in Xplan. Refer to the "Editing Client Custom Fields" section in the article Client Custom Fields.
Once you have confirmed you have updated the matching fields in both systems, you'll be able to configure the matching in the Xplan App settings in FYI.
Connecting Xplan to FYI
- In FYI, click the Automation menu option.
- Go to the Apps tab.
- Locate the Xplan app, and click the cog icon to access the settings.
- Enter the Site URL for Xplan and click Connect.
- You will be prompted to log into Xplan.
- Enter a Username and Password.
- Click Login.
- You may be prompted to enter your login details a second time. If you see this message, it's just a warning about a duplicate account, and you're likely already logged into Xplan in another window. Enter your details again and click Login.
- Click Allow to connect FYI with Xplan.
- Once the connection is complete you will be returned to the Xplan App settings in FYI. A red "Disconnect" button will now be displayed. You will also be able to see the account and the Authorised User.
The Xplan integration allows you to configure a number of options to ensure the most efficient processing of imported documents.
Read below for information on how to configure these options.
Match Clients via
Select the fields used in Xplan and FYI to match clients as per the section Create Matching Client Codes in Xplan and FYI above.
When documents are imported, auto-filing will occur depending on whether a matching client can be found, and if there are duplicate codes for the fields selected in the Match Clients via section i.e. the same External Identifier is used for more than one client.
|Condition||Document Imported||Filed against Client|
|No matching client found|
|One matching client found|
|Duplicate matching clients found|
If a duplicate has been detected the integration will be unable to determine the correct client. The document will still be imported, but rather than auto-filed, it will be added to the In Tray of the user who connected the integration. Refer to Managing your In Tray for information on how to process the document.
Reminder: You can share your In Tray with other users if you need to delegate unfiled documents, or particularly useful if you'll be away for an extended period of time. Refer to Sharing your In Tray.
Document Types to Import
You can select which Document Types you would like to import into FYI. Types are displayed in a hierarchy, with Types and Sub-Types displayed.
- To select a Document Type click the minus (-) icon for the Type to select all Sub-Types, or alternatively, just click the minus (-) icon for specific Sub-Types only.
- To deselect a Document Type click the tick icon. It will change back to a minus icon, and documents with that Document Type will not be imported.
Once imported, documents will be filed against the Cabinet selected in the Automation Process specified in the Xplan Import Automation Process (covered further below).
Where any Documents have attachments included, these attachments will be included in the import.
Activate the Xplan Import Automation Process
A new Automation Process will be available for Xplan, created automatically. This process runs every 24 hours nightly. Before documents can be imported you will need to activate the Automation.
- In FYI click the Automation menu.
- On the Processes tab locate the Xplan Documents process and click on the cog icon.
- The fields and steps will be automatically populated.
- Update the step if required, for example, to change the Cabinet the documents are filed against.
Note: All documents will be imported to the same Cabinet.
- Click the Status Draft toggle to activate the automation.
- The Automation will become active, and the first documents will begin synchronising overnight.