万里汇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 对象 | 关键字段 | 金蝶云星空对象 | 映射说明 |
|---|---|---|---|
| 来帐通知 notifyVostro | accountingBizNo、transactionId、amount | 收款单 AP_ReceiveBill | 按 transactionId 幂等入账 |
| 账务账单 inquiryStatementDetail | accountingBizNo、detail | 对账明细 | 与收款单按流水号勾对 |
| 交易订单 submitTradeOrder | order_id、status | 收付款单 | 失败/成功状态回写 |
| 结汇成交 createExchange | rate、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 获取访问凭证。
- Web API:
四、同步规则与过滤条件
- 触发方式:来帐、交易结果采用 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 / 表单服务)

