金蝶云星空连接器配置指南
金蝶云星空连接器配置指南
适用于观远 API 连接器的金蝶云星空(企业版)。选择认证方式,填写账户信息,测试成功后保存。
金蝶侧操作参考:金蝶官方 OpenAPI 配置说明。
1. 配置前准备
账号密码认证:准备目标账套的用户名和密码,并确认该环境支持 WebAPI 账号密码登录。
应用密钥认证:请金蝶管理员完成以下操作:
- 进入系统管理 → 第三方系统登录授权,点击“新增”。
- 点击“获取应用 ID”,按当前页面引导完成授权,保存应用 ID、应用密钥。
- 设置集成用户,并确认该用户在允许登录的授权范围内。
- 保存后点击“生成测试链接”,检查授权,并核对账套 ID 和用户名。
IP 白名单
若金蝶启用了 IP 白名单,请在目标应用的“第三方系统登录授权”中添加以下两个出口 IP并保存:
119.13.94.136,124.70.196.23
若防火墙也有限制,同步放行上述 IP。
2. 新增数据账户
进入数据账户管理 → 新增数据账户,选择金蝶云星空(企业版),填写账户名称及对应认证信息。以下配置字段均为必填。
两种认证方式的公共字段
| 字段 | 填写说明 |
| 服务地址(domain) | 金蝶站点根地址,如 https://erp.example.com,使用非默认端口时保留端口号。不要附加 /K3Cloud/、登录页或接口路径。 |
| 账套 ID(acctID) | 向金蝶管理员获取目标数据中心 ID;也可核对第三方授权测试链接中的账套信息。不是账套名称或组织编码。 |
| 用户名(username) | 目标账套的用户登录名。应用密钥认证也需要真实且已获授权的用户名。 |
| 语言编码(lcid) | 简体中文保持默认值 2052。 |
2.1 账号密码认证
选择账号密码认证,填写公共字段及密码(password),密码为上述金蝶用户的实际密码。
账号密码认证
2.2 应用密钥认证
选择应用密钥认证,填写公共字段及以下信息:
| 字段 | 填写说明 |
|---|
| 应用 ID(appId) | 第三方系统登录授权中获取的应用 ID。 | | 应用密钥(appSecret) | 与上述应用 ID 配套的应用密钥,不是用户密码。 |
应用密钥认证
2.3 测试并保存
点击“测试连接”,成功后点击“确定”保存。
3. 连接失败时检查
- 网络:服务地址、端口是否正确,连接器是否可访问金蝶,白名单是否已放行。
- 凭证:账套 ID、用户名及所选方式的密码或应用密钥是否正确,应用是否已授权该用户登录。
- 连接成功但无数据:检查用户的业务对象、组织及数据权限,以及接口筛选条件。
|