Enabling the eMoney Integration

Learning Team

Please note: This content is intended for Practifi System Administrators and is technical in nature. The steps described in this article may not be able to be completed without System Administrator permissions. Please discuss your integration installation plans with your Practifi Customer Support Team for their assistance.

Overview

Our integration with eMoney allows Advisors to create Client and Member records in eMoney and open Plans (Scenarios and What-Ifs) from within Practifi for viewing and updating in eMoney.

Before You Begin
Enablement
Data Field Mapping

Before You Begin

eMoney provides a guide on setting up their system to connect data to external systems like Practifi. Some steps require the involvement of eMoney representatives for key setup information and technical requirements regarding the signing of JWT certificates. The guide is available here, and we recommend reading it first.

As part of the certificate setup process, eMoney will send back two Client IDs, one for Test and another for Production, and a single API key.

To complete this installation, the following information will be needed:

Two X509 authentication certificates, one for Production and another for a Test system
Client ID from eMoney as part of the certificate approval process and entered as part of the Auth Provider setup.
API Key for EMoney Integration Settings from eMoney that was entered as part of the custom settings for this integration.

Enablement

The installation steps cover the following areas:

Request and Install the eMoney Certificate
Create Remote Site settings
Create the Auth Provider
Create the Named Credential
Configure eMoney Integration Settings
Update Practifi Trigger Settings
Add new Picklist Value
Add Links, Tab, and Panel to the UI
Mapping of Practifi Users to eMoney User Logins (if necessary)
Schedule Data Sync Job

Request and Install the eMoney Certificate

eMoney has a guide here for requesting certificates. Note, in particular, the choices of Certification Authorities that are acceptable to eMoney for this purpose. Using the steps provided by Salesforce, create a CA-Signed certificate, download the certificate signing request and apply for a signing request through a Certificate Authority (CA). Practifi recommends sending the certificate signing request through DigiCert.

Once the CA authority sends back the signed certificate, from Salesforce Setup, go to Certificate and Key Management, click the certificate name (The CA-Signed certificate you created earlier), then click Upload Signed Certificate.

Click Browse to locate the CA-signed certificate. The CA-signed certificate must match the certificate created in Salesforce. If you try to upload a different CA-signed certificate, the upload fails.

Click Save to finish the upload process. Click Cancel at any time not to upload the certificate.

Create Remote Site Settings

Two Remote Site settings are required for each system, Test or Production. Note for which system the Remote Sites are being created when entering the URL information:

emoney_api
emoney_auth

To create these, locate the Remote Site Settings configuration panel in Salesforce and click New Remote Site

emoney_api

This is the remote site for the API call servicing endpoints.

Supply the following:

Remote Site Name: emoney_api
Remote Site URL:
- Test: https://api-externalbeta2.emaplan.com/
- Production: https://api.emoneyadvisor.com
Active: ticked

emoney_auth

This is the remote site for API authentication calls.

Supply the following:

Remote Site Name: emoney_auth
Remote Site URL:
- Test: https://signin-externalbeta2.emaplan.com/connect/token
- Production: https://signin.emaplan.com/connect/token
Active: Ticked

After completing these steps, the following Remote Sites should appear.

Create the Auth Provider

One Auth Provider is required between the customer's Practifi system and eMoney. Locate the Auth. Providers configuration panel in Salesforce, and click New.

Select EMoneyAuthProvider as the Provider Type. This type is added to the list as part of the Practifi installation.

A new panel appears on which additional fields need to be completed.

Supply the following. Note the system is being set up, Test or Production, when entering the URLs:

Name: emoney
URL Suffix: emoney (default)
Certificate: eMoneyCert (as uploaded above under 1. Request and Install eMoney Certificate step, above)
NOTE: This is a case-sensitive field, please verify the name of the uploaded certificate.
Client ID: Supplied by eMoney as part of certificate approval process, one for Test and another for Production systems
Developer Name: emoney
Scope: API
Token Endpoint:
- Test: https://signin-externalbeta2.emaplan.com/connect/token
- Production: https://signin.emaplan.com/connect/token
Execute As: Any active user on the Customer system

