mcpField
F
financial-planning-integration

financial-planning-integration

github.com/joellewis其他218697 次安装15 周前更新
代码仓库

关于 financial-planning-integration

面向财务顾问技术体系的集成参考,梳理规划工具与 CRM、PMS、托管方及聚合平台之间的数据和决策流。重点说明目标状态、受治理的假设,以及财务计划与投资组合的双向衔接。

主要功能

  1. 01梳理规划系统间的数据流
  2. 02定义目标字段与状态追踪
  3. 03说明资本市场假设治理
  4. 04连接财务计划与投资组合
  5. 05涵盖税务参数与计划输入

适用场景

  1. 01设计顾问系统间的规划数据交换
  2. 02同步目标状态至 CRM 和客户门户
  3. 03协调投资政策声明与投资组合调整
  4. 04检查税务规划参数的年度更新

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/joellewis/finance_skills --skill financial-planning-integration

安装后在 Claude Code 中输入/financial-planning-integration确认已加载。

详细介绍

财务规划集成

核心概念

财务规划系统架构

财务规划引擎是顾问技术栈中的分析枢纽。它从多个系统中接收客户数据,对客户的财务未来进行建模,并生成用于驱动投资组合构建、现金管理和持续顾问建议的结果。(有关这些引擎采用的规划方法,请参阅 financial-planning-workflow。)

与顾问技术栈中其他系统的关系:

  • **CRM(客户关系管理):**提供客户人口统计数据、家庭构成、就业状况、人生事件和规划审查触发因素。CRM 是客户信息的记录系统;规划工具将这些信息作为输入。
  • **PMS(投资组合管理系统):**提供当前投资组合持仓、资产配置和账户类型。规划方案会生成所需收益目标和风险承受能力,并将其反馈给 PMS,作为投资组合构建的约束条件。
  • **托管机构:**提供账户余额、持仓和交易历史。托管数据源可确保规划方案反映实际账户价值,而非过时的估算值。
  • **聚合平台:**提供托管机构以外持有的资产——其他托管机构的账户、雇主退休计划、银行账户、房地产净值估算和股票期权。聚合平台弥补了顾问托管资产与客户实际拥有资产之间的缺口,这对于全面了解客户的财务状况至关重要。

**常见财务规划平台(截至 2026 年;请核实当前供应商名单):**eMoney Advisor、MoneyGuidePro(Envestnet)、RightCapital、Naviplan(InvestCloud),以及集成在一体化平台中的规划模块(例如 Orion Planning、Advyzon)。平台选择取决于公司规模、集成需求、规划复杂度和面向客户的展示需求。有些平台侧重交互式客户门户(eMoney、RightCapital);另一些则侧重面向顾问的深度分析(MoneyGuidePro、Naviplan)。

目标数据模型与状态跟踪

目标是规划工具、CRM 和客户门户之间流转的结构化记录。每个目标都包含一组由下游系统使用的属性:

  • **目标金额:**所需金额,以当前币值或未来币值表示
  • **目标日期:**资金所需的时间(单个日期,或退休收入等持续性目标的日期范围)
  • **优先级:**必需、重要或期望实现
  • **资金来源:**为目标提供资金的账户和收入来源——账户关联正是规划方案与 PMS 相连的方式
  • **通胀假设:**适用的类别特定通胀率(总体 CPI、教育、医疗保健)

每个目标都有一个根据当前成功概率得出的状态,状态更新会同步到 CRM 和客户门户:

  • **进展顺利:**成功概率达到或超过目标阈值(通常为 80-90%)
  • **需要关注:**成功概率为 60-80%,适度调整即可恢复进展顺利状态
  • **存在风险:**成功概率为 40-60%,需要对规划方案进行重大调整
  • **不太可能实现:**成功概率低于 40%,可能需要重新规划目标或降低其优先级

随着投资组合数据源刷新规划输入,这些状态指标必须动态更新。如何设定目标、确定目标优先级并对权衡进行建模属于规划方法范畴——请参阅 financial-planning-workflow。

将资本市场假设作为受治理的输入

计划预测背后的预期收益率、波动率和相关性假设,是规划体系中影响最重大的数据元素,也是最常出现不同步的数据元素。

  • 微小变化会产生重大影响:将预期股票收益率从 8% 降至 7%,就可能使计划成功概率相差 10–15 个百分点。只呈现一个概率数字而不说明假设背景,会造成虚假的精确感。
  • 公司应维护一份唯一权威的资本市场假设(CMA)文档,由投资委员会负责,并按既定周期(每季度或每年)审查,供所有系统(规划工具、PMS、方案生成引擎)参考。若在各系统中独立设置假设,这些假设就会逐渐偏离。
  • CMA 发生变化时,所有系统必须同时更新,并重新运行所有客户计划;对于概率发生重大变化的计划,应标记出来供顾问审查。
  • 分布选择(正态分布与对数正态分布、历史自助抽样、状态切换)也属于应记录在 CMA 治理记录中的假设,因为不同规划工具的默认方法各不相同。

