Lightspeed Retail 集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Lightspeed Retail |  | 金蝶云星空 |
连锁零售、品牌门店与跨境电商卖家广泛使用 Lightspeed Retail（原 Vend，X-Series / R-Series）作为门店 POS 与电商一体化管理系统，处理商品、会员、销售、库存与采购。但 Lightspeed 与后端的财务核算系统（金蝶云星空）相互独立，带来以下痛点：
- 数据割裂：门店销售、退货、库存与采购数据停留在 Lightspeed，财务需手工汇总数十家门店日报再录单；
- 核算滞后：收入、成本与库存价值无法实时反映，经营报表滞后到"周级"；
- 对账困难：前端零售与后端财务跨系统对账，差错率高、追溯慢。
通过 成集云 iPaaS 数据集成平台，可将 Lightspeed Retail 与金蝶云星空打通，实现"门店业务 → 财务核算"的自动同步。
解决方案
基于成集云数据集成平台，以 Lightspeed Retail API（REST，OAuth2 / Bearer）为数据源，拉取商品、客户、销售、库存与采购订单；结合 Lightspeed Webhook（
sale.created/product.updated/inventory.update/customer.created等事件）实现准实时推送；在成集云平台完成商品 / SKU 映射、客户归一、价格与税率换算、仓库与库存组织映射后，自动写入金蝶云星空对应物料、客户、销售订单、应收、收款单、存货与采购订单，形成零售业务到财务的一体化闭环。
业务流程
一、基础资料同步流程
1. 商品 / 物料同步流程
2. 客户同步流程
二、业务单据同步流程
1. 门店销售同步流程
2. 收款同步流程
3. 库存同步流程
4. 采购订单同步流程
对接说明
一、基础资料同步（Lightspeed → 金蝶云星空）
- 商品 / SKU：Lightspeed
GET /API/V3/Account/{accountID}/Product及其 Variant，按 SKU 编码映射金蝶"物料"（含规格、零售价、成本）。 - 客户 / 会员：
GET .../Customer，按邮箱 / 手机号匹配金蝶"客户"档案，未匹配自动建档。
二、业务单据同步（Lightspeed → 金蝶云星空）
- 门店销售：监听 Webhook
sale.created（或 Sale 增量），按门店生成金蝶"销售订单 / 应收单"，含税金额自动拆分。 - 收款：销售关联的支付（payment）生成金蝶"收款单"，按收银方式映射结算科目。
- 退货：负销售（refund / return）生成红字销售订单 / 销售退货单。
- 库存：
ItemShop.qoh（按shopID拆分仓）经inventory.update事件更新金蝶"存货 / 库存余额"，shopID=0为全仓汇总。 - 采购：
Order（type=purchase）生成金蝶"采购订单"，收货后生成采购入库与应付单。
三、同步规则与过滤条件
- 以 Lightspeed
productID/saleID/orderID作为幂等键，防止重复入账。 - 仅同步指定门店（outlet / shop）范围，排除测试门店。
- 已完成（completed）销售才生成正式单据；挂单（layby / layaway）仅记录不入账。
- 同步频率：Webhook 准实时触发 + 每 10 分钟增量兜底（以
timeStamp字段增量拉取）。
业务价值
- 多门店销售、库存、采购数据自动汇总进金蝶，取消门店日报手工上报与录单，效率提升约 80%。
- 库存实时同步，财务即时掌握各门店存货价值与成本，支撑精准毛利核算。
- 销售 — 收款 — 退货 — 采购全链路业财一体，对账差错率显著下降。
- 业务数据驱动财务核算，经营报表从"周级"提速到"准实时"。
接口文档
- Lightspeed Retail API（X-Series）：
https://x-series-api.lightspeedhq.com/（REST，OAuth2 / Bearer，basehttps://api.lightspeedapp.com/API/V3/） - Lightspeed Retail R-Series：
https://developers.lightspeedhq.com/retail/（Account / Sale / Product / Customer / Inventory / PurchaseOrder） - Webhook 事件：
sale.created、product.updated、inventory.update、customer.created等 - 金蝶云星空 OpenAPI（开放接口）：物料 / 客户 / 销售订单 / 应收 / 收款单 / 存货 / 采购订单等