Recurly订阅计费集成金蝶云星空解决方案
更新: 10/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Recurly订阅计费系统 |  | 金蝶云星空ERP |
订阅制 SaaS、跨境电商、在线教育等出海企业普遍使用 Recurly 管理客户订阅、周期性出账与收款。财务团队需要把这些订阅合同、发票、收款同步到金蝶云星空做收入确认与对账。但两套系统割裂：财务每月底从 Recurly 后台手工导出 CSV，再在金蝶逐单录入应收与收款，耗时且易错；订阅状态变更（升级/降级/暂停/取消）无法实时反映到 ERP，经营看板里的 MRR/ARR 与流失率总是滞后。
解决方案
基于成集云 iPaaS 数据集成平台，通过 Recurly v3 REST API（HTTP Basic 鉴权，私有 API Key 作为用户名）+ Webhook 事件回调，构建可视化自动同步任务：账户 / 订阅 / 发票 / 交易实时拉取与增量监听，自动在金蝶云星空创建客户、应收单、收款单与凭证，订阅生命周期状态回写，实现订阅收入业财一体化。
业务流程
一、基础资料同步流程
1. 客户（账户）同步流程
2. 产品目录（计划/附加项）同步流程
二、业务单据同步流程
1. 订阅（销售/应收合同）同步流程
2. 发票（应收单）同步流程
3. 收款（交易）同步与核销流程
4. 退款/红冲同步流程
对接说明
一、基础资料同步（Recurly → 金蝶云星空）
- 账户 Account → 客户：
account_code（唯一客户编码）、email、first_name/last_name（客户名称）、company（公司名）映射为客户编码与名称；地址信息映射客户联系地址。 - 计划 Plan / 附加项 Add-on → 物料：
plan_code/name（物料编码/名称）、unit_amount（标准售价）、currency（币别）、计费周期作为物料备注。 - 同步方式：定时全量 + 新增账户/计划的 Webhook（
new_account_notification、updated_account_notification）增量触发；通过Accept: application/vnd.recurly.{version}+json固定 API 版本，避免接口契约漂移。
二、业务单据同步（Recurly → 金蝶云星空）
- 订阅 Subscription → 销售/应收合同：
state（active/paused/canceled/expired/future）映射合同状态；current_period_start/end映射合同起止；plan + quantity映射合同明细；自动续期写入下一期。 - 发票 Invoice → 应收单/销售发票：
invoice_number、subtotal、tax、total、currency、created_at映射应收单金额与税额；line items映射应收明细；state（pending/paid/past_due/closed）映射审核状态。 - 交易 Transaction（成功）→ 收款单：
uuid、关联invoice、amount、currency、created_at映射收款单；在金蝶内对已挂应收自动核销。 - 退款/红字 Credit Invoice → 红字应收/退款单：
refund、credit_invoice金额映射红冲单据，关联原应收做负向冲销。 - 多币种：Recurly 发票
currency（USD/EUR/GBP 等）→ 金蝶币别与汇率方案，按交易日折算本位币。
三、同步规则与过滤条件
- 触发方式：Webhook 实时（
new_invoice_notification、processing_invoice_notification、closed_invoice_notification、new_transaction_notification、failed_transaction_notification、new_subscription_notification、canceled_subscription_notification等）+ 每日定时补偿拉取（防漏单）。 - 过滤条件：仅同步
state=active/past_due的订阅、state=paid/closed的发票、status=success的交易；沙箱 site 数据不进生产。 - 幂等去重：以 Recurly
account_code、invoice_number、transaction uuid为主键，重复推送仅更新不新增。 - 频率控制：Recurly 限频 1400 次/分钟/site，成集云做批量聚合与退避重试，避免触发 429。
业务价值
- 订阅收入自动入账：订阅合同、周期性发票、收款自动同步金蝶，财务不再月底手工导出录单，效率提升约 80%。
- 业财一致：收款自动核销应收，红冲自动冲销，对账差异趋近于零。
- 订阅状态可视：升级/降级/暂停/取消实时回写 ERP，经营看板可随时掌握 MRR/ARR 与流失。
- 多币种合规：原币 + 本位币双记，满足跨境订阅收入核算与税务要求。
接口文档
- Recurly v3 REST API：
https://v3.recurly.com（HTTP Basic 私有 API Key 鉴权，Webhooks） - 金蝶云星空 OpenAPI（客户 / 物料 / 销售合同 / 应收单 / 收款单 / 凭证）