Enabling the Schwab (OpenView Gateway) App Integration

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 

The Schwab Advisor Enrollment and Digital Account Opening (DAO) enhancement to Practifi allows customers who use Schwab for custodial services to initiate Schwab account opening processes for their clients directly from Practifi. Organizations with this integration enabled can transfer contacts from Practifi Client records to Schwab, open the Digital Account Opening (DAO) wizard from within Practifi and monitor alerts received from Schwab, particularly those relating to account opening.

In setting up this integration, you might be asked about Practifi's underlying infrastructure. As an OEM Partner of Salesforce, Practifi is built on the Force.com platform with Enterprise Edition licensing.

This article outlines the steps to enable the Schwab (OpenView Gateway) App integration in your organization. For more information about the Schwab (OpenView Gateway) App integration, please consult our Using the Schwab OpenView Gateway Integration article.

• Schwab Documentation
• Installation
  • Installing from the AppExchange
  • Configuring the OpenView Gateway App
    • Remote Site Settings
    • Configure Firm Details
    • Configure Data Download Details
    • Enroll the Download ID
    • Enroll Schwab Advisor Center IDs
  • Configuring New Objects
    • Adding the Entity (Household) Object to the Gateway Assignments Object
    • Adding Custom Buttons and Links
  • Completing Setup and Initial Mapping

Schwab Documentation

The source of truth for the installation and usage of the Schwab OpenView Gateway Salesforce App is the official Schwab documentation, which can be accessed in the following ways:

• In the Schwab Service Guide under Tools and Administration, select How to get started in Schwab OpenView® Gateway for Salesforce (schwabinstitutional.com).

• Via the Help for this Section links in these areas:

  • On the OpenView Gateway tab in Setup
    
    
    
    

  • On the Digital Account Open screen
    
    
    
    

  • On the Digital Address Change screen
    
    
    
    

  • On the Firm Set Up Detail Screen
    
    
    
    

Installation

Installing from the AppExchange

Please note: The below steps must be completed with the help of Schwab’s Salesforce Support team. 

The Schwab OpenView Gateway app must be installed from Salesforce's AppExchange to begin the installation process. To install the Schwab OpenView Gateway app from the Salesforce AppExchange:

1. Log into your Practifi organization using your System Administrator credentials.
2. Navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented by) and selecting Setup from the drop-down menu. 
   
   
3. Use the Global Search bar at the top of the screen to search for and select AppExchange Marketplace.
   
   
   
   
4. Within the AppExchange Marketplace, search for Schwab Advisor Center Integration for Salesforce and select the Schwab Advisor Center Integration for Salesforce app from the results.
5. On the app's listing, select the Get It Now button at the bottom of the screen.
6. A pop-up window will open, prompting you to log into your AppExchange account. Select the Open Login Screen button.
   
   
   
   
7. Enter the requested information, taking care to enter all information into the required fields indicated with a red asterisk. When these details are verified, Schwab will provide an installation link for the AppExchange Application.
   
   

Configuring the OpenView Gateway App

Please note: Clients will complete the following steps with the help of their Practifi Implementation Consultant or Client Solution Engineer.

To configure the Schwab OpenView Gateway app:

1. After installing the app from the AppExchange, navigate back to Practifi.
2. Select the App Launcher in the upper left-hand corner.
3. Use the Search apps and items search bar to search for OpenView Gateway and select this option from the search results.
   
   
   
   
4. When launching the OpenView Gateway app for the first time, you will be prompted to configure remote site settings. Accept the prompt to open a new tab.

Remote Site Settings

1. From the new tab, navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented by) and selecting Setup from the drop-down menu. 
   
   
   
   
2. Within Salesforce Setup, use the Quick Find search bar on the left-hand side to search for and select Remote Site Settings.
   
   

To configure remote site settings:

1. Select the New Remote Site button.

2. On the Remote Site Edit page, enter the following settings for the new remote site:

   • Remote Site Name - RemoteSiteSelf1

   • Remote Site URL - Copy the URL from the current tab 

   • Active - Checked

To add another remote site:

1. Select the Save & New button.
2. Enter the following settings for the second remote site:
   • Remote Site Name - RemoteSiteSelf2
   • Remote Site URL - Copy the URL from the current tab
   • Active - Checked
3. Click Save.

Once created, close the Remote Site Settings browser tab and return to the previous browser tab. Select Click Here to continue the setup.

• Please note: If selecting Click Here does not work, navigate to the Openview Gateway app using the AppLauncher to continue.

Configure Firm Details

The following section offers guidance on setting up firm details in the OpenView Gateway app. To fill out the Firm Details page, please refer to the following table:

Setting	Description
1:Many (most common) or 1:1	This setting determines how the objects are mapped for synchronization. 1:Many indicates a household setup (client A with Gateway Accounts 1, 2, 3, and 4). 1:1 indicates a household setup where each account is repeated, so client A appears in your system with each account: Client A1, Client A2, Client A3, Client A4.
CRM Object Mapping to Account (Household)	Select the object to map as a household for the 1:Many relationship. Entity (with the API Name of Account) is recommended.
CRM Object Mapping to Contact Data	Select the object to map to the Gateway Account for contact details. Contact is recommended.
Tax ID	If you intend to enable the auto-assign feature and one of the data points you want to match is Tax ID, select Store here. Otherwise, select how you would like Tax ID numbers to be handled in your Salesforce org.
Administrator Profile	If different than the System Administrator profile, select the Salesforce profile for the Administrator.

After entering all the above details, click Save to finalize these settings.

Configure Data Download Details

On the main page for the OpenView Gateway app, configure the settings used for matching download timing and notifications.

