汇率管理

01 功能介绍：查询领星月度汇率

从 财务分析 → Finance → 汇率管理 进入。本页查询已同步到 Tower 的领星月度汇率，支持按月份和关键词定位、查看来源信息、下载筛选结果，以及按权限发起单月同步、设置每日同步时间。本页不提供手工编辑汇率值的功能。

一条记录对应当前租户的 生效月份＋原币代码，目标币固定为 CNY／人民币。同一币种不同月份是不同记录；同月同币种再次同步会更新当前保留值，不形成可选的历史版本。本页不是实时外汇行情，也不是按天登记的会计汇率表。

本文截图中的数值均为示例，不作为实际汇率或财务规则依据。同步汇率、保存定时配置等写操作均未演示。

02 使用前：确认月份、币种、方向和来源

1. 确认正在使用正确租户，并具备汇率读取权限。
2. 明确需要核对的业务月份与原币代码，例如 2026-10、USD。不要仅凭“美元”或币种符号认定记录身份。
3. 确认方向是 原币 → 人民币。已核实的部分下游按原币金额乘以选中的汇率换算为人民币，不能倒置方向或把汇率当百分比。不同报表实际选择哪一个月份、哪一列，仍需按报表口径核对。
4. 确认要比较的是领星来源的“官方汇率”还是“我的汇率”。两个名称沿用来源字段；页面没有说明其制定机构、取价时点或报价方法，不把“官方汇率”自行解释成央行中间价、银行结算价或实时市场价。

默认起止月份都是打开页面时浏览器的当前月，不代表数据一定已准备到该月。跨月核查时手动调整范围。

03 查询定位：找到某月某币种

1. 将顶部左侧起始月份和右侧结束月份设为目标月。例如查询单月时，两边都选 2026-10。
2. 在“原币种”右侧搜索框输入 USD 等代码。关键词实际按包含关系匹配原币代码、原币名称、原币符号和目标币名称，不区分英文大小写；输入“人民币”可能命中多种原币，不能认为这是精确币种筛选。
3. 月份或关键词变化后自动查询，并回到第一页。页面没有单独的“查询”或“重置”按钮；清空搜索框、重新选择起止月即可恢复所需范围。等待加载结束后核对生效月份、原币和总条数。
4. 范围包含起止两个月。起始月份应不晚于结束月份；倒置范围可能仅返回空结果，不会自动交换。清空某一端会取消该端限制，两端都清空会读取租户保留的所有月份，应谨慎确认范围。
5. 列表按月份倒序、原币代码升序排列，固定 20条/页。使用“上一页”“下一页”或页码翻页；没有按列排序或更改每页条数的控件。

“原币种”下拉当前只有这一项，不能切换成另一类搜索字段。页面没有店铺、业务视图、目标币选择或每日日期筛选；即使从其他页面带入地址参数，也要以本页实际显示的月份和关键词为准。

04 阅读记录与来源详情

列表显示原币、目标币、官方汇率、我的汇率、生效月份和“详情”。两列数值分别来自领星的 rate_org、my_rate；“我的汇率”不是当前登录人在 Tower 输入的个人值。

• 官方汇率：页面保留4位小数。
• 我的汇率：页面保留10位小数。
• 缺失值：显示“-”，不能按0、1或另一列自动补齐。页面分别展示两列，不在列表中计算一个“最终有效汇率”。
• 0值：如果当前记录确实为0，会显示相应位数的0；这与缺失不同，但不代表各下游允许用0进行换算，应核对来源并按报表自身校验处理。

两列数据库字段均为 NUMERIC(18,10)，显示4位或10位只是格式化，不等于数据库只保存这些展示位数。接口经过数值转换，不能把界面或下载文件当成原始响应逐位精度的证明。

点击目标行 详情，先核对原币代码和生效月份，再查看：

1. 接口更新时间：优先显示来源时间文本；未提供时显示“接口未返回”，不等于本地没有采集过。
2. 采集时间：优先取原始采集时间，缺失时可回退到最后同步时间或记录更新时间；不可一概当作外部汇率变更时间。
3. 最后同步时间：这条本地事实最近同步写入的时间。
4. 来源键、原始请求ID、原始运行ID：用于交接排查。来源键包含月和原币代码；请求、运行信息不能替代结果核对。

详情展示已加载的列表行，不会单独重新采集或查询一份最新详情。关闭右上角“×”回到列表会保留筛选与页码；需要最新资料时关闭详情、点“刷新”，加载成功后再打开。

05 同步任务：单月提交，分别确认受理与完成

