Zoho Books（云端会计）集成金蝶云星空解决方案
更新: 10/19/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Zoho Books 云端会计系统 |  | 金蝶云星空 ERP |
许多成长型企业使用 Zoho Books 进行日常记账、开票、收付款与银行对账，其轻量易用的特性非常适合海外业务与多币种核算。然而当企业规模扩大、需要更完整的 ERP 能力（采购、库存、生产、集团财务）时，Zoho Books 中的财务数据往往与金蝶云星空彼此孤立：
- 数据双头维护：客户、供应商、商品在 Zoho Books 与金蝶中各录一遍，口径不一致；
- 业财断层：Zoho Books 开出的发票、收付款无法自动进入金蝶总账，月末需手工导出凭证、反复对账；
- 银行流水割裂：Zoho Books 的银行交易与金蝶资金模块脱节，资金看板不完整。
成集云数据集成平台将 Zoho Books 的往来单位、商品、发票、收付款、银行流水与日记账实时同步至金蝶云星空，构建跨 SaaS 的业财一体数据闭环。
解决方案
基于成集云数据集成平台，构建可视化自动同步任务：以 Zoho Books 为前端记账与开票入口，通过 OAuth 2.0 安全连接，将客户/供应商/商品等基础资料以及发票、收付款、账单、银行交易、日记账等业务单据，按增量规则周期性同步至金蝶云星空，自动生成应收、应付、收款单、付款单、银行日记账与会计凭证，让两套系统共享同一套业财数据。
业务流程
一、基础资料同步流程
1. 往来单位与商品同步流程
Zoho Books 的 Contact（customer/vendor 由 contact_type 区分）与 Item 映射为金蝶的客户、供应商与物料，以 Zoho 主键做唯一关联。
二、应收与应付同步流程
1. 应收发票与收款同步流程
Zoho Books 发票（status=sent）生成金蝶应收单/销售发票，客户付款（payment）生成收款单并自动核销对应应收。
2. 应付账单与付款同步流程
Zoho Books 账单（bill）生成金蝶应付单/采购发票，供应商付款（bill payment）生成付款单并核销应付，完成三单匹配。
三、资金与凭证同步流程
1. 银行流水与日记账同步流程
Zoho Books 的银行账户交易同步至金蝶银行日记账/流水，日记账（journal）同步为金蝶会计凭证，实现资金与账务一体化。
2. 销售与采购订单同步流程
Zoho Books 的销售订单与采购订单同步为金蝶对应单据，打通前端交易与后端执行。
对接说明
一、基础资料同步（Zoho Books → 金蝶云星空）
- Contact（contact_type=customer）→ 客户：以 contact_id 映射，同步名称、税号、币种、信用额度；
- Contact（contact_type=vendor）→ 供应商：同步付款条件、银行账户；
- Item（product/service）→ 物料：同步编码、单位、税率、标准成本；
- 多组织：Zoho Books 支持多 organization，以
organization_id区分并分别同步至金蝶对应账套/组织。
二、业务单据同步（Zoho Books → 金蝶云星空）
- Invoice（status=sent）→ 应收单/销售发票；Invoice（void）→ 红字应收；
- Payment（customer payment）→ 收款单，按 invoice 明细自动核销应收；
- Bill → 应付单/采购发票；Bill Payment → 付款单，按 bill 明细自动核销应付；
- Credit Note → 红字应收 / 红字应付；
- Bank Transaction → 银行日记账 / 银行流水，支持按规则归类；
- Journal → 会计凭证，科目映射后生成金蝶总账凭证；
- Sales Order / Purchase Order → 金蝶销售订单 / 采购订单。
三、同步规则与过滤条件
- 认证方式：Zoho Books REST API v3，OAuth 2.0 授权码流，调用需在 Header 携带
Authorization: Zoho-oauthtoken {access_token}，所有请求必带organization_id（或 HeaderX-com-zoho-books-organizationid）；Access Token 有效期 1 小时，由成集云托管 Refresh Token 自动续期； - 增量同步：Zoho Books 无原生 Webhook，成集云采用定时增量轮询，以
last_modified_time/ 日期过滤条件（如filter_by=CreatedTime配合日期区间）拉取自上次同步以来的变更，默认每 15 分钟执行一次； - 幂等去重：以 Zoho 各对象主键（invoice_id、bill_id、payment_id 等）与金蝶单据号建立映射，重复拉取不重复建单；
- 失败重试：接口限频（约 100 次/分钟/组织）时自动退避重试，保障最终一致；
- 多币种：Zoho Books 多币种金额按金蝶币别与主币折算规则同步，保留原币与汇率。
业务价值
- 业财一体：Zoho Books 的开票、收付款自动进入金蝶总账，凭证不再手工录入；
- 对账提效：银行流水与应收应付自动核销，月末结账从数天缩短到小时级；
- 数据一致：客户、供应商、商品一次维护、双向共享，消除双头录单；
- 合规可溯：每笔同步记录可回溯至 Zoho 源单据，审计清晰；
- 平滑演进：轻量记账保留在 Zoho Books，重资产 ERP 能力由金蝶承载，企业数字化路径平滑过渡。
接口文档
- Zoho Books API v3 开发者文档（Contacts / Invoices / Bills / Payments / Journals / BankTransactions）：
https://www.zoho.com/books/api/v3/ - Zoho Books OAuth 2.0 认证文档：
https://www.zoho.com/books/api/v3/oauth/ - 金蝶云星空 OpenAPI（客户 / 供应商 / 物料 / 应收 / 应付 / 收付款 / 凭证）：
https://vip.kingdee.com/