金蝶精斗云云会计对接流程

1. 概述

1.1 应用场景

企业已使用金蝶精斗云云会计管理账务数据，希望将相关业务数据同步到观远数据连接器中，用于后续报表制作、经营分析、财务分析或项目数据建设。

1.2 功能简介

本产品支持通过金蝶精斗云云会计接口授权获取账套数据。完成授权后，可在观远数据连接器中创建「金蝶--精斗云」数据账户，并将同步后的数据用于分析场景。

1.3 注意事项

新建数据连接之前，请注意：

1. 如果在观远数据连接器中无法选择「金蝶--精斗云」平台，请先联系观远实施或连接器管理员确认平台是否已开通。
2. 金蝶侧需要先创建企业内部应用，并购买接口授权服务。未完成接口授权服务购买时，数据账户连接后可能无法正常获取账套数据。
3. 金蝶侧授权建议由企业服务管理员操作。如果非企业服务管理员操作，授权状态可能仍显示为「未授权」，此时需要将授权链接交给企业服务管理员完成最终授权。
4. 金蝶侧接口授权服务可能涉及购买或开通费用，实际费用、有效期和服务范围请以金蝶应用市场购买页为准。

2. 观远数据连接器侧准备

2.1 登录连接器平台

登录观远数据连接器平台：

https://apiconnector.guandata.com/

登录后点击右上角「进入控制台」。如下图所示：

2.2 进入数据账户管理

进入控制台后，点击左侧菜单「数据账户管理」。

在数据账户页面，可以按平台类型、数据账户名称筛选已有账户，也可以点击右侧「新增数据账户」创建新账户。如下图所示：

3. 获取授权信息

3.1 需要准备的字段

新增「金蝶--精斗云」数据账户前，需要先在金蝶侧准备以下字段：

金蝶官方参考入口如下：

金蝶小微企业生态门户：https://open.jdy.com/#/controller/index
创建应用：https://open.jdy.com/#/files/api/detail?index=3&categrayId=5403e0fd6a5811eda819b759130d6d33&id=eb5f1404d9dd11ed8e36016f0b230280
企业授权：https://open.jdy.com/#/files/api/detail?index=3&categrayId=5403e0fd6a5811eda819b759130d6d33&id=0ea22d86d9de11ed8e36f37522edc9ac
API 授权指南：https://open.jdy.com/#/files/api/detail?index=4&categrayId=5403e0fd6a5811eda819b759130d6d33&id=c33b4f83d9dc11ed8e36832acc1d0c89

说明：金蝶开发者后台需要金蝶云账号登录。以下说明按观远连接器需要填写的字段整理，完整创建应用、企业授权和购买授权服务流程可参考上方金蝶官方文档。

3.2 获取 clientId 和 clientSecret

在金蝶开放平台中创建企业内部应用。企业自主开发且仅供本企业使用时，通常选择「自建应用」；如果由服务商为客户代开应用，则需要按金蝶要求申请服务商资质。

创建应用时，需要选择精斗云云会计对应的产品线，并填写应用名称、应用主页、应用简介等基本信息。

应用创建完成后，进入金蝶开放平台「开发者后台」的「我的应用」页面，找到产品线为「精斗云云会计」的目标应用卡片，点击该应用进入详情页。

进入应用详情后，切换到「企业授权」页签。页面上方会展示「应用 ID（Client ID）」和「应用 Secret（Client Secret）」。这两个值分别填写到观远数据连接器的 clientId 和 clientSecret。

3.3 获取 outerInstanceId

创建企业内部应用后，需要在金蝶侧为对应账套购买或开通 API 授权服务。授权完成后，在应用详情的授权信息区域查看「第三方实例 ID」。

在当前页面中，「第三方实例 ID」位于「企业授权」页签下方的授权列表中。该值填写到观远数据连接器的 outerInstanceId。

注意：outerInstanceId 必须取自授权信息区域中的「第三方实例 ID」，不要使用订单列表中的订单号、应用 ID 或其他相似字段替代。

正式对接观远数据连接器时，应使用「企业授权」页签中的正式授权信息，不要使用「沙箱调试」页签中的测试环境信息。

3.4 填写 customer_id

customer_id 不是金蝶侧接口字段，也不需要在金蝶页面中获取。

该字段用于观远数据连接器的一对多数据源区分。精斗云场景下，建议直接填写与 outerInstanceId 相同的值，便于后续排查和区分账套。

注意：customer_id 仅用于观远侧区分数据账户，不会作为请求参数传给金蝶接口。

4. 连接「金蝶--精斗云」数据账户

4.1 新增数据账户

在「数据账户管理」页面点击「新增数据账户」。如下图所示：

4.2 选择所属平台

所属平台选择：

金蝶--精斗云

选择后，页面会展示该平台需要填写的连接字段。如下图所示：

4.3 填写连接信息

新增数据账户时，需要填写以下信息：

注：观远数据连接器会根据以上字段自动查询金蝶授权上下文。无需手动填写 appKey、appSecret、serviceId、accountId、domain 或 access_token。

4.4 测试连接并保存

连接信息填写完成后，先点击「测试连接」。测试通过后，点击「确定」保存数据账户。

如果测试连接失败，建议重点检查：

• clientId、clientSecret 是否填写正确。
• outerInstanceId 是否为购买接口授权服务后生成的第三方实例 ID。
• customer_id 是否已填写，通常可与 outerInstanceId 保持一致。
• 金蝶侧接口授权服务是否已完成购买和授权。
• 当前授权是否由企业服务管理员完成。

5. 后续数据使用

数据账户保存成功后，可在观远数据连接器后续的数据集同步、任务配置或接口取数流程中选择该账户，用于同步金蝶精斗云云会计数据。

6. 完整流程

完整流程如下：

1. 登录观远数据连接器平台，进入「数据账户管理」。
2. 金蝶侧创建「企业内部应用」，并进入「我的应用」页面。
3. 打开目标「精斗云云会计」应用详情，获取「应用 ID」和「应用 Secret」。
4. 购买或开通接口授权服务。
5. 在授权信息区域获取「第三方实例 ID」。
6. 观远数据连接器侧新增数据账户，所属平台选择「金蝶--精斗云」。
7. 填写 clientId、clientSecret、outerInstanceId、customer_id。
8. 点击「测试连接」，测试通过后点击「确定」保存。
9. 在后续数据同步或取数流程中使用该数据账户。