cs.fin.exchange-rate.update-batch

批量更新汇率，供外部定时调用；已存在则更新，不存在则新增。

• 请求路由: cs.fin.exchange-rate.update-batch
• 交互模型: Request Response
• 访问限制: 无

以当前登录租户、源币种、目标币种和汇率类型匹配，不需要传 rateId。 生效时刻作为数据随汇率一起更新，不参与查重，按毫秒保存。 汇率类型缺省为 BOOKKEEPING；汇率按 1 单位源币种计价，必须大于零。 来源及来源地址仅新增时保存。结算汇率新增或数值变化时同步写入历史。 同一批中相同条目按顺序处理，以最后一条为准。先校验整批参数，数据库错误直接返回， 已写入的条目可通过重试整批安全覆盖。返回成功处理的条数，包含新增、更新及值未变化的条目。

请求

RSocket.rr({
  "route" : "cs.fin.exchange-rate.update-batch",
  "data" : [
    {
      "fromCurrency" : "USD",
      "toCurrency" : "CNY",
      "rateType" : "BOOKKEEPING",
      "rate" : 7.18,
      "effectiveDate" : "2026-11-06T00:00:00Z"
    },
    {
      "fromCurrency" : "EUR",
      "toCurrency" : "CNY",
      "rate" : 7.82,
      "effectiveDate" : "2026-11-06T00:00:00Z"
    }
  ]
});

请求参数

名称	类型	必须	说明
rateId	String	否	汇率号（主键）
fromCurrency	String	否	源币种 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 NZD - 新西兰元 THB - 泰铢 MOP - 澳门币 CHF - 瑞士法郎 RUB - 俄罗斯卢布 IDR - 印度尼西亚卢比 AED - 阿联酋迪拉姆 TWD - 新台币 PHP - 菲律宾比索 ZAR - 南非兰特 SAR - 沙特里亚尔 BRL - 巴西雷亚尔 TRY - 土耳其里拉 INR - 印度卢比 VND - 越南盾 MNT - 蒙古图格里克 MYR - 马来西亚林吉特 NPR - 尼泊尔卢比 CZK - 捷克克朗 QAR - 卡塔尔里亚尔 ILS - 以色列新谢克尔 MXN - 墨西哥比索 HUF - 匈牙利福林 KWD - 科威特第纳尔 PKR - 巴基斯坦卢比 KHR - 柬埔寨瑞尔 BND - 文莱元 RSD - 塞尔维亚第纳尔 KZT - 哈萨克斯坦坚戈 PLN - 波兰兹罗提 RON - 罗马尼亚列伊 ZMW - 赞比亚克瓦查 MUR - 毛里求斯卢比 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
toCurrency	String	否	目标币种（通常为本位币） CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 NZD - 新西兰元 THB - 泰铢 MOP - 澳门币 CHF - 瑞士法郎 RUB - 俄罗斯卢布 IDR - 印度尼西亚卢比 AED - 阿联酋迪拉姆 TWD - 新台币 PHP - 菲律宾比索 ZAR - 南非兰特 SAR - 沙特里亚尔 BRL - 巴西雷亚尔 TRY - 土耳其里拉 INR - 印度卢比 VND - 越南盾 MNT - 蒙古图格里克 MYR - 马来西亚林吉特 NPR - 尼泊尔卢比 CZK - 捷克克朗 QAR - 卡塔尔里亚尔 ILS - 以色列新谢克尔 MXN - 墨西哥比索 HUF - 匈牙利福林 KWD - 科威特第纳尔 PKR - 巴基斯坦卢比 KHR - 柬埔寨瑞尔 BND - 文莱元 RSD - 塞尔维亚第纳尔 KZT - 哈萨克斯坦坚戈 PLN - 波兰兹罗提 RON - 罗马尼亚列伊 ZMW - 赞比亚克瓦查 MUR - 毛里求斯卢比 name - 币种中文名称 symbol - 币种货币符号 code - 获取币种代码（枚举名），用于序列化。
rateType	String	否	汇率类型 QUOTE - 报价汇率 BOOKKEEPING - 记账汇率 SETTLEMENT - 结算汇率
rate	Number	否	汇率：1 fromCurrency = rate toCurrency
effectiveDate	String	否	生效起始时刻
rateHistory	Object[]	否	结算汇率按写入顺序保存的数值历史。存量数据可以没有历史；此字段仅由服务端维护。
rateHistory.[].rate	Number	否	本次写入后的汇率
rateHistory.[].updatedAt	String	否	服务端记录本次写入的时刻
source	String	否	汇率数据来源（可选，由调用方提供）。
sourceUrl	String	否	汇率来源页面。
legalEntityId	String	否	法人主体id
customerId	String	否	客户id
extraProps	Object	否	扩展属性
crBy	String	否	创建者
upBy	String	否	最后修改者
crDate	String	否	创建时间
upDate	String	否	最后修改时间
tenantId	String	否	租户ID
id	Varies	否	提供汇率的存储标识，供通用持久化逻辑识别记录。

返回

成功处理的条数

2