金蝶云星辰数据账户接入指南

1. 接入前准备

观远连接器的“金蝶云星辰”数据账户需要同一开放平台应用的客户端 ID（clientId）、客户端密钥（clientSecret），以及已授权账套对应的外部实例 ID（outerInstanceId）。本文适用于金蝶云星辰 OpenAPI 2.0。

2. 获取金蝶云星辰连接信息

2.1 创建应用并取得客户端凭据

登录金蝶小微企业生态门户，进入开发商控制台。若尚无应用，先完成开发商认证，在“我的应用”中创建应用，并订阅所需的金蝶云星辰 API 服务。金蝶官方的开发商注册认证及服务订阅指引说明了从认证、创建应用到生成 clientId 和 clientSecret 的流程。

打开目标应用的“应用集成”页，在同一行查看“应用ID（Client ID）”和“应用Secret（Client Secret）”。下图保留了左侧“我的应用”、上方“应用集成”页签及两个字段的位置。

公开资料脱敏示例，仅用于辅助识别字段位置；实际凭据以金蝶小微企业生态门户中的目标应用为准。

2.2 找到已授权账套的外部实例 ID

在同一应用的“应用集成”页进入“授权”。若尚未开通正式账套的接口授权服务，按页面提示完成开通和企业授权。

授权完成后，在授权记录中找到目标账套，读取“第三方实例ID”一列。该值对应观远连接器的外部实例 ID；请核对账套名称与授权状态，避免选到沙箱或其他账套。下图保留了授权页导航和字段所在表格。

公开资料脱敏示例，仅用于辅助识别字段位置；请在金蝶小微企业生态门户的目标应用授权页读取当前账套的实际值。

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

进入数据账户管理，点击“新增数据账户”，所属平台选择“金蝶云星辰”。账户名称可自行填写，其余三项按下表录入。

填写后点击“测试连接”，通过后点击“确定”保存。若测试失败，先确认三项信息来自同一应用及其已授权的目标账套，再核对该应用的接口服务订阅和授权状态。

4. 查不到第三方实例 ID

先确认当前应用已完成目标账套的接口授权，并查看“应用集成 → 授权”中的记录。若只有沙箱记录或授权状态不正确，请由金蝶开放平台管理员核对目标账套的授权。