Ecwid独立站集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Ecwid独立站 |  | 金蝶云星空 |
Ecwid（已被 Lightspeed 收购）是一款面向中小企业的 SaaS 电商建站平台，支持商家把店铺嵌入官网、社交媒体与多家市场平台，统一管理商品、订单、库存与客户。许多出海与跨境卖家以 Ecwid 作为轻量独立站前端，同时用金蝶云星空完成业财一体化核算。
两套系统数据独立、流程割裂，带来典型痛点：商品与库存需在 Ecwid 与金蝶两端重复维护，订单、收款、退款靠人工录单到财务系统，效率低、易错；库存不同步导致超卖；财务无法及时获取销售收入与应收，对账滞后。通过成集云对接 Ecwid 开放接口与金蝶云星空开放 API，可将商品、客户、订单、收款、退款、库存自动同步，真正实现"前端卖货、后端核算"一体化。
解决方案
基于成集云数据集成平台构建可视化自动同步任务，对接 Ecwid REST API v3 与金蝶云星空 Web API，将 Ecwid 基础资料（商品/客户/分类）自动同步至金蝶云星空，订单、收款、退款、库存事件按规则实时生成对应金蝶单据，全流程自动化、规则化、无需人工干预。
业务流程
一、基础资料同步流程
1. 商品同步流程
2. 客户同步流程
3. 商品分类同步流程
二、业务单据同步流程
1. 已支付订单同步流程
2. 收款同步流程
3. 退款/退货同步流程
4. 库存双向同步流程
5. 发货物流回写流程
对接说明
一、基础资料同步（Ecwid → 金蝶云星空）
- Ecwid 商品/变体（products、products/{id}/combinations） → 金蝶云星空物料，SKU 映射物料编码，变体属性映射辅助属性，目标状态：已审核
- Ecwid 客户（customers） → 金蝶云星空客户/联系人，邮箱映射客户编码，目标状态：已审核
- Ecwid 商品分类（categories） → 金蝶云星空商品分类，按分类名称匹配，避免重复建档
二、业务单据同步（Ecwid → 金蝶云星空）
- 订单（paymentStatus=PAID） → 金蝶云星空销售订单/应收单，订单明细映射销售明细，币种按店铺币种映射金蝶币别
- 收款（paymentStatus=PAID 且已支付） → 金蝶云星空收款单，并自动与应收单核销
- 退款（refund 状态/Cancelled 含退款） → 金蝶云星空红字应收单/销售退货单
- 库存（products/{id}/inventory、product.updated Webhook） → 金蝶云星空存货/库存余额，双向同步防超卖
- 发货（fulfillmentStatus=SHIPPED） → 金蝶云星空销售出库单，物流单号回写 Ecwid 订单
三、同步规则与过滤条件
- 订单：仅同步已支付（PAID）或已发货（SHIPPED）状态订单，过滤未支付/废弃购物车
- 库存：以 Ecwid 为库存主数据，金蝶库存变化（如其他出入库）按规则回写 Ecwid，避免双向覆盖冲突
- 币种：Ecwid 店铺币种 → 金蝶云星空币别，多店铺多币种分别建档
- 同步频率：Webhook 即时触发（order.created / order.updated / product.updated / customer.created）+ 每日全量初始化兜底
- 同步方式：按单生成，目标单据默认暂存，支持人工复核后审核
业务价值
- 基础资料统一：商品、客户、分类一次维护，两端同步一致，杜绝重复建档
- 业务流程自动化：订单、收款、退款、库存、发货自动生成金蝶单据，录单工作量下降约 80%
- 库存防超卖：前后端库存双向实时同步，降低超卖与缺货风险
- 业财一体化：电商销售收入与应收实时流入财务系统，核算及时、数据可追溯
- 对账高效：收款与应收自动核销，月度对账从数天缩短到小时级
- 轻量出海：Ecwid 独立站快速上线，财务核算无缝衔接，支撑中小企业规模化跨境经营
接口文档
- Ecwid REST API v3 文档（base
https://app.ecwid.com/api/v3/{storeId}，OAuth2 鉴权，覆盖 products / orders / customers / categories / inventory 与 Webhook 事件） - 金蝶云星空开放 API 文档（Web API / OpenAPI，覆盖物料、客户、销售订单、应收、收款、库存等）