Skip to content

万里汇WorldFirst跨境收款集成金蝶云星空解决方案 ​

更新: 11/12/2026 字数: 0 字 时长: 0 分钟

业务背景 ​

源系统成集云目标系统
万里汇WorldFirst金蝶云星空

万里汇 WorldFirst(蚂蚁国际旗下)是跨境贸易企业广泛使用的全球收款与外汇结算平台,提供多币种收款账户、来帐通知、交易订单提交、外汇报价与结汇、账单与文件下载等能力,服务外贸 B2B、跨境电商与平台卖家。

财务在日常资金管理中需要把 WorldFirst 侧的账户余额、来帐流水、账单明细、结汇与付款结果同步进 金蝶云星空,用于收款单制单、多币种核算、银行对账与资金分析。在未打通系统前,企业通常存在以下困扰:

  • 账单导出靠人工:财务在 WorldFirst 开发者平台或后台下载对账单,再逐行录入金蝶,工作量大且易错。
  • 来帐与业务脱节:买家汇款(来帐 Vostro)入账后,无法自动关联金蝶里的销售订单或应收单,对账需跨系统翻找。
  • 结汇损益核算滞后:外汇报价、结汇成交汇率散落在 WorldFirst,财务无法及时在金蝶体现汇兑损益,影响利润核算时效。
  • 多账户多币种难统一:一个主体可能持有多个 WorldFirst 收款账户,分别对接不同平台与币种,缺少统一的资金视图。

借助 成集云 iPaaS 数据集成平台,可将 WorldFirst 的账户、来帐、账单、结汇与交易数据按规则自动化写入 金蝶云星空,形成"跨境收款入账—自动制单—多币种核算—资金对账"的闭环。

解决方案 ​

基于成集云数据集成平台,搭建 WorldFirst 与金蝶云星空之间的可视化集成管道。平台通过 WorldFirst 开发者平台开放 API(账户、账单、交易订单、外汇、文件下载,OAuth 获取访问令牌 + RSA256 签名)拉取源数据,经字段映射、币种折算与规则校验后,调用金蝶云星空 Web API 自动生成收款单、更新银行账户并沉淀对账明细;同时订阅 WorldFirst 的来帐与交易结果回调,实现近实时入账。

业务流程 ​

一、基础资料同步流程 ​

1. 账户与余额同步流程 ​

2. 收款人与币别同步流程 ​

二、业务单据同步流程 ​

1. 来帐收款同步流程 ​

2. 结汇与交易同步流程 ​

3. 资金对账单同步流程 ​

对接说明 ​

一、基础资料同步(WorldFirst → 金蝶云星空) ​

WorldFirst 对象关键字段金蝶云星空对象映射说明
收款账户account_id、currency银行账户 CN_BankAccount按账户+币种建立银行档案
账户余额balance、currency资金余额/银行账户余额定时刷新可用资金
收款人模板beneficiary_name、country往来单位关联客户/供应商档案
币别currency(USD/EUR/GBP…)币别 BD_Currency自动创建缺失币别

二、业务单据同步(WorldFirst → 金蝶云星空) ​

WorldFirst 对象关键字段金蝶云星空对象映射说明
来帐通知 notifyVostroaccountingBizNo、transactionId、amount收款单 AP_ReceiveBill按 transactionId 幂等入账
账务账单 inquiryStatementDetailaccountingBizNo、detail对账明细与收款单按流水号勾对
交易订单 submitTradeOrderorder_id、status收付款单失败/成功状态回写
结汇成交 createExchangerate、amount收付款单 + 汇兑损益结汇汇率与损益入账

三、接口与鉴权说明 ​

  • WorldFirst 开发者平台
    • 文档中心:developers.worldfirst.com.cn,提供企业服务(Enterprise Service)与 World Card 两套 API。
    • 账户管理:inquiryAccount、inquiryBalance、inquiryAvailableQuota。
    • 账单管理:inquiryStatementList、inquiryStatementDetail。
    • 收款人管理:inquiryBeneficiaryTemplate、bindBeneficiary、inquiryBeneficiaryList。
    • 交易订单:submitTradeOrder、inquiryTradeOrder、notifyTradeOrder。
    • 外汇:inquiryRate、createQuote、createExchange、inquiryExchange。
    • 文件下载:prepareDownload、queryDownload。
    • 回调方向:来帐通知、余额变动、交易结果、账单下载结果均由 WorldFirst 主动推送至集成商提供的回调地址。
    • 鉴权方式:OAuth 获取访问令牌(POST /amsin/api/v1/oauth/applyToken),请求头采用 Client-Id + Signature: algorithm=RSA256, keyVersion=2, signature=... + Request-Time + Access-Token,报文为 JSON。
  • 金蝶云星空开放接口
    • Web API:/k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save,覆盖收款单、收付款单、币别、汇率、银行账户、往来单位等表单。
    • 鉴权:应用级 AppKey + AppSecret + 用户令牌,OAuth2 获取访问凭证。

四、同步规则与过滤条件 ​

  • 触发方式:来帐、交易结果采用 WorldFirst 回调(Webhook)近实时写入;账户余额、账单明细采用定时增量拉取兜底,确保不漏单。
  • 币种过滤:仅同步金蝶已启用币别范围内的流水,未启用币别自动建档并告警。
  • 幂等策略:以 transactionId / accountingBizNo 为唯一键,重复回调自动跳过,避免重复生成收款单。
  • 精度与汇率:金额按 WorldFirst 原始最小币种单位拉取,结汇损益采用成交汇率 rate 折算,与金蝶汇率表一致,保证汇兑损益可溯源。

业务价值 ​

  • 入账效率提升 80%:来帐与账单从手工下载录入转为回调+增量自动同步,跨境回款分钟级入账。
  • 资金视图统一:多 WorldFirst 账户、多币种余额在金蝶内集中呈现,管理层随时掌握可用资金与在途结算。
  • 汇兑损益实时可溯:结汇成交汇率与损益自动入账,利润核算时效从 T+数日提升至 T+0。
  • 对账零差错:每笔收款单均保留 WorldFirst 交易号与账单流水号,勾对留痕,满足跨境资金合规与审计。
  • 业财一体延伸:收款单可关联销售订单与应收,支撑后续核销、认领与多平台销售汇总分析。

接口文档 ​

  • 万里汇 WorldFirst 开发者平台:https://developers.worldfirst.com.cn/
  • WorldFirst 企业服务 API 列表:https://developers.worldfirst.com.cn/docs/alipay-worldfirst/worldfirst_enterprise_service/api_list
  • 万里汇官网:https://www.worldfirst.com.cn
  • 金蝶云星空开放 API 文档(Web API / 表单服务)