Monte Carlo 机制以及如何解读成功概率结果,详见 financial-planning-workflow。

将税务参考参数作为受治理的输入

规划工具的税务预测依赖每年更新的参考数据:联邦和州税率档位门槛、标准扣除额、IRMAA(Medicare 收入相关月度调整额)门槛、缴款限额和 RMD 年龄。这些参数属于数据治理范畴,而不仅仅是规划输入:

  • 大多数规划供应商都会推送年度税表更新,但公司必须在运行年末转换或提款分析前确认更新已生效。若计划依据去年的税率档位计算,就会悄然错误估算填满税率档位的空间和 IRMAA 风险。
  • 面向客户的输出中,每个数字都应注明所属纳税年度。供参考,2026 年的数值为:标准扣除额为 $32,200(已婚联合申报);22% 税率档位的应税收入上限为 $211,400(MFJ);首个 IRMAA 门槛为 $218,000(MFJ,依据两年前的 MAGI)。务必核实当前纳税年度的数值——这些数值每年都会调整。
  • 自定义覆盖值(例如手动输入的州税假设)应列入清单,并每年重新验证,因为这些值不会随供应商更新而刷新。
计划与投资组合的联动

财务计划与投资组合是一体两面。计划决定投资组合必须实现什么目标(所需回报率、风险预算、提款安排),投资组合则必须据此构建。计划与投资组合脱节时,客户收到的建议就会前后不一。

从计划到投资组合——正向联动:

  • 计划会得出所需回报率:投资组合必须达到这一回报率,计划才能以目标概率成功。
  • 计划会确定客户的风险承受能力:在计划失败之前,客户最多能承受多大的回撤或波动。风险承受能力源自计划——计划资金充足且支出灵活的客户,风险承受能力较高;计划濒临失败的客户,风险承受能力较低。
  • 这些结果会纳入投资政策声明(IPS),将规划假设转化为投资组合约束:目标配置、允许范围、再平衡触发条件、提款规则。

作为桥梁文件的 IPS:

  • IPS 将财务计划与投资组合连接起来。它明确了回报目标(来自计划)、风险容忍度(计划所反映的承受能力,以及通过客户评估得出的意愿)和约束条件(来自计划提款安排的流动性需求、来自计划目标日期的时间跨度,以及来自计划税务预测的税务考量)。
  • 计划发生变化时,应审查并更新 IPS。IPS 发生变化时,应相应调整投资组合。

从投资组合到计划——反馈循环:

  • 投资组合表现(实际回报、投入、提款)会反馈到计划中,以便更新计划。若投资组合表现优于预期,计划的成功概率会上升;若表现不佳,则可能需要调整计划。
  • 账户层面的活动(已执行的 Roth 转换、已提取的 RMD、已实现的税损收割)会影响计划的税务预测,应在下一次更新计划时予以反映。

**闭环规划:**投资组合的变化会反馈到计划中,以便更新计划;计划的变化会正向传导,以便更新投资组合。这种双向连接是综合顾问实践的标志。缺少这种连接,计划与投资组合就会随着时间推移而逐渐脱节,客户也会收到相互矛盾的财务状况信息。

将目标映射到账户和时间跨度:

  • 短期目标(1-3 年)对应低风险配置:现金、短期债券、货币市场基金。
  • 中期目标(3-10 年)对应中等风险配置:中期债券、平衡策略。
  • 长期目标(10 年以上)对应成长型配置:股票、实物资产、另类投资。
  • 这种目标与账户的映射(“分桶”或“按时间分段”)是一种数据联动方式,可让客户了解投资组合不同部分为何采用不同投资方式——而这只有在规划工具中的目标记录与特定 PMS 账户关联时才能实现。
数据流与集成模式

财务规划的质量,取决于流入其中的数据,以及其输出在多大程度上付诸行动。

