金蝶云星空（旗舰版）数据账户接入指南

1. 先确认认证方式

观远连接器的“金蝶云星空（旗舰版）”支持“旗舰版 OpenAPI Token认证”和“旗舰版 OpenAPI增强型Token认证”。两种方式使用同一个金蝶第三方应用，但填写的用户字段和数据中心要求不同。先在金蝶第三方应用的 AccessToken 访问策略中确认“增强型Token认证”开关，再在连接器中选择对应方式。

2. 在金蝶获取连接信息

2.1 找到第三方应用

由有 OpenAPI 管理权限的人员登录金蝶云星空旗舰版，在首页搜索“第三方应用”，进入“开放服务云 → OpenAPI → 第三方应用”；已有应用可直接打开，新接入可创建应用并启用。下图展示旗舰版搜索入口。具体导航可参照金蝶云社区的旗舰版第三方应用操作示例。

进入第三方应用后，记录应用“系统编码”、与其绑定的代理用户，并检查应用已获得本次需要读取的 API 权限。金蝶第三方应用说明列出了认证凭证和访问策略的位置。

2.2 查看认证凭证

打开应用详情的“认证凭证”区域，核对 accountId（数据中心 ID）、appId/client_id 和 x-acgw-identity。网关身份标识可能需要点击显示图标并完成当前账号验证。下图保留了应用详情页的布局以及“认证凭证”“访问策略”的相对位置，示例账号已遮盖；参照金蝶云社区的应用详情示例定位。

服务域名取当前金蝶旗舰版的访问域名，例如 https://example.kdgalaxy.com；填写域名根地址即可。租户 ID 仅在使用标准 Token 且需要指定租户时填写。数据中心 ID 应与该应用授权的数据中心一致。

2.3 核对 AccessToken 访问策略

在同一应用的“访问策略”中打开“AccessToken认证”，核对认证密钥及“增强型Token认证”开关。下图展示策略编辑位置和开关；图中的开关状态仅是示例，应以本次连接的真实应用为准。参照金蝶云社区的访问策略示例操作。

使用增强型 Token 认证时，连接器的“第三方应用系统编码”对应金蝶应用的系统编码，“AccessToken认证密钥”对应此处设置的密钥，“代理用户名”对应第三方应用绑定的代理用户。金蝶第三方应用说明解释了增强型 Token 开关与认证密钥的关系。

3. 在观远连接器创建数据账户

进入“数据账户管理”，点击“新增数据账户”，所属平台选择“金蝶云星空（旗舰版）”。先选与金蝶访问策略一致的认证方式，再填写账户名称和相应字段。下图是“旗舰版 OpenAPI Token认证”的完整表单。

3.1 标准 OpenAPI Token认证

3.2 OpenAPI增强型Token认证

选择“旗舰版 OpenAPI增强型Token认证”后，按下表填写。此方式需要数据中心 ID；字段“第三方应用系统编码”和“AccessToken认证密钥”分别对应金蝶的 client_id 和 client_secret。金蝶增强型 Token 参数示例可用于核对字段含义。

填写完成后点击“测试连接”，再点击“确定”保存。测试或后续取数出现认证错误时，先核对认证方式与金蝶开关状态是否一致、应用是否已启用并获得所需接口权限，以及系统编码、认证密钥、网关身份标识是否来自同一个第三方应用。

4. 常见问题

找不到“第三方应用”：请让有“开放服务云 → OpenAPI”管理权限的金蝶管理员搜索该菜单并查看应用。

不知道填哪个数据中心：在目标第三方应用的“认证凭证”区域核对 accountId。标准 Token 可留空并使用默认数据中心；增强型 Token 必须填写。

认证方式不一致：金蝶“增强型Token认证”开关打开时，选择连接器的增强型方案；未打开时，选择标准 Token 方案。