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

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

业务背景

源系统	成集云	目标系统
FreshBooks		金蝶云星空

FreshBooks 是海外广受欢迎的云端记账与发票管理软件，主要服务于中小企业、自由职业者及专业服务机构，覆盖客户管理、商品/服务目录、发票开具、收付款、费用报销与日记账等完整记账闭环。国内成长型企业、跨境服务团队、对外承接海外业务的公司，往往用 FreshBooks 管理海外客户的应收、开票与费用，同时用金蝶云星空实现集团级业财一体化核算。

两套系统数据彼此独立、流程割裂：客户与商品在两套系统重复维护，发票、收款、费用需人工从 FreshBooks 抄录到金蝶生成应收单、收款单与凭证，月底对账繁琐、易错、滞后，财务无法实时掌握海外业务经营状况。通过成集云将 FreshBooks 与金蝶云星空打通，可自动完成基础资料与业务单据同步，实现海外记账业务与财务核算一体化。

解决方案

基于成集云-数据集成平台构建可视化自动同步任务，对接 FreshBooks 开放 API（OAuth 2.0，REST，base https://api.freshbooks.com）与金蝶云星空开放 API，将 FreshBooks 的客户、商品/服务、发票、收款、费用、日记账等数据按规则自动同步至金蝶云星空，自动生成客户、物料、应收单、收款单、费用报销单与会计凭证，全流程自动化、规则化、无需人工干预。

业务流程

一、基础资料同步流程

1. 客户同步流程

2. 商品/服务同步流程

---

二、业务单据同步流程

1. 发票同步流程

2. 收款同步流程

3. 费用报销同步流程

4. 日记账同步流程

5. 实时事件触发流程

对接说明

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

1. FreshBooks 客户（Clients） → 金蝶云星空客户，按邮箱/客户编号匹配，目标状态：已审核
2. FreshBooks 商品/服务（Items） → 金蝶云星空物料，同步名称、单价、税率，目标状态：已审核

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

1. FreshBooks 发票（Invoices） → 金蝶云星空应收单/销售发票，按客户+发票号匹配，金额含税额拆分
2. FreshBooks 收款（Payments） → 金蝶云星空收款单，按发票关联核销应收
3. FreshBooks 费用（Expenses） → 金蝶云星空费用报销单/付款单，按分类（Category）映射费用科目
4. FreshBooks 日记账（Journal Entries） → 金蝶云星空会计凭证，按借贷方向生成凭证分录
5. Webhook 事件（invoice.created、payment.created、expense.created 等） → 触发即时增量同步

三、同步规则与过滤条件

1. 客户同步：仅同步状态为 active 的客户，重复客户按邮箱去重
2. 发票同步：仅同步已发送（sent）或已支付（paid）状态的发票，草稿不入库
3. 收款同步：仅同步成功入账的收款，退款（refund）走红冲逻辑
4. 费用同步：仅同步已审批（approved）的费用，个人未报销支出不入库
5. 币种处理：FreshBooks 多币种金额按当日汇率折算为金蝶记账本位币，保留原币金额
6. 同步频率：Webhook 即时同步 + 定时增量补偿（按 updated_at 拉取）；支持全量初始化+增量日常同步
7. 同步方式：不汇总，按单生成，目标单据默认暂存待审核

业务价值

• 基础资料统一：客户、商品一次维护，FreshBooks 与金蝶两端同步一致，杜绝重复建档
• 业财一体：海外发票、收款、费用实时流入金蝶，自动生成应收、收款与凭证，核算及时准确
• 自动对账：收款自动核销应收，费用自动归集科目，月底对账工作量大幅减少
• 多币种支持：原币与本位币双轨记录，跨境业务财务清晰可追溯
• 效率提升：减少线下抄录、录单、对账人工操作，财务团队可聚焦经营分析
• 合规可追溯：每笔同步保留来源单据号，满足审计与税务核查要求

接口文档

• FreshBooks API 文档（Authentication / Clients / Invoices / Payments / Expenses / Journal Entries / Webhooks，base https://api.freshbooks.com）
• 金蝶云星空 API 文档