币种管理汇率逻辑调整 PRD

版本：v1.1 | 创建日期：2026-05-12 | 更新日期：2026-07-31

需求来源：产品现状问题 + 本地代码验证 + 竞品录屏调研 + 官方文档

优先级：P1 | 文档状态：草稿

适用范围：多币种管理、金额字段个人币种展示、汇率函数、原币到转换币查询接口

一、需求概述

1.1 需求背景

核心问题： 当前纷享销客多币种管理中，既可以在本位币视角维护“1原币 -> n本位币”的汇率，也可以在某个原币视角维护“1其他原币 -> n当前原币”的汇率。现有运行逻辑只读取指定方向的人工汇率，不会同时取两套值；问题在于各方向需独立维护，容易漏维护、长期未更新或与本位币口径不一致。

核心结论：汇率人工维护只保留“原币 -> 本位币”一个事实源。新企业默认使用该模型；历史企业通过不可逆的一次性开关切换，开启后原币间人工汇率直接失效。

本需求不是反馈驱动，而是系统汇率模型的逻辑优化。背景部分只记录当前系统现状、截图情况和由此产生的产品问题。

系统现状与截图情况：

系统现状	截图/依据	当前表现	问题与优化方向
本位币入口可维护原币到本位币汇率		管理员可以从本位币视角维护其他币种到本位币的汇率	该入口符合中心汇率模型，应保留为唯一人工维护入口
非本位币入口也可维护原币到原币汇率		从某个原币进入“调整汇率”后，可以维护其他原币到当前原币的汇率	各方向汇率独立维护，缺少统一推导口径；统一换算后移除该入口
前台展示个人币种换算值		金额字段展示原币金额，同时在括号中展示个人币种金额；这个汇率的参考就是取的 原币到原币的汇率转换	展示能力需要保留，但汇率应由本位币汇率派生，不应要求管理员单独维护原币间汇率
系统已开放原币到转换币查询能力	EXCHANGERATE(currency1,currency2,defaultValue)、find_exchange_rate_by_currency	公式和接口可按原币、转换币查询汇率	不能直接删除原币到原币能力，需要在原有查询链路中增加本位币派生兜底

竞品情况：

产品	截图	关键机制	产品判断
Salesforce		管理有效币种、公司币种标识、兑换率、小数位数	汇率围绕 Corporate Currency 维护，不提供任意原币对原币的人工维护入口
Salesforce		新增币种时填写兑换率和小数位数	新增币种的汇率心智是相对公司币种
HubSpot		账户币种列表展示汇率、格式、更新时间，支持自动汇率更新和汇率日志	围绕 Company Currency 管理汇率，强调中心化维护和更新记录
Zoho CRM		手册截图中货币列表直接标识“基础货币：人民币-CNY”，其它货币围绕基础货币展示汇率	Zoho 将基础货币作为组织级汇率锚点，而不是维护任意原币对
Zoho CRM		编辑货币弹窗中维护单个货币的“汇率”字段	汇率维护入口围绕单个货币到基础货币的关系展开

官方资料：

