VTEX电商中台集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| VTEX电商中台 OMS |  | 金蝶云星空 |
VTEX 是面向中大型品牌与零售商的电商中台（OMS），承载商品目录、订单、库存、定价与客户主数据，被众多跨境与全球化品牌用于统一运营多店铺、多市场。当企业通过 VTEX 开展线上销售时，订单、库存、收款等海量业务数据沉淀在 VTEX，而财务核算、供应链与成本却发生在金蝶云星空，两套系统割裂导致：订单收款与应收脱节、库存账与财务账不一致、发货物流无法回写、月末对账人力沉重。
借助成集云 iPaaS 数据集成平台，将 VTEX 的商品、客户、订单、库存、收款、发货等数据自动同步至金蝶云星空，并以订单事件驱动财务与供应链单据，实现「电商前端—业财后端」一体化。
解决方案
基于成集云数据集成平台，通过 VTEX 开放 API（AppKey + AppToken 鉴权，支持 Feed 轮询与 Hook 推送）订阅订单、库存与发货事件，在成集云中构建可视化自动同步任务，将 VTEX 数据映射为金蝶云星空中的物料、客户、销售订单、应收单、收款单、库存与销售出库单，形成端到端自动化链路。
业务流程
一、基础资料同步流程
1. 商品与 SKU 同步流程
2. 客户同步流程
二、订单与收款同步流程
1. 销售订单同步流程
2. 收款同步流程
三、库存与发货同步流程
1. 库存双向同步流程
2. 发货与物流回写流程
四、逆向流程
1. 退款与退货流程
对接说明
一、基础资料同步（VTEX → 金蝶云星空）
| VTEX 对象 | 金蝶云星空对象 | 映射说明 |
|---|---|---|
| Product / SKU | 物料（含辅助属性） | SKU 作为物料编码，规格属性映射到辅助属性 |
| Brand / Category | 物料分组、商品分类 | 用于财务与供应链分类统计 |
| Master Data 客户 | 客户、联系人 | 客户主数据建档，避免重复下单 |
| Price / Price Table | 销售价格表（可选） | 用于财务收入确认参考 |
二、业务单据同步（VTEX → 金蝶云星空）
| VTEX 事件 | 金蝶云星空单据 | 说明 |
|---|---|---|
| 订单 payment-approved | 销售订单、应收单 | 按订单行生成销售订单与应收，税与运费分摊 |
| Transaction 成功 | 收款单 | 按支付金额生成收款单并自动核销应收 |
| 库存变更 Inventory | 库存余额 | 多仓库库存实时同步，防止超卖 |
| 发货 invoice + tracking | 销售出库单 | 生成出库单并回写物流单号至 VTEX |
| 取消 / 退款 | 红字应收、销售退货单 | 保持财务账与订单状态一致 |
三、回写与反向同步（金蝶云星空 → VTEX）
- 金蝶云星空的商品、价格、库存变更可经成集云回写 VTEX Catalog、Pricing、Logistics API，保证前端库存与后端一致。
- 金蝶生成的发货物流单号回写 VTEX 订单，驱动买家端物流追踪。
四、同步规则与过滤条件
- 订单同步：以订单状态 payment-approved 为触发点，使用 Orders API Feed（轮询）或 Hook（推送）捕获增量。
- 库存同步：按 SKU + 仓库维度同步，仅同步启用销售的仓库。
- 币种与税：按 VTEX 订单币种与税率映射到金蝶对应币别与税金科目。
- 去重：以 VTEX Order ID 为唯一键，重复事件幂等处理。
业务价值
- 订单到应收自动生成，财务不再手工录单，订单处理时效从小时级降至分钟级。
- 库存双向同步，线上线下库存一致，杜绝超卖与缺货。
- 发货物流单号回写，买家体验提升，售后纠纷下降。
- 业财一体：销售、收款、出库、退款在金蝶云星空闭环，月末对账自动化。
接口文档
- VTEX 开发者文档（Catalog、Orders、Logistics、Pricing、Master Data API）：https://developers.vtex.com
- VTEX ERP 后台集成指南：https://help.vtex.com/tutorial/integration-guide-for-erps
- 金蝶云星空开放 API 文档（物料、客户、销售订单、应收、收付款、库存、出库）