流入财务规划的数据:

  • 客户人口统计信息(来自 CRM):姓名、出生日期、婚姻状况、受抚养人、就业状况、预计退休日期、健康状况、居住州。
  • 当前投资组合(来自 PMS/托管机构):账户类型、余额、持仓、资产配置、成本基础、未实现收益/亏损。
  • 托管在其他机构的资产(来自资产聚合):现任或前任雇主的 401(k) 计划、配偶的账户、银行账户、房地产净值、股票期权、限制性股票单位、递延薪酬。
  • 保险保单(来自客户访谈或上传的文档):人寿保险、伤残保险、长期护理保险、年金合同。
  • 房地产(来自客户访谈或第三方估值):主要住宅价值、抵押贷款余额、出租房产和度假房产。
  • 收入和支出数据(来自客户访谈、纳税申报表或预算工具):工资、奖金、租金和投资收入、社会保障福利预估(来自 SSA 对账单)、养老金详情、分类列出的支出或预估支出率。

流出财务规划的数据:

  • 所需回报目标(传至 PMS/IPS):用于指导资产配置决策。
  • 风险承受能力(传至 PMS/IPS):在成功概率降至可接受阈值以下之前,规划所能承受的最大风险。
  • 建议储蓄率(提供给顾问/客户):保持规划进度所需的年度储蓄额。
  • 提款计划(传至 PMS 进行现金管理):各账户提款的时间和金额,并考虑税务优化和 RMD 要求。
  • Roth 转换计划(传至 PMS 执行):逐年建议的转换金额。
  • 目标状态更新(传至 CRM/客户门户):针对每项目标显示进度正常、需要关注、有风险或不太可能实现。

集成挑战:

  • **手动重新录入:**许多顾问公司仍在不同系统之间手动重新录入数据(例如,将客户数据从 CRM 输入规划工具,或在投资组合价值变化时手动更新规划)。这会引入错误、占用顾问时间,并导致数据过时。
  • **数据时效性:**如果规划使用的是三个月前的投资组合快照,其输出可能无法反映当前实际情况。通过 API 或托管机构数据源接入的自动数据流可以让规划保持最新。
  • **假设同步:**财务规划和 PMS 必须采用一致的回报假设。如果规划假设股票回报率为 7%,而 PMS 使用 8%,规划与投资组合就会给出相互矛盾的信息。假设同步需要有成文流程:假设只设定一次(通常写在 CMA 文档中),所有下游系统都引用同一来源。
  • **双向更新:**投资组合的变化(业绩、存款、提款、Roth 转换)应自动回传以更新规划。规划的变化(新目标、修订后的假设、更新后的申领策略)则应向前传递以触发投资组合审查。大多数现有平台对单向传递的支持尚可,但无法同时很好地支持双向传递。
规划输出、更新频率和文档记录

规划工具的标准可视化输出(在指定门户或报告集成时很有用):概率仪表盘(整体成功概率)、目标资金图表(每个目标的成功概率)、现金流瀑布图(按年份将收入来源与支出叠加显示)、净资产预测(基准情景加情景线)以及蒙特卡洛扇形图(中位数和百分位区间)。现代工具还支持在客户会议期间实时重新计算情景,这需要实时数据连接,而非过时的导入数据。

规划更新频率和触发条件:

  • **年度审查:**至少每年更新一次规划,纳入当前投资组合价值、修订后的收入/支出假设以及任何目标变更。
  • **事件驱动更新:**CRM 中记录的重大人生事件(换工作、退休、继承、离婚、配偶去世、孩子出生、购房或售房)应自动触发规划更新。
  • **持续监控:**某些平台可根据实时投资组合数据源每日更新规划,并在成功概率低于阈值时提醒顾问。在重大市场剧烈波动后(例如回撤超过 15%)批量重新运行规划,可识别需要关注规划的客户。

**规划确认和文档记录:**展示规划后,记录客户对所用假设、提出的建议以及客户决定(接受、延期、拒绝)的确认。这有助于满足合规要求,并确保规划工具、CRM 和 IPS 反映同一项已达成一致的状态。

示例

示例 1:打通财务规划与投资组合管理之间的闭环

**场景:**一家管理资产达 8 亿美元的中型 RIA 使用不同的系统进行财务规划(eMoney)和投资组合管理(Orion)。该公司发现,规划工具假设平衡型投资组合的回报率为 6.5%,而 PMS 对相同配置的假设为 7.5%。这 100 个基点的差异意味着规划比投资组合所暗示的更保守,导致与客户的沟通不一致:规划表示“您需要增加储蓄”,而投资组合预测却表示“您的进度领先于计划”。该公司希望打通这一闭环。