• Salesforce Manage Multiple Currencies：[https://help.salesforce.com/s/articleView?id=sf.admin_currency.htm&type=5](https://help.salesforce.com/s/articleView?id=sf.admin_currency.htm&type=5)
• Salesforce Set Your Corporate Currency：[https://help.salesforce.com/s/articleView?id=xcloud.admin_currency_set_corporate.htm&type=5](https://help.salesforce.com/s/articleView?id=xcloud.admin_currency_set_corporate.htm&type=5)
• Salesforce Advanced Currency Management：[https://help.salesforce.com/s/articleView?id=sales.administration_about_advanced_currency_management.htm&type=5](https://help.salesforce.com/s/articleView?id=sales.administration_about_advanced_currency_management.htm&type=5)
• HubSpot Add and edit your account currencies：[https://knowledge.hubspot.com/account-management/add-and-edit-your-account-currencies](https://knowledge.hubspot.com/account-management/add-and-edit-your-account-currencies)
• Zoho CRM 管理多货币：[https://help.zoho.com.cn/portal/zh/kb/crm/organization-settings/company-settings/articles/multiple-currencies?crmprod=1](https://help.zoho.com.cn/portal/zh/kb/crm/organization-settings/company-settings/articles/multiple-currencies?crmprod=1)

为什么围绕本位币维护汇率是更规范的方案：

下图说明两种模式的本质差异。左侧任意两个币种之间均可双向人工维护；以 AED、USD、CNY 三个币种为例，共有 3 × 2 = 6 条有向汇率关系。右侧只维护“非本位币 -> 本位币”两条中心汇率，其余四条有向关系均由系统派生。

图示结论：现状按换算方向直接读取对应的人工汇率，不会同时比较本位币派生值，因此不存在多套结果同时参与计算的取值冲突。问题在于六条汇率独立维护，正反向可能不互为倒数，原币间汇率也不会随本位币汇率同步更新。目标态的实线箭头仅允许单向指向本位币：只维护 AED -> CNY、USD -> CNY 两条中心汇率；CNY -> AED、CNY -> USD、AED -> USD、USD -> AED 均为唯一的派生结果。

因此，本期不是下掉“原币到原币换算能力”，而是把它从“独立人工维护”调整为“系统统一派生”。这样既能保留个人币种展示、函数和接口查询，又能减少漏维护、汇率过期和不同方向结果不一致的问题。

现状依据：

产品价值：

1. 统一多币种汇率推导口径，使不同换算方向的结果可以相互验证。
2. 降低管理员维护成本，从维护 N×(N-1) 条有向汇率收敛为维护 N-1 条原币到本位币汇率。
3. 保留个人币种展示、汇率函数、汇率查询接口等现有能力，降低存量企业受影响风险。

1.2 需求目标

1. 管理端只允许人工维护“原币 -> 本位币”的中心汇率
2. 新企业从启用多币种起不再创建或维护原币到原币汇率；原币间及个人币种换算均按中心汇率实时派生。
3. 历史企业提供一次性开启入口；开启后不可关闭，已有原币间人工汇率立即失效。
4. 个人币种展示、汇率查询和换算仍保留，统一使用本位币汇率实时派生的结果。
5. 人工录入的汇率必须大于 0，前端与服务端统一校验。

二、产品方案

2.1 整体方案

本次采用“中心汇率 + 派生换算”方案：只人工维护“原币 -> 本位币”汇率，原币间汇率由系统实时计算。

• 新企业：默认使用统一换算，不展示模式开关和原币间“调整汇率”入口。
• 历史企业：未开启时保持现状；企业管理员可一次性开启“本位币统一换算”，开启后不可关闭。

派生规则：

rate(A -> B) = rate(A -> 本位币) / rate(B -> 本位币)

示例：

AED -> USD = 0.888 / 7.200 = 0.123333

1 AED = 0.123333 USD

2.2 管理端交互与文案

最新交互稿：https://www.figma.com/design/jNBOlieKd8r8cMqTL8FAsz/%E5%9B%BD%E9%99%85%E5%8C%96?node-id=7971-2925

开关区域

开启确认弹窗

仅历史企业且尚未开启时展示该配置；新企业和已开启的历史企业均不展示。

2.3 并发管理员的失效入口处理

管理员 A 开启统一换算后，管理员 B 的未刷新页面可能仍显示原币间“调整汇率”。系统以服务端的最新企业模式为准：点击入口时重新校验，保存接口也必须再次校验，不允许通过旧页面继续写入。

2.4 运行逻辑调整

“查看历史汇率”仅记录管理员人工变更的“原币 -> 本位币”汇率；原币间派生结果不落历史记录。

派生汇率精度与舍入

原币到原币的派生可能产生无限循环小数，例如 1 / 3 = 0.333333...。本期将“汇率精度”和“金额精度”分开处理：汇率用于计算和追溯，金额才是用户最终看到或写入业务记录的值。不得在中间派生步骤按金额小数位截断。

计算约束： 每次派生都直接引用同一中心汇率版本的两条“到本位币汇率”，按 6 位 HALF_UP 得到唯一业务汇率。不得用已有派生汇率继续派生，也不得用 A -> B 的已输出值再取倒数生成 B -> A；反向币对必须按中心汇率公式重新计算，避免多轮换算产生累计误差。

2.5 汇率大于 0 校验

现有管理端只校验必填、数字格式和小数位，未校验汇率必须大于 0。本期将规则统一补充到新增币种、编辑币种、调整“原币 -> 本位币”汇率及相关写入接口。

2.6 历史企业兼容规则

1. 未开启统一换算时，历史企业继续按现有单向人工汇率运行。
2. 开启后，原币间人工汇率直接失效，不再展示、不再写入、不再记入“查看历史汇率”。
3. 开启只改变后续查询和换算口径，不重新计算历史单据和已落库金额。
4. 不设置差异清单或逐币对处理流程；开启前通过确认弹窗一次性告知影响。

三、其他说明

3.1 多语能力支持

开关、确认弹窗、并发失效提示和汇率校验提示均提供中英文，具体文案见 2.2、2.3 和 2.5。

3.2 需求埋点/日志

无新增产品埋点。

系统侧保留企业开启记录、旧页面写入拦截和接口失败日志，用于客诉定位与灰度观测。

3.3 沙盒/更改集能力

待确认现有币种管理配置是否支持沙盒/更改集。本期如果只调整系统换算逻辑，不应新增更改集对象。

3.4 对象与字段影响

无新增业务对象。需在企业级保存统一换算开启状态、操作人和开启时间，具体字段由研发设计评审确认。

3.5 影响调研

边界：上述结论仅表明两者未使用该管理入口；公式、查询接口和个人币种展示等下游链路仍需按灰度方案验证。

3.6 风险点

3.7 上线策略

3.7.1 收费标准

• [X] 不收费
• [ ] 收费

3.7.2 上线节奏

• [ ] 全网
• [X] 灰度

3.7.3 适应版本

待确认。建议与当前多币种能力支持版本保持一致。

四、验收标准

五、待确认事项

附1：需求变更记录

附2：需求 Story 列表