乐天Rakuten Ichiba 集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Rakuten Ichiba（乐天市场） |  | 金蝶云星空 |
日本乐天市场（Rakuten Ichiba）是日本最大的综合电商市场之一，聚集数万家店铺，覆盖本土与跨境卖家。卖家的乐天店铺通过 Rakuten RMS（Merchant Server）API 管理商品、订单、发货、库存与客户消息。但乐天店铺的运营数据无法自动进入企业 ERP 系统——财务与仓储团队仍需手工把订单、收款、库存录入金蝶云星空，普遍存在四大痛点：
- 录单滞后：订单与物流单号需人工回填到 ERP，效率低且易漏单；
- 库存失真：多渠道发货后库存未同步回 ERP，导致超卖或备货误判；
- 多币种核算难：销售以日元（JPY）结算，平台佣金与手续费割裂，毛利分析失真；
- 退货逆向缺失：退货/取消订单无法自动冲回收入与库存，财务对账困难。
通过 成集云 iPaaS 数据集成平台，可将 Rakuten RMS 与金蝶云星空打通，实现"日本市场店铺 — 订单/库存 — 财务"一体化。
解决方案
基于成集云数据集成平台，以 Rakuten RMS（Merchant Server）API（License Key + 参数签名鉴权，base
https://api.rms.rakuten.co.jp）为数据源，拉取商品、订单、客户、库存与发货数据，并结合 RMS 订单/发货通知回调（callback）实现准实时推送；在成集云平台内完成 SKU 映射、客户归一、订单状态识别、物流单号回写、JPY 多币种折算与退货逆向处理后，自动写入金蝶云星空对应的销售订单、销售出库单、客户、物料、收款单与库存单据，形成"乐天店铺 → 订单履约 → 业财一体"的自动闭环。乐天商品目录（品类/规格）可辅以 Rakuten Web Services（RWS，App ID 鉴权）只读 API 进行选品与市场分析。
业务流程
一、基础资料同步流程
1. 商品/SKU 同步流程
2. 客户同步流程
二、业务单据同步流程
1. 销售订单同步流程
2. 发货/物流同步流程
3. 收款/结算同步流程
4. 退货逆向同步流程
5. 库存同步流程
对接说明
一、基础资料同步（Rakuten → 金蝶云星空）
- 商品/SKU：RMS item management API 返回商品与 SKU（
itemNumber/itemUrl），以itemNumber映射金蝶"物料"（物料编码 = SKU），名称、价格、分类同步更新。 - 客户：订单/客户接口返回买家，按邮箱 / 姓名匹配金蝶"客户"档案；未匹配则自动建档。
二、业务单据同步（Rakuten → 金蝶云星空）
- 销售订单：监听 RMS 订单通知回调（或增量拉取 order API），以
orderNumber生成金蝶"销售订单 / 应收单"，订单行按 SKU 匹配物料。 - 发货/物流：发货通知回调将物流单号（
shippingNumber）与承运商回写金蝶销售出库单"已发货"状态，触发库存扣减。 - 收款/结算：Rakuten 结算（settlement）按周期将销售入金、平台佣金、手续费明细同步为金蝶"收款单 / 银行流水"，JPY 多币种按汇率折算，平台佣金生成"费用单"归集。
- 退货逆向：退货 / 取消订单生成金蝶"红字应收 / 销售退货单"，逆向冲回收入与库存，保证业财一致。
- 库存回写：RMS inventory API 将各仓
quantity同步为金蝶"库存余额 / 存货"，避免超卖。
三、同步规则与过滤条件
- 仅同步指定乐天店铺（
shopUrl白名单）的订单，排除测试店铺与已作废订单。 - 以
orderNumber作为幂等键，重复事件不重复生成单据。 - 仅"可发货 / 已发货 / 已结算"状态订单进入 ERP；"买家取消"状态仅记录。
- 多币种：全部金额以 JPY 记账，按成集云汇率中心折算本位币（如 CNY/RMB），汇兑损益入凭证。
- 同步频率：通知回调准实时触发 + 每 15 分钟增量兜底轮询。
业务价值
- 订单与发货数据自动入金蝶，取消手工录单与物流单号回填，履约录入效率提升约 80%。
- 发货即回写物流单号与库存，库存可视、杜绝超卖。
- 乐天结算 / 平台佣金自动归集，多币种应收与毛利核算更精准。
- 退货逆向流程自动闭环，财务对账清晰、业财一致。
接口文档
- Rakuten RMS（Merchant Server）API：
https://webservice.rms.rakuten.co.jp/（License Key + 签名鉴权，商品/订单/发货/库存/客户消息） - Rakuten Web Services（RWS）：
https://webservice.rakuten.co.jp/documentation（App ID 只读，商品/品类/店铺目录） - 金蝶云星空 OpenAPI（销售订单 / 销售出库单 / 物料 / 客户 / 收款单 / 库存余额）