Paddle集成金蝶云星空（SaaS订阅计费）解决方案
更新: 9/13/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Paddle（Merchant of Record 订阅计费平台） |  | 金蝶云星空 |
越来越多的软件和 SaaS 企业选择 Paddle 作为 Merchant of Record（交易代理方），由 Paddle 统一处理海外订阅计费、全球销售税合规、支付收单与欺诈风控，企业只需关注产品与增长。但 Paddle 并不承担企业内部的会计核算职能——收入确认、应收账款、开票与回款仍须在 金蝶云星空 中完成，以满足中国准则下的账务与税务管理要求。
典型痛点：
- 收入游离在 ERP 之外：Paddle 侧的订阅、续费、账单、退款每天发生，财务却要在月底手工导出 CSV，逐笔在金蝶录应收单，工作量大且易漏。
- 多币种与税处理难对齐：Paddle 以 USD/EUR/GBP 等多币种结算并自动代扣代缴各国销售税，金蝶需按本位币折算并区分"含税收入"与"代征税金"，手工换算极易出错。
- 业财口径不一致：销售团队看 Paddle 后台的 MRR/活跃订阅，财务看金蝶的应收余额，双方对账靠人肉 Excel，月底结账反复扯皮。
- 审计追溯困难：Paddle 交易与金蝶凭证缺乏主键关联，审计时无法一键还原"某笔账单对应哪张应收单"。
解决方案
基于成集云数据集成平台，通过 Paddle Billing REST API（OAuth/API Key 鉴权）拉取客户、产品、价格、订阅、交易与调整数据，并以 Paddle 通知（Webhook）实时驱动增量同步；在成集云中以"Paddle 实体主键 ↔ 金蝶单据号"建立映射与去重规则，将标准化的主数据与业务单据写入金蝶云星空，实现订阅计费到业财核算的自动化闭环，无需在两端写代码。
业务流程
一、基础资料同步流程
1. 客户与产品同步流程
2. 价格与销售价目表同步流程
二、订阅与交易同步流程
1. 订阅同步销售合同流程
2. 已完成账单同步应收流程
3. 调整单（退款/红冲）同步流程
4. 结算付款同步收款流程
对接说明
一、基础资料同步（Paddle → 金蝶）
| Paddle 对象 | 关键字段 | 金蝶目标 | 同步方式 |
|---|---|---|---|
| Customers | id、name、email、address、business | 客户/往来单位 | 全量+增量（按 updated_at） |
| Products | id、name、tax_category | 物料（服务类） | 创建/变更事件触发 |
| Prices | id、product_id、unit_price、currency | 销售价目表/物料清单 | 创建/变更事件触发 |
- 主键映射：以 Paddle
customer_id/product_id作为金蝶"外部编码"，避免重复建档。 - 多币种：Paddle 返回
currency_code（USD/EUR/GBP 等），成集云按企业设定的汇率方案折算为本位币写入金蝶。
二、业务单据同步（Paddle → 金蝶）
| Paddle 对象 | 触发事件 | 金蝶目标单据 | 说明 |
|---|---|---|---|
| Subscription | subscription.created / updated / canceled | 销售合同 / 服务收入计划 | 订阅周期映射合同起止与收入分摊 |
| Transaction | transaction.completed / billed | 应收单 / 销售发票 | 含税金额拆分"收入"与"代征销售税" |
| Adjustment | adjustment.created（refund/credit） | 应收红冲 / 退款单 | 与原交易主键关联冲销 |
| Payout | payout.created / paid | 收款单 / 银行流水 | 结算金额与已收对齐 |
三、同步规则与过滤条件
- 增量触发：优先消费 Paddle 通知（Notification）事件，保证秒级增量；辅以每小时间隔轮询
updated_at兜底，防止漏单。 - 去重与幂等：以 Paddle 主键（txn_/sub_/ctm_ 前缀）做唯一键，重复通知自动跳过，保证金蝶单据不重复生成。
- 币种与税分离：交易总额按 Paddle 返回的
details.tax拆分为"应税收入"与"代扣代缴税"，金蝶侧分别入账，满足合规口径。 - 失败重试：单据生成失败时进入成集云异常队列，支持人工修正后重跑，不影响后续消息。
业务价值
- 收入自动入账：订阅、续费、一次性收费实时生成金蝶应收单，财务录单工作量下降约 80%，月结时间从 3–5 天缩短至 1 天内。
- 业财口径统一：销售看 Paddle 的 MRR，财务看金蝶的应收，双方以同一主键对账，差异自动可追溯。
- 多币种与税务合规：USD/EUR/GBP 自动折算本位币，代征销售税单独列示，降低跨境财税错报风险。
- 审计可追溯：每笔金蝶应收/收款单留存 Paddle 交易号，审计一键还原全链路。
接口文档
- Paddle Billing REST API（
https://api.paddle.com，Bearer API Key 鉴权）：Products / Prices / Customers / Subscriptions / Transactions / Adjustments / Notifications（Webhook） - 金蝶云星空开放 API（Web API）：客户、物料、销售价目表、销售合同、应收单、收款单、销售发票
- 成集云 iPaaS 连接器：Paddle 源连接器 + 金蝶云星空目标连接器，支持字段映射与调度编排