金蝶云星空（旗舰版）

Source: https://help.fanruan.com/jiushuyun/doc-view-846.html

1. 概述

1.1 应用场景

金蝶用户计划深入进行数据分析，以帮助他们更好的了解业务数据，为未来的决策提供有力支撑。

1.2 功能简介

用户需要拥有 **金蝶云星空（旗舰版） **账号，前往金蝶云星空（旗舰版）中新增第三方应用，将获得的信息填写在本产品配置界面，即可完成授权。

完成授权后，相关数据就获取到本产品中了，且获取的数据报告类型在不断的丰富中。

1.3 注意事项

1）Beta 版本的数据源正处于公测阶段，如在使用中有任何问题或者需求，可联系技术支持进行反馈。Beta 版本在完成测试周期后会成为正式版，该信息将通过产品公告通知用户。

2）「金蝶云星空（旗舰版）」为付费数据源，请管理员开通试用或者购买该数据源。

如何开通试用/购买数据源

超管或管理员，点击「企业设置>版本信息」，即可试用/购买数据源。如下图所示：

Group 62.png

3）此数据源会调用星空旗舰版 API ，需要购买 API 使用许可，请用户自行购买星空旗舰版 OpenAPI 。详情请参见金蝶云星空官方文档：OpenAPI（开放平台）计费说明

2. 获取授权信息

2.1 基础授权信息

授权「金蝶云星空（旗舰版）」数据源需获取以下图片中的信息，请金蝶云星空产品管理员新增第三方应用获取相关信息。

1）管理员在浏览器中登录金蝶云星空（旗舰版）系统，点击进入「开放服务云>OpenAPI>第三方应用」。如下图所示：

Group 61.png

2）点击新增应用，请自定义填写「系统编码」和「系统名称」，例如 JSY 等。如下图所示：

第 3 节新增数据源时，需填写「应用系统编码」信息，即此处的「系统编码」。

Group 63.png

3）请开启「启用代理用户控制」，并设置代理用户。如下图所示：

第 3 节新增数据源时，需填写「应用代理的用户名」，即此处的代理用户名。

Group 64.png

4）在认证凭证处，可以获取 accountId（即数据中心id ）和 x-acgw-identity 信息。如下图所示：

第 3 节新增数据源时，需填写此处两个信息。

Group 65.png

5）在「访问策略」处，点击「编辑」按钮，设置并保存 AccessToken 认证密钥，并开启增强型 Token 认证开关。 需注意，认证密钥设置后无法再查看，请立即记录下来。

第 3 节新增数据源时，需填写「应用认证密钥」信息，即此处的 AccessToken 认证密钥。

Group 66.png

6）在服务授权中，点击「授权新服务」，请选择需要对接获取的 API 服务，点击「立即授权」。如下图所示：

Group 67.png

7）设置完成后，保存。如下图所示：

Group 68.png

2.2 更多配置

更多配置中，允许用户自定义表，例如修改表的请求方式，自定义表单。

「金蝶云星空（旗舰版）」数据连接可以获取两种类型的表：内置表、自定义表单。说明见下表：

| 内置表| 自定义表单
---|---|---
定义|

由帆软封装的请求方式，在数据连接页面填写 2.1 节获取的基础授权信息，自动获取的表

|

授权后不会自动生成的表

用户在金蝶云星空 ERP 中支持通过自定义接口获取数据，若需要这些数据，需要通过「自定义表单」功能手动配置请求参数等信息

配置项|

设置回溯周期

设置完整服务地址

| 填写请求地址、请求参数等信息

2.2.1 回溯周期

使用场景： 当数据需要时间归因或修正时，回溯周期允许后续重新拉取更新后的准确数据，避免因早期数据不完整导致数据不准确。

如回溯周期=5，则每次从上次同步完成的时刻往前推 5 天开始同步。

2.2.2 完整服务地址

1）进入「开放服务云>OpenAPI>API开发」页面，如下图所示：

2）在 API 列表找到「采购订单详细查询（批量）」的 API ，点击进入 API 信息页，获取完成服务地址信息。如下图所示：

2.3.3 自定义表单

1）进入「开放服务云>OpenAPI>API开发」页面，如下图所示：

2）选择需要的 API ，点击进入该 API 信息页。如下图所示：

配置项
|

---|---
请求方式|

表名
请求地址
请求参数|

这两处参数信息是可以直接复制粘贴且保留缩进、空格以及换行的，用户可直接复制参数信息

返回参数

3. 新增「金蝶云星空（旗舰版）」数据源

1）进入数据连接市场，新增「金蝶云星空（旗舰版）」数据源。如下图所示：

Group 69.png

2）在页面中填写相关信息，说明如下表所示：

信息
| 说明
---|---
应用系统编码| 2.1 节中的「系统编码」信息
应用认证密钥| 2.1 节中的「AccessToken 认证密钥」信息
应用代理名称| 2.1 节中的「代理用户」信息
数据中心id| 2.1 节中的「accountId」信息
第三方服务URL| 访问金蝶云星空系统的地址，例如 https://xxxx.xxxx.com/
x-acgw-identity| 2.1 节中的「x-acgw-identity」信息
更多配置| 详情参见本文 2.2 节

3）左侧列表为可以选择添加的数据表，点击「查看」可以查看各表字段信息。勾选需要添加的数据表，点击「>」添加表。

若用户希望自动获取新增的表，可在选表界面开启「新增表自动勾选」。

Group 71.png

4）添加好数据表后，点击「确认」。如下图所示：

Group 72.png

5）在左侧就获取到了数据列表。如下图所示：

Group 73.png

4. 同步数据

1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：

Group 74.png

2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据

5. 数据源协作

数据源的创建者默认拥有数据源的管理权限，管理者可将此数据源分配给其他成员使用。

点击「权限设置」按钮，在弹窗中即可自定义配置数据源权限，详情参见文档：数据源权限设置

Group 75.png

6. 使用数据

获取到数据后，需要将数据保存在「分析展示」模块的项目中，进一步地分析。

Group 76.png

修改于 2026-01-29 10:15:39

金蝶云苍穹