刷新重新读取当前列表、来源配置和活动任务，不发起新的外部汇率采集。同步汇率才会提交采集任务。下面是正式操作路径，真实同步未演示。

1. 将起止月份设为同一个合法月份；不同月份会提示“手动同步一次只支持单个月份。”。即使关键词只匹配某一币种，同步仍以所选月份为范围，不只同步该币种或当前页。
2. 确认有页面读取、汇率写入和提取器写入权限，且没有正在运行的任务。
3. 点击“同步汇率”。“同步任务已提交。”只说明提交及随后任务查询成功，不能解释为汇率全部更新。
4. 查看按钮旁状态和请求月份。页面直接显示状态代码：pending 排队、extracting 提取、syncing 写入、success 完成、failed 失败。活动状态约每4秒查询一次；进行中或提交中不能再点同步。
5. 看到 success 后点“刷新”，重新按该月和币种查询，再核对具体数值与最后同步时间。轮询任务完成不会自动刷新列表。

同租户同来源最多允许一个活动任务，月份不同也不能并行提交；冲突请求会被拒绝。页面每次点击生成新的请求标识，不表示同月永久只会执行一次。遇到提交报错时先刷新确认是否已产生任务，勿连续重试。

本页查询的是活动任务，不是完整历史。刷新或重新进入后看到 空闲，只表示没有返回活动任务，不能证明上次成功。轮询失败可能保留旧状态；出现 failed 时页面也没有展开错误明细的面板，应记录月份与发现时间，由维护人员核查具体任务错误和运行记录，再决定重试。

成功可能包含写入0条：来源空响应不会删除已保存的旧月份或币种。提取非完全成功、写入失败均不能当作完整覆盖成功；看到旧记录也不能证明本次任务已更新它。这里没有进度百分比或逐币种完成清单。

06 来源配置：设置每日同步时间

“定时同步”维护领星月度汇率来源的每日采集计划，不设置某笔交易的生效时间，也不编辑汇率金额。当前只提供一个固定来源，不提供添加自定义汇率来源或任意币种对的入口。配置保存未演示。

1. 在有权限且配置读取正常时点击 定时同步。
2. 核对 时间、时区、启用。时间使用24小时制；页面时区选项为 Asia/Shanghai 和 UTC，必须结合时区理解触发时间。
3. 按需修改后点击 保存。后端校验时间、时区和配置参数；出现“定时同步已保存。”才表示本次配置保存成功，不表示任务已执行或记录已更新。
4. 关闭后重新打开确认返回的配置；如有疑问，先刷新成功后再打开。点击 取消 或“×”放弃当前弹窗中的未保存修改。

定时任务按执行进程的当前月份采集，不按你正在浏览的历史月份采集；时间边界需要结合部署时区核查，不能承诺一次设置会自动补齐所有历史月。补历史月应另按单月同步路径处理。

未拿到配置时，弹窗可能显示前端默认的 02:15、Asia/Shanghai、启用，这些默认值不证明配置已保存或调度器正常。看到页面报错时先解决配置读取问题，不直接把默认值当成现有配置覆盖保存。关闭启用项控制定时计划，不是删除已同步记录，也不代表终止已经运行的任务。

07 导出和对账：统一范围后比较

1. 确认起止月份和关键词正确，当前查询没有错误。
2. 点击右侧 下载 图标，获取 lingxing_erp_exchange_rates_时间戳.xlsx。
3. 文件工作表为“汇率”，覆盖当前租户下符合月份和关键词的全部记录，不是当前20条，也不是所有租户或外部平台的全部汇率。导出按当前筛选另行读取，数据若在期间更新，不保证与先前列表是同一个固定快照。
4. 对账先比较月份、原币代码、目标币和来源，再比较使用列和时间。若报表选择了早于业务月的最近可用记录，应按实际选中月核对，不能仅比较页面默认当前月。

文件包含13列：原币、原币代码、原币符号、目标币、官方汇率、我的汇率、生效月份、接口更新时间、采集时间、最后同步时间、来源键、原始请求ID、原始运行ID。官方汇率格式为4位小数，我的汇率为10位，导出写入的是格式化文本；空值为空单元格，不是0。文件采集时间使用原始采集字段，没有详情中的时间回退，因此可能比详情显示更少。

没有额外独立导出权限，后端要求汇率读取权限。页面下载按钮不会因空结果自动禁用；空结果可产生只有表头的文件。导出失败先核对登录权限、月份条件和服务错误，不根据旧文件判断本次结果。

08 与预算、经营分析和历史报表核对