设计注意事项:

  1. **同步假设。**根本原因在于各系统分别设定了假设。解决方案需要以单一权威来源提供资本市场假设(CMA)。制定正式的 CMA 文档,由公司投资委员会每季度或每年审查并批准,明确规定各资产类别的预期回报率、标准差和相关性。规划工具和 PMS 都必须参考此文档。CMA 变更时,必须同时更新两个系统。

  2. **规划到 IPS 再到模型的映射。**明确界定流程:财务规划为每位客户得出所需回报率和风险承受能力。这些信息会纳入客户的 IPS,其中规定目标配置和模型投资组合。模型投资组合在 PMS 中实施。映射关系应明确记录:

    • 规划输出:“该客户需要 5.2% 的实际回报率,最大回撤容忍度为 -25%。”
    • IPS 转化:“目标配置:65% 股票/30% 固定收益/5% 另类投资。基准:65% MSCI ACWI/30% Bloomberg Aggregate/5% HFRI Fund Weighted。”
    • PMS 实施:“分配至 Balanced Growth Model(Model BG-65)。”
  3. 集成架构。 梳理各系统之间的数据流:

    • CRM 到规划工具:客户人口统计信息、家庭数据、人生事件(通过 API 自动同步或手动录入)。
    • 托管机构到 PMS:账户余额、持仓、交易(通过托管数据源自动同步,每日更新)。
    • PMS 到规划工具:当前投资组合价值、资产配置、账户类型(通过 API 自动同步;如果没有 API,则手动导出/导入)。此数据流应至少每月更新一次,最好每日更新。
    • 规划工具到 PMS:目标回报率、提款计划、Roth 转换计划(通常手动处理——顾问解读规划结果并在 PMS 中执行,但公司应记录这一交接流程)。
    • 规划工具到 CRM:目标状态、规划复核日期、规划成功概率(用于顾问仪表板和客户门户显示)。
  4. 持续更新工作流。 明确更新频率和触发条件:

    • 每季度: PMS 将更新后的投资组合价值推送到规划工具。规划会重新计算成功概率。如果概率变化超过 5 个百分点,顾问应复核规划并考虑是否需要采取行动。
    • 每年: 投资委员会复核并发布更新后的 CMA。规划工具和 PMS 同步更新。使用新假设重新运行所有客户规划。标记概率出现重大变化的情况,供顾问复核。
    • 事件触发: 客户重大人生事件(记录在 CRM 中)会触发规划复核。重大市场事件(回撤超过 15%)会触发批量重新运行所有规划,以找出成功概率已低于阈值的客户。

分析: 假设不一致是治理失误,而不是技术故障。技术修复(同步假设)很简单;而治理修复(建立 CMAs 的唯一可信来源,并制定有记录的复核和更新流程)才是防止问题再次发生的关键。

实施步骤:

  1. 投资委员会发布正式的 CMA 文档,列出公司模型中所有资产类别的预期回报率、标准差和相关性。应同时包含名义回报预期和实际回报预期。
  2. 更新规划工具,使其采用已发布的 CMAs。大多数规划工具都支持自定义资产类别假设——输入 CMA 文档中的准确数值。
  3. 更新 PMS,使其在投资组合预测和业绩预期中采用相同的 CMAs。
  4. 验证一致性:通过两个系统运行一个测试案例。持有 60/40 投资组合的客户,在规划和 PMS 预测中应看到相同的预期回报率。记录验证结果。
  5. 建立季度/年度复核频率并明确职责归属(投资委员会负责 CMAs;规划团队负责规划端更新;投资组合运营团队负责 PMS 端更新)。
  6. 建立对账检查:每季度抽取部分客户,比较规划工具和 PMS 中的预期回报率假设,并标记任何差异。
  7. 记录每个客户层级或模型投资组合对应的规划—IPS—模型映射关系。完成新客户规划后,顾问使用此映射在 PMS 中分配相应模型。

闭环工作流可确保规划指导投资组合(前向链接),而投资组合更新规划(反馈循环),每个环节都使用一致的假设。客户听到的是连贯一致的说明,而不是来自互不关联系统的相互矛盾的信息。

示例 2:管理罗斯转换计划背后的税务参数

**场景:**一位顾问使用规划工具,为一位近期退休的客户制定多年罗斯转换阶梯计划,每年填满较低税档,同时避免超过 IRMAA 门槛。(转换方法本身——税档填满逻辑、转换金额的确定方式、用应税资产缴纳转换税款——已在 financial-planning-workflow 中介绍。)集成方面的问题在于:转换计划是否准确,完全取决于规划工具中加载的税务参考参数,以及计划是否准确传递到 PMS 以供执行。

