Squarespace 独立站电商集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Squarespace 独立站（Commerce） |  | 金蝶云星空 ERP |
品牌出海与跨境电商团队常用 Squarespace 搭建品牌独立站，借助其 Commerce 模块管理商品、订单、库存与交易。但独立站的前台经营数据与金蝶云星空的后端财务/供应链长期割裂：
- 订单手工录单：Squarspace 产生的新订单需财务在金蝶逐单录入销售订单/应收，效率低且易错。
- 库存不同步：独立站销量与金蝶库存"各算各的"，超卖、缺货频发。
- 收款难对账：支付、退款、手续费、税费散落在 Squarespace Transactions，与金蝶收款单、红字应收无法自动勾稽。
- 客户主数据缺失：独立站买家（Profiles）未进入 ERP，复购分析、会员运营缺乏数据底座。
基于成集云数据集成平台，通过 Squarespace Commerce API 与 Webhook，将商品、订单、库存、交易、客户实时同步至金蝶云星空，实现"独立站经营—ERP 财务供应链"一体化。
解决方案
基于成集云 iPaaS 数据集成平台，通过 Squarespace Commerce REST API（
https://api.squarespace.com/1.0，Bearer Token 鉴权）拉取商品/订单/库存/交易/客户，并订阅站点 Webhook 实时接收order.create、transaction.create、inventory.update等事件；在成集云控制台配置字段映射与校验规则，自动生成金蝶物料、销售订单、应收单、收款单与库存调整，全程可视化、可监控、可重跑。
业务流程
一、基础资料同步流程
1. 商品同步流程
2. 客户同步流程
二、业务单据同步流程
1. 销售订单同步流程
2. 收款/交易同步流程
3. 库存同步流程
对接说明
一、基础资料同步（源 → 目标）
| Squarespace 对象 | 关键字段 | 金蝶云星空目标 | 说明 |
|---|---|---|---|
| Products 商品 | type（PHYSICAL/DIGITAL/SERVICE/GIFT_CARD）、variants.sku、pricing、stock | 物料（商品）/ 商品 BOM | 变体级 SKU 映射为物料编码 |
| Profiles 客户档案 | email、姓名、地址 | 客户 / 联系人 | 买家主数据统一入账 |
二、业务单据同步（源 → 目标）
| Squarespace 对象 | 金蝶云星空目标 | 触发方式 |
|---|---|---|
| Orders 订单（含 line items、fulfillmentStatus） | 销售订单 / 销售出库单 / 应收单 | Webhook order.create、order.update |
| Transactions 交易（payments/refunds/fees/taxes） | 收款单 / 红字应收 / 费用 | Webhook transaction.create、transaction.update |
| Inventory 库存（变体级数量） | 存货 / 库存余额调整 | Webhook inventory.update |
| Products 商品变更 | 物料更新 | Webhook product.create/update/delete |
三、同步规则与过滤条件
- 鉴权：Squarespace Commerce API 使用
Authorization: Bearer <API Key 或 OAuth Token>；OAuth 范围需包含website.orders、website.transactions.read、website.inventory、website.products（Profiles 需字段凭证方式访问）。 - 增量策略：订单按
modifiedAfter时间游标分页增量拉取；实时事件统一由 Webhook Subscriptions（/webhooks）推送至成集云端点。 - Webhook 事件主题：
order.create、order.update、transaction.create、transaction.update、inventory.update、product.create、product.update、product.delete。 - 状态映射：订单
fulfillmentStatus（PENDING/FULFILLED/CANCELED）映射为金蝶销售订单的"未发货/已发货/已取消"；退款交易生成红字应收并冲销原收款。 - 幂等保障：订单/交易以平台
id为唯一键去重，网络重试不产生重复单据；库存变更走增量（INCREMENT/DECREMENT）而非全量覆盖，避免冲掉其他渠道库存。 - 多币种：独立站外币交易按金蝶汇率方案折算为本位币，保留原币金额。
业务价值
- 免录单：独立站订单、收款、退款自动生成 ERP 单据，财务录单工作量下降 80%+。
- 库存精准：变体级库存双向同步，杜绝超卖缺货，提升履约体验。
- 对账高效：交易（含手续费、税费、退款）自动勾稽，月结时间从数天缩短至小时级。
- 客户资产化：独立站买家进入 ERP，支撑复购分析、会员运营与业财一体。
接口文档
- Squarespace Commerce API 开发者文档：
https://developers.squarespace.com/commerce-apis/overview（Orders / Products / Inventory / Transactions / Profiles / Webhooks） - 金蝶云星空 OpenAPI 集成文档（成集云已封装标准连接器）