On clicking Save the following new Auth Provider will have been created.

Create the Named Credential

One Named Credential is required between the customer's Practifi system and eMoney. Locate the Named Credentials configuration panels in Salesforce and click New Named Credential.

Supply the following. Note the system is being set up, Test or Production, when entering the URLs:

Label: emoney
Name: emoney
URL:
- Test: https://api-externalbeta2.emaplan.com/
- Production: https://api.emoneyadvisor.com
Identity Type: Named Principal
Authentication Protocol: OAuth 2.0
Authentication Provider: emoney (set up in the Auth. Provider step, above)
Scope: API
Start Authentication Flow on Save: Ticked
Generate Authorization Header: Ticked

On clicking Save, the systems will begin authentication with each other as a once-off step, and the Authentication Status field will change to read Authenticated.

Configure eMoney Integration Settings

Locate the Custom Settings configuration panel in Salesforce and click New.

Locate the EMoney Integration Setting row, and click Manage.

Review the following, adjust the settings as needed, then click Save:

NOTE: These settings should be implemented as listed here. The level of detail provided by these settings aids in diagnosing problems, where the system behavior can be temporarily modified to check for a particular condition that may be causing a problem.

Field	Value	Purpose
API Key		Supplied by Emoney
API Version	v1	Identify the API version in use
Auto Map Client	Ticked	If enabled, auto map clients between eMoney and Practifi by a common email address between the eMoney client and the Primary Contact. That is, the Primary Contact represents the eMoney client.
Auto Map User *	Ticked	If enabled, auto map clients between eMoney and Practifi by their common email addresses
Create New Batch Size	Blank	For troubleshooting only
Create New	Ticked	If enabled, allows creation of a new Practifi client based on eMoney client. This setting is necessary for the Create Client tickbox feature under Data Management > EMoney Clients to function.
Default User Id *	Blank	This field is used for mapping of many Practifi client owners to one eMoney owner. The one (and only) eMoney user is mapped to all Practifi advisors. If this field is completed with an eMoney userid, that userid will be used to create and new Clients and become the owner in eMoney. *
EMoney As Source Of Truth	Ticked	If enabled, eMoney data values will become the initial client information from eMoney to Practifi after linking an existing Practifi Client with an eMoney client. If disabled, the existing Practifi Client values will overwrite the existing eMoney values when linking an existing Practifi Client with an eMoney client.
Enabled	Ticked	If disabled, all eMoney features will be disabled, and the eMoney button in the client headers will be hidden
Get Clients Page Size	Blank	For troubleshooting only
Link Clients Batch Size	Blank	For troubleshooting only
Link Clients	Ticked	If enabled, allows mapping of an existing client in Practifi with an eMoney Client. This setting is required to allow linking of existing Practifi and eMoney clients using the Data Management > EMoney Clients page.
Named Credentials	emoney	Set up in Named Credentials step 4, above
Patch Client Batch Size	Blank	For troubleshooting only
Patch Clients	Ticked	If enabled, automatically update clients information in eMoney if any client information is changed in Practifi (ie allows the triggers to function)
Pull Clients Batch Size	Blank	For troubleshooting only
Push Clients Batch Size	Blank	For troubleshooting only
Push Clients	Ticked	If enabled, allows client information to be pushed from Practifi to eMoney. This setting is required to enable the Send to EMoney button to function on the Practifi Client record.
Show Exception in Batchable	Blank	For troubleshooting only, default should set to blank
Sync Clients Batch Size	Blank	For troubleshooting only
Sync Clients	Ticked	If enabled, allow syncing clients between eMoney and Practifi. This setting is necessary to allow the update triggers, and overnight sync jobs, to function.
Sync From EMoney	Ticked	If enabled, allows syncing of data from eMoney to Practifi. This setting is required to enable the Sync from EMoney button to function on the Practifi Client record.
Sync Owner From EMoney *	Ticked	If enabled, allow sync of Advisor owner of clients from eMoney to Practifi (ie Practifi client owner is updated to match eMoney owner). Disable this setting if one-to-many User mapping is in effect (see section 9 below)
Sync Owner To EMoney *	Ticked	If enabled, allow sync of Advisor owner of clients from Practifi to eMoney (ie eMoney client owner is updated to match Practifi owner). Disable this setting if one-to-many User mapping is in effect (see section 9 below)
Sync Plans Batch Size	Blank	For troubleshooting only
Sync Plans	Blank	If enabled, allows sync of Plans from eMoney to Practifi (as Advices). Plans are never initiated in Practifi.
Sync To EMoney	Ticked	If enabled, allow syncing client data to eMoney. This setting is required to enable the update triggers to function.
Unlink Clients Batch Size	Blank	For troubleshooting only
Unlink Clients	Ticked	If enabled, when Unlinking a client in Practifi from an eMoney client, the Advices under the client in Practifi will be deleted. Plans in eMoney are not altered.
Verbose Logging	Blank	For troubleshooting only, by default should set to blank