To configure data download details:

1. On the left-hand side of the Data Download Details section, check the following boxes:
   • Each type of data to download (including balances and positions as of previous business day)
   • Account restrictions
   • Alerts
2. Please note: The matching Gateway Accounts and custodian account sync features are not supported in Practifi. When configuring within the Data Download Details section, the Schwab Advisor Center Balances and Schwab Advisor Center Positions boxes must remain unchecked and cannot be checked.
3. To track the status of Digital Account Opening, the user can either use the Track Digital Account Open Status feature or look at the Custodian Alerts synced over. For additional information, please consult our Using the Schwab (OpenView Gateway) App Integration article.
4. On the right-hand side of the Data Download Details section, make selections for the following:

   • How often to download alerts (daily, every four hours, every two hours, once an hour)

   • Daily download time (10 a.m. Eastern time is the earliest data is available)

   • Notification for download failures (except for alerts)

   • Notification for Gateway Articles

5. As noted above, we do not support the matching Gateway Accounts feature and custodian account sync. Consequently, in the Account, Auto-Assignment Details section, please uncheck the Enable Auto-Assignment and Send notification for unassigned accounts box as detailed below:
   
   

Setting	Description
Enable Auto-Assignment	Uncheck this box to disable auto-matching a gateway account to a household record.
Match this Gateway Data (1)	Will be greyed out.
To this CRM Data (1)
Match this Gateway Data (2)	Will be greyed out.
To this CRM Data (2)
Send notification for unassigned accounts	Uncheck the box to stop receiving notifications for unassigned accounts.

Enroll the Download ID

To enroll the download ID:

1. On the Home page of the Schwab OpenView Synchronization Setup, select the Enroll Download ID button.
   
   
   
   
2. When prompted, enter the user ID and Password for the download ID.
3. Check the box to accept the terms and conditions, then select Subscribe. A message will open, confirming you are enrolled successfully.
   
   
   
   
4. Close the window to continue.

Enroll Schwab Advisor Center IDs

To enroll Schwab Advisor Center IDs:

1. On the Home page of the Schwab OpenView Synchronization Setup, select the Schwab Advisor Center Enrollment button.
   
   
   
   
2. When prompted in a new window, enter the user ID and Password for the user ID.
3. Check the box to accept the terms and conditions, then select Subscribe. A message will open, confirming you are enrolled successfully.
   
   
   
   
4. Close the window to continue.

Configuring New Objects

The following steps are recommendations for primary profiles. Based on the profiles you have enabled in Salesforce, you may need to alter the visibility settings.

Add the Entity (Household) Object to the Gateway Assignments Object

A system administrator should complete the following steps within the Object Manager. To add the Entity object:

1. If not already within Salesforce Setup, navigate to Salesforce Setup by selecting the gear icon in the upper right-hand corner (represented by) and selecting Setup from the drop-down menu. 

2. Within Setup, select the Object Manager tab.

3. From the list of objects, select the Gateway Assignment object.

4. Within the Gateway Assignment object details, select the Fields and Relationships tab on the left-hand side.

5. Under Fields and Relationships, select Account (field name: account__c ,data type Lookup (Entity)).
   
   
   
   

6. In the field details, select Set Field-Level Security.

7. On the list of field-level security settings, check the Visible box for the appropriate profiles. To make it visible for all profiles, check the Visible box in the header row.
   
   
   
   

8. Select Save to save the settings for this field and return to the Fields and Relationships list.

9. On the Gateway Assignment object details, select the Page Layouts tab on the left-hand side.

10. To open the layout details, select the name of the layout.

11. In the layout details, click the Fields section on the upper left and then place the Account field in the appropriate section.
    
    
    
    

12. Select Save and return to the page layouts list.

13. Repeat steps 10-11 for all page layouts for the object.

Adding Custom Buttons and Links

For the integration to be successful, there are a few custom buttons that need to be created by the System Administrator. To create custom buttons:

1. From the Object Manager (Setup> Object Manager), open the Entity object.

2. Inside the Entity (Account) object details, select the Buttons, Links, and Actions tab on the left-hand side.

3. At the top right of the page, click New Button or Link.

4. On the Custom Button or Link edit page, enter the following settings:

   • Label - Update Account Balances

   • Name - Update_Account_Balances

   • Description (Optional) - Example:” Updates balances from Schwab Advisor Center.”

   • Display Type - Detail Page Button

   • Behavior - Display in the existing window with sidebar

   • Content Source - Visual Force Page

   • Content - Click down arrow and select UpdateAccountBalancesButton [CSOVG_UpdateAccountBalancesButton]

5. Select Save.

6. Click Total Cash Balance in the list of accounts (Field Label: Total_Accounts_Cash_Balance__c and Data Type: Roll-up Summary (SUM Gateway/Account)).

7. In the field details, select Set Field-Level Security.

8. On the list of field-level security settings, check the Visible box for the appropriate profiles. To make it visible for all profiles, check the Visible box in the header row.

9. Select Save, then click the Fields and Relationships link on the left side of the page.

10. Repeat for the following fields:

Field	Field Label	Data Type
Total Market Value Long	Total_Accounts_Market_Value_Long__c	Roll-up Summary (SUM Gateway Account)
Total Market Value Short	Total_Accounts_Market_Value_Short__c	Roll-up Summary (SUM Gateway Account)
Total Net Worth	Total_Accounts_Net_Worth__c	Roll-up Summary (SUM Gateway Account)

Completing Setup and Initial Mapping

Once the above changes are made, open the OpenView Gateway app and map the fields as per the objects selected in the initial configuration and your firm’s default fields.