FreeAgent集成金蝶云星空解决方案
更新: 10/14/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| FreeAgent云端会计平台 |  | 金蝶云星空ERP |
以专业服务、咨询、设计及小微出海企业为代表，团队普遍使用 FreeAgent 进行开票、记账、银行对账、费用与项目管理；而集团层面的业财一体、合并报表、预算与多组织核算集中在 金蝶云星空。两套系统各自为政时，往往出现以下痛点：
- FreeAgent 开具的销售发票与收款状态无法同步金蝶，财务需手工二次录入应收单与收款单，重复劳动且易错；
- 银行流水停留在 FreeAgent，金蝶无法自动生成银行日记账与收款/付款单，资金对账依赖人工导出；
- 供应商账单、费用报销散落在 FreeAgent，金蝶应付与费用归集滞后，三单匹配难以落地；
- 多币种账户余额、汇兑损益需手工折算，缺乏统一口径，集团资金看板失真。
通过 成集云 iPaaS 数据集成平台，将 FreeAgent 与金蝶云星空打通，实现"发票/收款自动入应收、银行流水自动对账、费用/退款自动归集"的业财税银一体。
解决方案
基于成集云数据集成平台，构建 FreeAgent 与金蝶云星空之间的可视化自动同步任务：以 FreeAgent 为前端开票、记账与银行流水入口，金蝶为业财核算与资金中枢。成集云通过 FreeAgent REST API v2（OAuth 2.0 Bearer）与金蝶云星空 OpenAPI 双向编排，支持按
updated_since定时增量与 Webhook 事件触发，统一字段映射、币种折算与单位换算，保障两端数据一致、可追溯。
业务流程
一、基础资料同步流程
1. 客户与供应商同步流程
FreeAgent 联系人（按 contact_type 区分 Customer / Supplier）映射到金蝶客户与供应商主数据，避免重复建档。
2. 账户与员工同步流程
FreeAgent 银行账户（bank_accounts）与用户映射到金蝶银行账户与员工，为流水与费用归集做准备。
二、业务单据同步流程
1. 发票与收款同步流程
FreeAgent 销售发票（status: Sent / Paid）同步金蝶应收单/销售发票；支付成功触发收款单与自动核销。
2. 银行流水对账流程
FreeAgent 银行流水（bank_transactions，含 transaction_id）按账户同步金蝶，生成银行日记账并对账，transaction_id 作为唯一对账键防重。
3. 费用与退款归集流程
FreeAgent 费用（expenses）、红字票据（credit_notes）同步金蝶费用报销单/红字应收，完成成本与退票归集。
对接说明
一、基础资料同步（FreeAgent → 金蝶）
| 数据对象 | FreeAgent | 金蝶云星空 | 方向 |
|---|---|---|---|
| 客户 | Contacts（contact_type: Customer） | 客户 | FreeAgent → 金蝶 |
| 供应商 | Contacts（contact_type: Supplier） | 供应商 | FreeAgent → 金蝶 |
| 银行账户 | bank_accounts | 银行账户、币别 | FreeAgent → 金蝶 |
| 员工 | Users | 员工、业务员 | FreeAgent → 金蝶 |
二、业务单据同步（FreeAgent → 金蝶）
| 业务单据 | FreeAgent | 金蝶云星空 | 方向 |
|---|---|---|---|
| 销售发票 | invoices（status: Sent/Paid） | 应收单、销售发票 | FreeAgent → 金蝶 |
| 收款 | invoice paid 状态 | 收款单、核销 | FreeAgent → 金蝶 |
| 银行流水 | bank_transactions（transaction_id） | 银行日记账、收付款单 | FreeAgent → 金蝶 |
| 费用 | expenses | 费用报销单、费用归集 | FreeAgent → 金蝶 |
| 红字票据 | credit_notes | 红字应收、销售退货 | FreeAgent → 金蝶 |
三、同步规则与过滤条件
- 触发方式：按
updated_since每 15 分钟增量拉取（FreeAgent 速率限制 120 次/分钟、3600 次/小时，成集云做令牌桶限流）；关键状态变更可结合 Webhook 近实时触发。 - 字段映射：FreeAgent
contact.url关联金蝶客户/供应商主键（幂等键）；invoice.id关联应收单；bank_transaction的transaction_id（fit_id）作为银行流水对账唯一键；bank_account.url关联金蝶银行账户。 - 去重与幂等：以 FreeAgent 资源 URL + 金蝶单据编号做幂等键，状态更新只改不重建；银行流水以
transaction_id去重，避免重复入账。 - 安全校验：OAuth 2.0 凭据（client_id / client_secret / refresh_token）统一托管于成集云密钥库，自动刷新 access_token。
- 币种与折算：FreeAgent 多币种账户余额、流水按金蝶币别与当期汇率折算，汇兑损益自动归集。
- 异常处理：发票/流水写入失败自动重试并告警；无法匹配客户或账户的流水进入待处理队列，由财务补录映射。
业务价值
- 开票到收款闭环：FreeAgent 发票与收款状态自动同步金蝶，财务无需二次录单，单笔入账时间从小时级降至分钟级。
- 银企自动对账：银行流水按
transaction_id唯一键对账，杜绝重复入账，资金看板实时准确。 - 业财税一体：销售发票、费用、红字票据统一归集金蝶，应收应付与成本口径一致。
- 多币种透明：多币种账户余额与流水按统一汇率折算，集团资金与汇兑损益一目了然。
- 主数据统一：客户/供应商/银行账户双向对齐，消除"两套台账、两个余额"的混乱。
接口文档
- FreeAgent REST API v2（Contacts / Invoices / Bank Accounts / Bank Transactions / Expenses / Credit Notes）：
https://dev.freeagent.com/ - 金蝶云星空 OpenAPI（客户、供应商、银行账户、应收单、收款单、费用单、银行日记账）：金蝶云星空开放平台