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

更新: 10/22/2026 字数: 0 字 时长: 0 分钟

业务背景

源系统	成集云	目标系统
Dropbox 企业云盘		金蝶云星空

企业的合同 PDF、发票影像、凭证扫描件、质检报告、项目交付物往往散落在 Dropbox 各团队文件夹中，与金蝶云星空（合同档案、应收 / 应付单据、项目文档、附件中心）长期脱节：

• 业务单据找不到原始文件：财务在金蝶处理应收 / 应付时，需要调阅原始合同或发票影像，却只能去 Dropbox 翻找，效率低下。
• 合同影像无法自动挂接：销售在 Dropbox 上传签约合同 PDF，ERP 合同档案仍为空，后续对账、归档无据可依。
• 审计追溯困难：审计要求「单据—凭证—原始文件」一一对应，人工关联易遗漏、易出错。
• 人工搬运文件：行政与财务每周手动下载再上传 ERP，重复劳动且版本不可控。

基于成集云数据集成平台，通过 Dropbox API（/2/files、/2/team）与 Webhook，将指定文件夹的新增 / 变更文件实时同步为金蝶的附件、合同影像与发票影像，并按路径规则归类到对应客户 / 供应商 / 项目档案。

解决方案

在成集云中配置 Dropbox 连接器（OAuth 2.0 鉴权），监听指定根文件夹的文件变更事件。Dropbox 推送 Webhook 通知后，成集云以 X-Dropbox-Signature 验签，再调用 /2/files/list_folder/continue 拉取具体变更，将文件元数据与二进制内容同步为金蝶附件，并按「文件夹路径规则」自动归档到客户 / 供应商 / 项目档案；同步以 15 分钟轮询兜底。反向可配置：金蝶生成的凭证 PDF、报表自动导出回 Dropbox 归档目录。

业务流程

一、基础资料同步流程

1. 文件夹与文件同步流程

2. 合同影像同步流程

二、业务单据同步流程

3. 发票影像同步流程

4. 项目交付物同步流程

三、实时触发与反向同步

5. Webhook 实时变更触发流程

6. ERP 凭证导出反向归档流程

对接说明

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

Dropbox 对象	金蝶云星空目标	说明
团队文件夹 / 路径	档案分类（客户 / 供应商 / 项目）	按路径规则映射
文件元数据	附件（名称 / 类型 / 大小 / 修改时间）	记录 file_id 与 rev
文件二进制	金蝶附件存储	与元数据一一对应
团队成员	员工 / 上传人	邮箱匹配

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

• 合同类文件（命名 / 标签规则匹配）→ 金蝶 合同档案.附件，按合同号关联。
• 发票类影像 → 金蝶 应收单 / 应付单.附件，按单据号关联。
• 项目交付物 → 金蝶 项目文档，按项目号挂接。
• 质检 / 证照类文件 → 金蝶 物料或客户资质附件。

三、同步规则与过滤条件

• 路径白名单：仅监听指定根文件夹（如 /ERP-Archive），其余目录不进入 ERP。
• 类型过滤：按扩展名（pdf / doc / xlsx / 图片）与命名规则过滤，避免无关临时文件同步。
• 增量机制：Webhook 通知 → /2/files/list_folder/continue 拉取变更（cursor 游标）；15 分钟轮询兜底补偿。
• 去重策略：以 file_id + rev 版本标识，文件覆盖更新而非重复创建。
• 安全校验：Webhook 请求携带 X-Dropbox-Signature（HMAC-SHA256，App Secret 为密钥），验签通过才处理。
• 反向导出：金蝶生成文件 → /2/files/upload 上传回 Dropbox 归档目录，保持单点归档。

业务价值

• 单据与原件同源：应收 / 应付单据一键调阅原始合同与发票影像，审计可追溯、零遗漏。
• 合同影像自动挂接：签约 PDF 上传即归档 ERP 合同档案，对账与归档有据可依。
• 减少人工搬运：文件自动同步替代手动下载上传，按周节省数小时重复劳动。
• 权限可控：复用 Dropbox 团队文件夹权限 + 金蝶字段级权限，文件安全不越界。
• 双向归档闭环：ERP 凭证 / 报表自动回写 Dropbox，形成完整财务电子档案。

接口文档

• Dropbox API（https://api.dropboxapi.com/2/files、/2/team），OAuth 2.0 认证；核心端点 /2/files/upload、/2/files/download、/2/files/list_folder、/2/files/list_folder/continue、/2/team/members/list。
• Webhooks：变更通知 POST + X-Dropbox-Signature 头（HMAC-SHA256）；经通知后调用 /2/files/list_folder/continue 拉取具体变更（cursor）。
• 金蝶云星空 OpenAPI（附件、合同、应收 / 应付单据、项目文档相关接口）。