已核实的部分运营预算与库存健康经营分析读取路径，会按 同租户、同原币代码、不晚于业务月份的最近月选择汇率，并优先采用“我的汇率”，只有它为空时才取“官方汇率”。这不是保证每个报表都采用的统一规则；最新匹配记录两列都为空时，也不能自行回退到1或任意更早非空值。

例如业务月为10月，最近匹配来源月可能是9月；两边月份不同不一定是错误，需要先查看报表实际采用月份和缺失处理。示例只说明选择边界，不给出实际财务取值。

• 到 运营预算 核对业务月、原币及对应预算字段，而不是把当前列表的任意一列直接替换预算结果。
• 到 经营分析 核对来源状态和结果生成时间。汇率变化参与部分来源变化标记，并不代表分析结果已经完成刷新。
• 到 利润统计 核对利润数据自身的汇率来源。ERP利润事实有独立的币种和汇率字段，不能认定本页同步会覆盖它们。

本页没有重算利润、重建报表或修改冻结版本的按钮；已核对的同步完成链路负责写入月度汇率事实和任务结果，不能据此承诺自动重算全部历史利润、改写冻结预算或更新所有报表。历史与冻结结果如何更新，应按责任页面的实际版本规则由负责人确认。更多财务分工见 财务分析。

09 权限与状态边界

• 查看、详情、下载、读取来源配置与任务：要求 erp_exchange_rate:read。没有读取权限时，通常先由页面访问控制显示“无访问权限”；汇率页面内部也有“无权访问 ERP 汇率。”的读取检查。
• 从页面发起同步：先能进入页面，还需 erp_exchange_rate:write 与 extractors:write。后端同步接口也检查这两项写权限；只有汇率写权限不够。
• 页面的定时同步按钮：沿用同样的两项写权限判断；后端配置保存接口检查的是 erp_exchange_rate:write，不额外检查 extractors:write。因此不要把按钮是否可点与所有后端接口的授权条件混为一谈，也不要尝试用深链绕过权限。

页面没有手工修改“官方汇率”“我的汇率”的表单，没有新增、删除、导入、审批或历史版本切换入口。“定时同步”的保存只保存采集计划。

加载列表时同时读取记录、配置和活动任务；任一请求失败都会使本轮结果不更新，旧记录可能仍保留。先看错误提示，再判断“暂无数据”或旧行，不能用另一个成功来源填补失败来源。顶部“帮助”图标当前没有接入点击动作，需要帮助时使用帮助中心文章入口。

10 异常处理顺序

1. 先检查权限和租户：无法进入页面先确认读取授权；按钮禁用再核对写权限、提取器权限以及活动任务。
2. 再检查范围：默认当前月可能无数据，起止月倒置或关键词误匹配也会为空。清空关键词，选择已有业务月并等待查询完成。
3. 区分缺失与0：某列“-”代表未知；当前保留值为0也需核对来源，不能按常识改成1或另一列。接口更新时间缺失不等于没有同步时间。
4. 有报错先处理报错：记录、配置或任务读取失败可能阻断整轮加载；点“刷新”核对恢复情况。遇到数据表未初始化等服务提示，交系统维护人员处理，不重复同步来代替环境修复。
5. 任务失败或长期不动：记录目标月份、状态和报错时间，交维护人员核查。任务超时由后端后续扫描判定，不保证某个倒计时结束时页面自动显示失败；不要连续提交同源任务。
6. 仍显示旧值：任务完成后重新刷新列表并打开详情，比较最后同步时间。成功空响应可能没有更新旧行，空闲也不是成功证据。
7. 配置保存失败：检查时间格式和时区，确认配置请求报错是否仍在弹窗后方的页面顶部；关闭并刷新核查服务端现值，不能把弹窗中尚未保存的值当成生效值。

11 常见问题

为什么查的是某个月，却能每天定时同步？

数据粒度是月，采集频率是每日，两者不同。每天可以更新当前月的来源值，不代表产生每日汇率记录。

能直接修改“我的汇率”吗？

不能。它是来源字段；本页只支持读取和同步，没有手工汇率编辑入口。定时同步弹窗也不修改汇率数值。

下载为什么超过20条？

列表分页20条，下载按相同筛选去掉分页读取全部命中记录。先确认范围，不能用当前页条数判断文件是否重复。

官方汇率和我的汇率不同，该用哪一个？

先确认责任报表采用的来源、月份和列。部分下游优先“我的汇率”，但页面不会替所有财务场景作统一决策。

同步成功后历史报表会一起更新吗？

不能这样承诺。同步成功不等于所有币种都有新数据，更不等于利润、预算或冻结版本已重算。到责任页面核对来源和版本。