Integration Overview
What is Integration?
Section titled “What is Integration?”Integration refers to connecting external systems (Vendors) with RightCapital’s platform. The Integration Team handles:
- Data Integration - Sync financial data (positions, holdings, insurance) from Vendors to RightCapital
- SSO (Single Sign-On) - Allow advisors to login seamlessly between RightCapital and Vendor systems
- CRM Integration - Import household/client information from Vendor systems
Why Integration Matters
Section titled “Why Integration Matters”Business Context: An advisor’s clients (households) typically have financial assets spread across multiple institutions - savings accounts at various banks, investment accounts at different brokerages.
Value Proposition: Integration allows advisors to:
- Quickly import household financial data into RightCapital
- Automatically sync data from Vendors daily
- Save time and effort on manual data entry
Integration Components
Section titled “Integration Components”| Component | Description | Primary Use |
|---|---|---|
| Data Integration | Sync securities, positions, insurance data | Core daily operations |
| Morningstar | Security Master data source (prices, fundamentals) | Security matching and pricing |
| SSO | Single sign-on authentication | Seamless login experience |
| CRM Integration | Household and contact information | Client data import |
Key Concepts
Section titled “Key Concepts”Vendor
Section titled “Vendor”External financial institution or data provider that RightCapital integrates with. Examples: Schwab, Fidelity, TD Ameritrade, Orion.
Rep Code
Section titled “Rep Code”A unique identifier for an advisor within a Vendor’s system. Used in File-based integrations to associate data files with specific advisors.
Integration Mapping
Section titled “Integration Mapping”The link between a RightCapital advisor and their identity in a Vendor system (Rep Code for File-based, OAuth token for API-based).
Link Account
Section titled “Link Account”The process where an advisor selects which accounts from a Vendor should be imported into RightCapital for a specific household.
Nightly Sync
Section titled “Nightly Sync”Scheduled batch process that runs daily (US evening) to update all integrated data from Vendors.
Data Integration Types
Section titled “Data Integration Types”File-based Integration
Section titled “File-based Integration”Vendor SFTP → Collector → S3 → Retail API → Database- Vendor pushes data files to RightCapital via SFTP
- Collector downloads and processes files, uploads to S3
- Retail API parses files and saves data to database
Key Characteristics:
- Data files contain Rep Code to identify advisor
- Support team creates integration mapping in Admin Center
- Files typically include: accounts, positions, securities, tax lots
API-based Integration
Section titled “API-based Integration”Retail API → Vendor API → Database- Advisor authorizes RightCapital via OAuth or similar
- RightCapital stores authorization credentials
- System calls Vendor API to fetch data
Key Characteristics:
- Advisor self-service authorization flow
- Real-time or near-real-time data access
- Common auth methods: OAuth 2.0, API tokens
Workflow: How Advisors Use Integration
Section titled “Workflow: How Advisors Use Integration”Creating an Integration
Section titled “Creating an Integration”File-based:
- Advisor contacts Support
- Support guides advisor to request data push from Vendor
- Vendor starts sending files to RightCapital
- Support creates integration mapping with advisor’s Rep Code
API-based:
- Advisor goes to Advisor Portal → Integrations
- Selects Vendor and follows authorization flow
- System stores credentials, integration is active
Importing Data
Section titled “Importing Data”- Advisor opens Client Portal → Profile → Net Worth → Link Account
- Selects a Vendor from their active integrations
- System displays available households/accounts from Vendor
- Advisor selects which data to import
- Data is saved to the current household
Deleting Data
Section titled “Deleting Data”- Unlink specific account: Client Portal → Link Account → uncheck the item
- Remove entire integration:
- File-based: Contact Support to remove Rep Code
- API-based: Advisor Portal → Integrations → disconnect
Key Systems
Section titled “Key Systems”| System | URL Pattern | Purpose |
|---|---|---|
| Advisor Portal | app.rightcapital.{com,qa,net} | Advisor-facing, integration management |
| Client Portal | client.rightcapital.{com,qa,net} | Client-facing, Link Account feature |
| Admin Center | admin.rightcapital.{com,qa,net} | Support/Admin, integration configuration |