* See Mapping of Practifi Users to eMoney User Logins, below, for the settings to apply here.

Click Save to update the fields.

Update Practifi Trigger Settings

Return to the Custom Settings configuration panel in Salesforce, locate the Practifi Trigger Settings row and click Manage.

Supply the following relating to eMoney, then click Save:

EMoney Client: Ticked
EMoney User: Ticked

Add New Picklist Value

Add a new Picklist Value of Emoney to the list of Planning Systems from which plans may be sourced. Without this value, eMoney plans won't be retrieved into Practifi.

Within Salesforce Setup > Object Manager, locate the Plan object.

Click on the label Plan, then the Fields & Relationships link, and locate the Planning System field. Click on the Planning System label.

Click New and add the value Emoney (note the spelling here) to the list of picklist values.

Add Links, Tab and Panel to the UI

This step requires assistance from the Practifi Customer Support team to install some screen updates to show the eMoney Integration information to the user. The steps are essentially:

A new table to list and enable linking eMoney Clients with their corresponding Practifi Clients.
A new table to list and enable linking eMoney Users with corresponding Practifi Users.
Adding a new link option on the Client record for a Send to eMoney function.
A new section on the Client record to show Financial Advice and an eMoney Financial Plans subtab.

For steps 1, 2 & 3:

Assign the Practifi - eMoney User permission sets to the users who need access to the eMoney Integration. Go to Salesforce Setup, search and click Permission Sets. Now click Practifi - eMoney User. This row will already be present.

Click Manage Assignments, and click Add Assignment.

Select Users and click Assign.

Step 4 involves manually adding the eMoney Financial Plans tab:

Go to Salesforce Setup,click Object Manager and search Entity. Click Entity.

Select the Lightning Record Pages tab and click Practifi - Client Record Page.

Click Clone.

NOTE: Rename the cloned page to differentiate it from other Practifi pages. Suggested Label - "Practifi - Client Record Page - Integrations" & Developer Name "Client_Record_Page_Integrations".

Go to the Financial Advice section and add a new tab "eMoney Financial Plans" and remove the pre-existing Envestnet Proposals tab if you are not using the Envestnet integration.
Now hold and drop the "Practifi - Datatable (Record Page)" component under the eMoney Financial Plans tab.

Now in the Config Name, enter "Related - Emoney Financial Plans" and click Save.

Activate the new page based on App, Record Type, and Profile. Click Activate and select App, Record Type, and Profile. Click Add Assignments.

Select all the Practifi Apps Advisor, Client Service, Management, Marketing, Settings, and Team Member. Click Next.

Select all the Client Record Types Household Client, Individual Client, and Organization Client. Click Next.
Now select all the Practifi profiles (Advisor, Client Service, Management, Marketing, Settings, and Team Member), Standard User, and System Administrator profiles. review Assignments and click Save.

