Integration Glossary
Core Concepts
Section titled “Core Concepts”Advisor
Section titled “Advisor”A financial advisor who uses RightCapital to manage their clients’ financial plans. Advisors are the primary users of integration features.
Household
Section titled “Household”A client unit managed by an advisor. Typically represents a family or individual with financial assets. Each household can have multiple accounts linked via integrations.
Account
Section titled “Account”A financial account (brokerage, bank, insurance, etc.) that belongs to a household. Accounts are linked from Vendors via the integration process.
Vendor
Section titled “Vendor”An external system or financial institution that RightCapital integrates with. Examples: Schwab, Fidelity, Orion, TD Ameritrade.
Integration
Section titled “Integration”The connection between RightCapital and a Vendor that enables data synchronization. Can be file-based or API-based.
Integration Mapping
Section titled “Integration Mapping”A database record linking a RightCapital entity (advisor, household, account) to its corresponding entity in a Vendor system.
Technical Terms
Section titled “Technical Terms”Rep Code
Section titled “Rep Code”A unique identifier for an advisor in a Vendor’s system. Used primarily in file-based integrations to associate data files with specific advisors.
Reference
Section titled “Reference”A field in integration tables that stores the Vendor’s identifier for an entity. Different from credentials.
Credentials
Section titled “Credentials”Authentication information (OAuth tokens, API keys, passwords) used to access Vendor APIs. Stored encrypted.
Mappable Type
Section titled “Mappable Type”The type of entity being mapped in an integration (household, account, etc.). Different mappable types have different sync behaviors.
LATEST Files
Section titled “LATEST Files”Symlinks on S3 pointing to the most recent data files from a Vendor. Used by Retail API to find current data without knowing specific dates.
Data Concepts
Section titled “Data Concepts”Security Master
Section titled “Security Master”The authoritative database of security information (stocks, bonds, funds). Sourced primarily from Morningstar.
Position
Section titled “Position”A holding in a specific security within an account. Includes quantity, market value, and other details.
Holding
Section titled “Holding”A general term for assets held in an account. Can include securities (positions), cash, insurance, real estate, etc.
Tax Lot
Section titled “Tax Lot”A specific purchase of a security with its own cost basis and acquisition date. Used for tax calculations.
Committee on Uniform Securities Identification Procedures. A 9-character identifier for North American securities.
Net Asset Value. The per-share value of a mutual fund or ETF.
Integration Types
Section titled “Integration Types”File-based Integration
Section titled “File-based Integration”Integration where the Vendor pushes data files (typically via SFTP) that are processed by Collector and parsed by Retail API.
API-based Integration
Section titled “API-based Integration”Integration where RightCapital calls the Vendor’s API directly to fetch data.
Nightly Sync
Section titled “Nightly Sync”The scheduled batch process that updates all integration data daily.
Link Account
Section titled “Link Account”The user action of selecting which Vendor accounts to import into a RightCapital household.
SSO Terms
Section titled “SSO Terms”SSO (Single Sign-On)
Section titled “SSO (Single Sign-On)”Authentication mechanism allowing users to log into multiple systems with a single set of credentials.
IdP (Identity Provider)
Section titled “IdP (Identity Provider)”The system that authenticates users and provides identity assertions. In Vendor SSO, the Vendor is typically the IdP.
SP (Service Provider)
Section titled “SP (Service Provider)”The system that receives authentication assertions and provides services. RightCapital is typically the SP.
Security Assertion Markup Language. An XML-based protocol for exchanging authentication data.
Contextual SSO
Section titled “Contextual SSO”SSO that includes additional context (like a household ID), allowing automatic navigation to specific data.
System Components
Section titled “System Components”Collector
Section titled “Collector”Service that downloads files from Vendor SFTP servers, processes them, and uploads to S3.
Admin Center
Section titled “Admin Center”Internal admin application for managing integrations, viewing logs, and supporting advisors.
Retail API
Section titled “Retail API”Main backend service that processes integration data and serves the advisor-facing application.
Database Tables
Section titled “Database Tables”integrations
Section titled “integrations”Stores the connection between an advisor and a Vendor. Contains credentials and reference information.
integration_mappings
Section titled “integration_mappings”Stores the mapping between RightCapital entities and Vendor entities. Links households/accounts to their Vendor counterparts.