Square 集成金蝶云星空解决方案

更新: 9/8/2026 字数: 0 字 时长: 0 分钟

业务背景

源系统	成集云	目标系统
Square（全球支付与门店 POS / 线上商城一体化平台）		金蝶云星空

企业使用 Square 作为线下门店收银、线上商城收款与商品目录管理的统一平台，覆盖 Payments（支付）、Orders（订单）、Catalog（商品目录）、Customers（客户）、Inventory（库存）、Locations（门店位置）等完整能力；使用金蝶云星空实现财务与供应链一体化核算。两套系统数据独立、流程割裂，导致：每笔门店/线上收款需人工整理后录入金蝶生成收款单，月底对账工作量大；Square 商品目录与金蝶物料双头维护，名称、编码、价格不一致；客户信息散落在 Square 中无法沉淀为金蝶客户主数据；退款、库存变动无法自动回写财务与供应链。通过成集云实现 Square 与金蝶云星空无缝集成，可自动完成基础资料与业务单据同步，打通"门店/线上交易 → 业财核算"的数据链路。

解决方案

基于成集云-数据集成平台构建可视化自动同步任务，对接 Square REST API v2（OAuth 2.0，生产环境 https://connect.squareup.com/v2/）与金蝶云星空开放 API，将 Square 的商品目录、客户、门店位置自动同步至金蝶云星空基础资料；将 Square 订单、支付、退款按规则自动生成金蝶销售订单、收款单、退款单，库存变动同步至金蝶库存，全流程自动化、规则化、无需人工干预。

业务流程

一、基础资料同步流程

1. 商品目录同步流程

2. 客户同步流程

3. 门店位置同步流程

---

二、业务单据同步流程

1. 销售订单同步流程

2. 收款同步流程

3. 退款同步流程

4. 库存同步流程

对接说明

一、基础资料同步（Square → 金蝶云星空）

1. Square 商品目录（Catalog Item / Item Variation）→ 金蝶云星空物料，按 SKU 匹配，目标状态：已审核
2. Square 客户（Customers，含姓名、邮箱、手机号、地址）→ 金蝶云星空客户，按邮箱/手机号去重，目标状态：已审核
3. Square 门店位置（Locations）→ 金蝶云星空仓库 / 门店部门，按 location_id 匹配组织，规则：[组织编码-门店名称]

二、业务单据同步（Square → 金蝶云星空）

1. Square 订单（Orders，含 line_items、金额、税额、折扣）→ 金蝶云星空销售订单，按门店位置对应组织，按客户匹配应收客户
2. Square 支付（Payments，含 source_type、金额、币种、状态）→ 金蝶云星空收款单，关联对应销售订单，按门店/结算账号匹配
3. Square 退款（Refunds）→ 金蝶云星空退款单，关联原销售订单与收款单
4. Square 库存变动（Inventory，含 counts、adjustments）→ 金蝶云星空库存更新 / 即时库存，按 SKU + 门店位置对应仓库

三、同步规则与过滤条件

1. 订单同步：仅同步 state = COMPLETED 或 state = OPEN 且已支付的订单，按 updated_at 增量
2. 支付同步：仅同步 status = COMPLETED 的支付，退款单独走退款流程，避免重复入账
3. 客户去重：以邮箱为主键，无邮箱则以手机号匹配，已存在客户不重复新建
4. 多门店映射：每个 Square Location 对应金蝶一个仓库/部门，交易数据与库存按门店隔离
5. 币种处理：Square 支持多币种，按订单 currency 映射金蝶对应币别，自动处理汇率
6. 同步频率：即时 / 单据发生时同步；支持全量初始化 + 增量日常同步（基于 Webhook 事件或定时拉取）
7. 同步方式：不汇总，按单生成，目标单据默认暂存，财务复核后审核

业务价值

• 基础资料统一：商品目录、客户、门店一次维护，Square 与金蝶两端同步一致，杜绝重复建档与编码错配
• 收款自动入账：门店 / 线上每一笔支付自动生成金蝶收款单，月底对账从数天缩短至分钟级
• 业财一体：交易数据实时流入财务系统，销售收入、退款、库存变动可追溯，核算及时准确
• 库存实时一致：Square 库存变动自动同步金蝶，线上线下库存一盘货，避免超卖与积压
• 多门店精细核算：按门店位置隔离组织与仓库，支撑连锁 / 多网点企业的分店独立核算
• 提升运营效率：大幅减少人工录单、整理收款、对账工作量，支撑企业规模化零售与跨境业务

接口文档

• Square Developer REST API v2 文档（Payments / Orders / Catalog / Customers / Inventory / Locations）：https://developer.squareup.com/reference/square
• 金蝶云星空开放 API 文档