设计考量:

  1. 税务参数的时效性。 税档填满计算取决于三个每年更新的数值,而规划工具中的每个数值都必须对应正确的纳税年度。对于 2026 纳税年度(请核实当年最新数值):夫妻联合申报(MFJ)的标准扣除额为 $32,200;22% 税档的应税收入上限为 $211,400;首个 IRMAA 附加费门槛为 MAGI(MFJ)$218,000,并采用两年追溯期。如果工具仍使用上一年度的税表,转换计划中的每一年都会计算不准——要么留下未使用的税档空间,要么使转换额超过 IRMAA 门槛,从而导致每人每年增加数千美元的 Medicare 费用。
  2. 年末执行前审查参数。 在公司的规划运营日历中添加一项检查:确认供应商的年度税表更新已应用,并在运行年末转换分析前,重新验证任何手动输入的覆盖值(州税率、自定义扣除假设)。
  3. 将计划传递至 PMS。 计划的输出——逐年建议转换金额——必须传达给负责在 PMS/托管机构执行转换的团队。记录这项交接:由谁录入计划、计划存放在 PMS 的什么位置,以及收入在年中发生变化(这会改变剩余税档空间)时,如何触发规划工具重新计算,并在执行转换前完成更新。
  4. 反馈闭环。 已执行的转换必须回写至计划(通过托管机构数据馈送或手动更新),以便下一年的税档填满计算以实际剩余的传统 IRA 余额为起点,而不是使用预测余额。

分析: 反复出现的问题并非规划逻辑不佳,而是数据过时或未同步:使用上一年度的税表、根据过时的计划版本执行转换,或从未将已执行的转换反映回计划。应像管理 CMA 一样管理税务参数——进行版本管理、明确负责人并按日历核验;也应像处理其他计划到 PMS 的数据流一样处理转换计划,记录交接流程并设置回传数据馈送。由于 IRMAA 会追溯两年的 MAGI,计划还必须准确保留往年的收入数据;只向前模拟当年的规划工具会漏掉由已实现收入触发的附加费。

常见陷阱

  • 在财务规划工具和投资组合管理系统中使用不同的资本市场假设,导致面向客户的沟通相互矛盾,无法明确计划是否按预期推进。
  • 在规划系统和投资组合系统之间手动重新录入数据,引入错误并造成数据过时,削弱计划的准确性。
  • 将假设更新视为临时处理,而非纳入治理流程——如果没有唯一可信的 CMA 数据源、明确的负责人和定期审核安排,每次修正后系统都会再次出现偏差。
  • 在没有说明假设敏感性的情况下,只给出一个蒙特卡洛概率数字——预期回报率只需变化 1-2%,成功概率就可能变动 10-15 个百分点,因此,假设治理与坦诚地沟通计划密不可分。
  • 使用过时的税务参考参数进行年末税务分析(Roth 转换、收益收割)——税档门槛、标准扣除额和 IRMAA 门槛每年都会变化,必须在工具中核实。
  • 仅支持单向同步——投资组合的变更从未更新计划,或计划的变更从未触发投资组合审核,都会破坏闭环。
  • 未将目标关联到具体账户和时间范围——没有这种关联,投资组合配置就无法与计划要求建立数据连接,也无法根据实时账户价值计算目标状态。
  • 未记录客户对规划假设和建议的确认——这会带来合规风险,也使未来召开审核会议时难以说明顾问的决策依据。

交叉引用

  • financial-planning-workflow(advisory-practice 插件):规划方法论的唯一归属——涵盖数据收集、退休建模、蒙特卡洛解读、Roth 转换与 Social Security 策略、情景建模和计划展示。本技能介绍该方法论如何与技术栈的其余部分衔接。
  • investment-policy(wealth-management 插件):财务计划通过提供所需回报率、风险承受能力、时间范围和约束条件等输入,推动 IPS 的制定;IPS 会将这些内容正式纳入投资组合治理。
  • asset-allocation(wealth-management 插件):计划所需的回报率和风险承受能力为战略资产配置划定边界;计划目标则映射到基于时间范围的配置类别。
  • portfolio-management-systems(advisory-practice 插件):PMS 根据财务计划的输出落实投资组合;规划工具与 PMS 之间的数据流必须是双向的,并且假设保持一致。
  • client-reporting-delivery(advisory-practice 插件):计划进度报告——包括目标状态、成功概率和里程碑跟踪——是客户报告资料包的核心组成部分。
  • proposal-generation(advisory-practice 插件):财务计划的输出(所需回报率、建议配置、账户类型)会直接用于向新客户和现有客户展示的投资提案。
  • crm-client-lifecycle(advisory-practice 插件):CRM 存储规划数据(目标、假设、计划审核日期),根据人生事件触发事件驱动的计划更新,并在顾问仪表板上显示计划状态。
  • tax-efficiency(wealth-management 插件):定义资产定位、Roth 转换、提款顺序和收益收割原则,其输出会通过此处介绍的集成流程传递。

评论

支持 Markdown