Enabling the Schwab (OpenView Gateway) App Integration

Follow

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.

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.

**Note: This content is intended for system administrators and is technical in nature. Please discuss your integration installation plans with your Practifi Customer Support Team for their assistance.*

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:

Installation

Installing from the AppExchange

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

To begin the installation process the Schwab OpenView Gateway app must be installed from Salesforce's AppExchange. 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 byScreen_Shot_2020-05-21_at_12.20.32_PM.png) and selecting Setup from the drop-down menu. 

    Setup.png
  3. Use the Global Search bar at the top of the screen to search for and select AppExchange Marketplace.

    AppSearch.png

  4. Within the AppExchange Marketplace, search for OpenView Gateway and select the Schwab OpenView Gateway app from the results.
    SearchApps.png
  5. On the app's listing, select the Get It Now button at the bottom of the screen.
    GetItNow.png
  6. A pop-up window will open, prompting you to log into your AppExchange account. Select the Open Login Screen button.
    OpenLoginScreen.png
  7. Enter the requested information, with care to enter all information into required fields indicated with a red asterisk. When these details are verified, Schwab will provide an installation link for the AppExchange Application.
    OpenView7.png

Configuring the OpenView Gateway app

Please note: The following steps will be completed by clients 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.
    AppLauncher.png
  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 byScreen_Shot_2020-05-21_at_12.20.32_PM.png) and selecting Setup from the drop-down menu. 
    Setup.png
  2. Within Salesforce Setup, use the Quick Find search bar on the left-hand side to search for and select Remote Site Settings.
    RemoteSiteSettings.png

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. ConfigDataDownload.png

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:DiableAutoAccountAssignment.png

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.
    EnrollDownloadID.png
  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 SubscribeA message will open, confirming you are enrolled successfully.
    Terms.png
  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.
    Enrollment.png
  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.
    Terms.png
  4. Close the window to continue.

Configuring new objects

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

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

The following steps should be completed within the Object Manager by a System Administrator. 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 byScreen_Shot_2020-05-21_at_12.20.32_PM.png) 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)).
    ObjectManager.png

  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.
    Visible.png

  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.
    PageLayout.png

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

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

Adding custom buttons and links

In order for the integration to be successful, there are a few custom buttons needed 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.

FieldMapping.png
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.