Enabling the MoneyGuide Integration

Overview

Our integration with MoneyGuide enables Advisors to open a corresponding Client record in MoneyGuide. It uses a connection method to send a request from Practifi to open a Client record. If a corresponding Client record is not found in MoneyGuide, the system will call Practifi to extract the Client and Member details and create the new record. If a record is found, the My Plans page for the Client is opened. 

This integration is complex to enable within your organization, and a Practifi Customer Support Engineer will perform the enablement process. This article outlines the enablement process of the MoneyGuide integration in your organization and the information that needs to be provided to ensure a smooth activation process. For more information about the MoneyGuide integration, please consult our Using the MoneyGuide Integration article.

• Integration Information
• Installation Steps
• Data Field Mapping

Integration Information

Our integration with MoneyGuide enables Advisors to open a corresponding Client record in MoneyGuide. If the Client and its Members do not yet exist in MoneyGuide, the record is created immediately in MoneyGuide. Any updates made in Practifi to Client and Member details are synced back to MoneyGuide. However, updates made in MoneyGuide to Client and Members are not synced back into Practifi. By design, Practifi is intended to be the source of truth for Client and Member detail information. The creation and review of Financial Plans are performed solely within MoneyGuide. 

Installation Steps

Practifi Customer Support will liaise with the customer and the team at MoneyGuide to activate the integration in the customer's system. This exchange will involve the allocation of a MoneyGuide CustomerID, nominating a user account by the customer who will be used to pre-approve connections between Practifi and MoneyGuide, and the full Salesforce system path by which MoneyGuide will communicate with the customer's Practifi system.  

Broadly, the remaining steps involved are:

1. Verify that the customer Practifi system is compatible with the current version of the MoneyGuide integration.
2. Enable the My Domain setting on the customer system if not already enabled.
3. Import the MoneyGuide JKS certificate issued to Practifi.
4. Create a new Connected App within the customer system for connecting with MoneyGuide, and add a series of custom attributes to the App definition. Ensure the Practifi Customer Permissions are allocated to the MoneyGuide App.
5. Set up an App to allow MoneyGuide to call the Practifi API.
6. Load the public certificate provided by MoneyGuide to support the authentication MoneyGuide requires.
7. Set up an OAuth 2.0 provider and provide the "Callback URL" by which Practifi initiates contact with MoneyGuide.
8. Add a new field to identify the user calling on MoneyGuide to be identified to MoneyGuide.
9. Update Practifi's settings to include the linkage configuration created in these earlier steps.
10. Apply MoneyGuide user access permissions to every user accessing the system.
11. Modify the Household account page to include the Link to MoneyGuide link.

Data Field Mapping

The data passed from Practifi to MoneyGuide comprise key details from the following. Detailed and personally sensitive information, like Date of Birth, is not passed and needs to be entered directly into MoneyGuide as part of its Client record.

1. Primary Contact
2. Partner Contact
3. Dependents
4. Addresses
5. Assets
6. Holdings within Assets
7. Liabilities

Any updates in Practifi to the Client, Contact or Financial record data are reflected in MoneyGuide. Updates made to the information in MoneyGuide are not passed back into Practifi.