Mapping of Practifi Users to eMoney User Logins (If Necessary)

Flexibility to determine whether a single eMoney user login is used by all Practifi users, or whether each Practifi user has their own eMoney login, is supported by the eMoney Users tab of the Integrations App tab in Practifi, and key settings under the eMoney Integration Settings in section 4, above.

Requirement	Settings
Each Practifi User has a unique login to eMoney, matched by a common email address	Auto Map User - Ticked Default UserID - Blank
Each Practifi User has a login to eMoney, but with a different email address	Auto Map User - Unticked Default UserID - Unticked Use the eMoney Users tab to manually select the Practifi User to match its eMoney User (see Updating of User Mapping, below)
A single eMoney User login is to be used across all Practifi Users	Auto Map User - Unticked Default UserID - Common eMoney UserID Sync Owner from EMoney - Unticked Sync Owner from Practifi - Unticked

An eMoney User can only be linked to one Practifi user. The list of eMoney Advisor usernames may be refreshed with the Sync eMoney Users button.

Where an eMoney Advisor login does not have a corresponding Practifi User login, start by clicking on the dropdown arrow icon, clicking the Edit link, and entering part of the Practifi User login name required in the User field. Select the name required, and click Save.

Schedule Sync Job

A synch job to carry changes made in eMoney to linked Clients in Practifi should be scheduled to run at intervals as required by the firm's users. Perform this at least once per day.

In Salesforce, go to the user’s dropdown and select Developer Console.

Under Debug, open an Open Execute Anonymous Window

Paste the following fragment of code into the window and Execute.

// Create schedule job to sync client information from eMoney to Practifi at 2am every day.

practifi.EMoneyInvocable emoney = new practifi.EMoneyInvocable('syncClients');
String sch = '00 00 02 * * ?';
String jobID = System.schedule('eMoney Sync clients', sch, emoney);

See the Salesforce document here on how to configure scheduled times.

Data Field Mapping

The following data field mapping takes place between Practifi and eMoney. The key point to remember is that elements from the Practifi representations of a Household and its two key Members, appear in particular locations in the eMoney representation.

Practifi

eMoney

Household

Primary Contact

Partner Contact

Client Account Address from Primary Contact

Client

Spouse

The detailed mapping is as follows:

Practifi		eMoney
Primary Contact	FirstName	Client	firstName
	LastName		lastName
	BirthDate		dateOfBirth
	Sex__c		gender
	General_Health_c		inGoodHealth
	Country_Of_Citizenship__c		citizenship
	Email		email
	MobilePhone		cellPhone
	Employer__c		Job.companyName
	Occupation__c		jobTitle
	Work_Email__c		job.businessEmail
	Phone		job.businessPhone
	Fax		job.businessFax
Partner Contact	FirstName	Spouse	firstName
	LastName		lastName
	Birthdate		dateOfBirth
	Sex__c		gender
	General_Health__c		inGoodHealth
	Country_Of_Citizenship__c		citizenship
	Email		email
	MobilePhone		cellPhone
	Employer__c		Job.companyName
	Occupation__c		jobTitle
	Work_Email__c		job.businessEmail
	Phone		job.businessPhone
	Fax		job.businessFax
Account	ShippingAddress	Client Account	address1
	ShippingCity		city
	ShippingState		state
	ShippingPostalCode		postalCode
Primary Contact	Phone		homePhone
	Fax		fax
	Marital_Status__c		maritalStatus
	User Mapping		ownerId

LIMITATION: At present only the Primary and Partner Contacts are passed and updated in Practifi and eMoney. Dependents and other entities are not supported yet.

Updates FROM Practifi TO eMoney take place immediately upon Saving an update in Practifi
Updates FROM eMoney TO Practifi take place:
- On clicking Sync from EMoney button on Practifi Client record, and
- Completion of scheduled sync job