1. 概述
1.1 应用场景
用户想要将「金蝶云星空」的数据获取至数跨境,在数跨境中进行数据的处理和分析。
1.2 功能简介
用户需要拥有 金蝶云星空 账号,前往金蝶云星空中新增第三方系统登录授权,将获得的信息填写在数跨境中,即可完成授权。
完成授权后,数据就获取至数跨境了,且获取的数据报告类型在不断的丰富中。
1.3 数据范围
数据表 | 获取的数据时间范围 |
---|---|
存货收发存汇总表(按日期)数据表 | 第一次更新可以获取到第一次更新时间往前推近 1 个月数据,再次更新 可以获取上次更新到这次更新之间的数据 |
其他数据表 | 第一次更新 可以获取到第一次更新时间往前推近 6 个月数据,再次更新 可以获取上次更新到这次更新之间的数据 |
如您有更多需求,可联系技术支持反馈。
1.4 注意事项
1)Beta 版本的数据源正处于公测阶段,如在使用中有任何问题或者需求,可联系技术支持进行反馈。Beta 版本在完成测试周期后会成为正式版,该信息将通过产品公告通知用户。
2)「金蝶云星空」为付费数据源,请管理员开通试用或者购买该数据源。如下图所示:
2. 授权流程
1)查看金蝶云星空版本信息,推荐云星空产品版本 8.1.0.20230608 及以上的客户使用。如何看产品版本见下图:
2)在数跨境中获取金蝶云星空数据需要以下信息:
3)首先「用户名」、「账套ID」、「应用 ID」、「应用密钥」 这 4 项信息,需要在金蝶云空中新建「第三方系统登录授权」获取。
分为以下三个版本,请根据自己的金蝶云星空版本跳转到对应小节中查看相关操作:
补丁版本为PT146928「8.0.396.10」以上公有云第三方授权:参见 3.2 节
补丁版本为PT146928「8.0.396.10」以上私有云第三方授权:参见 3.3 节
补丁版本未升级PT146928「8.0.396.10」且补丁版本为PT136657「7.3.1310.2」及以上的第三方授权:参见 3.4 节
4)「科目余额表」、「存货收发存汇总表」相关信息请根据 3.5、3.6 小节的操作获取。
5)根据第 4 节操作,在数跨境中新增「金蝶云星空」数据源,将获取的信息填写在弹窗中,即可完成授权。
6)同步金蝶云星空数据,并添加到项目中使用。
3. 获取授权信息
3.1 登录金蝶云星空
需由金蝶云星空产品管理员进行以下操作获取授权信息。
1)使用管理员账号 Administrator 在浏览器中登录金蝶云星空产品,点击「系统管理菜单」下的「第三方系统登录授权」功能。如下图所示:
2)点击「新增」按钮,进入新增「第三方系统登录授权」功能页面。如下图所示:
3)请根据自己使用的金蝶云星空版本跳转到对应的小节获取相关信息。
3.2 版本一:补丁版本为 PT146928「8.0.396.10」以上公有云第三方授权
1)点击「获取应用 ID 」按钮,输入注册的金蝶云账号及密码(金蝶云平台账号,建议使用手机号登录),注意不是当前星空产品内的用户账号。如下图所示:
2)登陆成功之后,会生成「应用 ID」、「应用密钥」,这里需要再自定义「应用名称」。如下图所示:
3)需要指定集成用户,「集成用户框」中选定的成员,在下方「指定用户登录」列表也需要添加该成员。如下图所示:
注:集成用户需要指定,但如果勾选了「允许全部用户登录」,则无需在「指定用户登录」列表中添加成员。
4)设置完成后,保存当前设置。点击「生成测试链接」,验证第三方授权是否正确。在弹出的信息中可以获取「账套 ID」,将该信息复制到数跨境中。如下图所示:
3.3 版本二:补丁版本为PT146928「8.0.396.10」以上私有云第三方授权
1)点击「获取应用 ID 」按钮,再点击「复制网址」可以直接跳转到应用市场,请使用「金蝶云」账号授权登录应用市场。如下图所示:
2)填写对应的信息后,点击「提交」。如下图所示:
3)提交后,会生成「应用信息」,点击「复制」按钮。如下图所示:
4)回到金蝶云星空中,将复制的内容粘贴到「应用信息」栏,点击「确定」。如下图所示:
5)会生成「应用 ID」、「应用密钥」,这里需要再自定义「应用名称」。如下图所示:
6)如果需要指定集成用户,「集成用户框」中选定的成员,在下方「指定用户登录」列表也需要添加该成员。如下图所示:
注:集成用户需要指定,但如果勾选了「允许全部用户登录」,则无需在「指定用户登录」列表中添加成员。
7)设置完成后,保存当前设置。点击「生成测试链接」,验证第三方授权是否正确。在弹出的信息中可以获取「账套 ID」,将该信息复制到数跨境中。如下图所示:
3.4 版本三:补丁版本未升级PT146928「8.0.396.10」且补丁版本为PT136657「7.3.1310.2」及以上
1)点击「获取应用 ID 」。如下图所示:
2)点击「复制网址」跳转到 Open网站的第三方系统登录授权页面。如下图所示:
3)在第三方系统登录授权下,点击「新增授权」。如下图所示:
4)请用户根据自身信息填写相关内容,填写完成后点击「提交」。如下图所示:
5)提交后,会生成「应用信息」,点击「复制」按钮。如下图所示:
6)回到金蝶云星空中,将应用信息粘贴在框中,点击「确认」。如下图所示:
7)会生成「应用 ID」、「应用密钥」,这里需要再自定义「应用名称」。如下图所示:
8)历史版本界面:需要集成用户。补丁版本为PT-146894 [7.7.0.202111]及后续的版本参考 9)的界面。
9)补丁版本为PT-146894 [7.7.0.202111]及后续的版本,如果需要指定集成用户,「集成用户框」中选定的成员,在下方「指定用户登录」列表也需要添加该成员。如下图所示:
注:集成用户需要指定,但如果勾选了「允许全部用户登录」,则无需在「指定用户登录」列表中添加成员。
9)设置完成后,保存当前设置。点击「生成测试链接」,验证第三方授权是否正确。在弹出的信息中可以获取「账套 ID」,将该信息复制到数跨境中。如下图所示:
3.5 获取「科目余额表」中的信息
请按照以下步骤获取「币别计数」、「账簿ID」、「科目级别计数」。
1)在主控台菜单下,进入「总账>科目余额表」页面。如下图所示:
2)鼠标点击一下账簿栏,即可获取当前核算组织的「账簿 ID」。如下图所示:
3)点击「币别」,在下拉框中数一下有几种币别即可,下图的币别计数为 8 。如下图所示:
4)点击「科目级别」,在下拉框中数一下有几种科目级别,下图的「科目级别计数」为 4 。如下图所示:
3.6 获取「存货收发存汇总表(按日期)」中的信息
请根据接下来的步骤获取「核算体系编码」、「核算组织编码」、「会计政策编码」、「汇总依据」、「显示纬度」。
1)在主控台菜单下,进入「成本管理>存货核算>存货收发存汇总表(按日期)」页面。如下图所示:
2)「核算体系编码」、「核算组织编码」、「会计政策编码」可在下图标记框中获取相关信息。
3)「汇总依据」、「显示维度」信息请根据自己的需要填写。如果选择「货主」作为汇总依据,那么在数跨境中填写 5。如果选择「按库存维度显示」作为「显示维度」,那么在数跨境中填写 1。如下图所示:
4. 新增「金蝶云星空」数据源
1)回到数跨境中,在团队中点击「创建>全部数据」,进入数据源界面。如下图所示:
2)点击「金蝶云星空」,新增一个数据源。如下图所示:
3)在「金蝶云星空 tab」下,点击「新增数据连接」。在配置弹窗中填写第 3 节中获取的信息。如下图所示:
配置 | 说明 | ||||
---|---|---|---|---|---|
名称 | 自定义数据连接的名称,方便之后识别 | ||||
用户名 | 金蝶云星空产品中的第三方系统登录授权中的集成用户名; 若勾选「允许全部用户登录」,那么使用金蝶云星空 ERP 中任一用户名都可以。 | ||||
账套 ID | 各版本用户根据第 3 节步骤,新增第三方系统登录授权,在「生成测试链接」弹出的信息中获取
| ||||
应用 ID | 各版本用户根据第 3 节步骤,在第三方系统登录授权中获取「应用 ID」、「应用密钥」
| ||||
应用密钥 | |||||
服务 URL 地址 | 公有云无需配置; 私有云需要配置金蝶云星空产品地址,K3Cloud/结尾,例如:https://****k3cloud/ | ||||
科目余额表 | 币别计数 | ERP后台「币别」下拉框中的选项个数 | 请根据 3.5 节步骤获取 | ||
账簿 ID | |||||
科目级别计数 | ERP后台「科目级别」下拉框中的选项个数 | ||||
存货收发存汇总表 | 核算体系编码 | 请根据 3.6 节步骤获取 | |||
核算组织编码 | |||||
会计政策编码 | |||||
汇总依据 | ERP后台「汇总依据」下拉框第几位 | ||||
显示纬度 | ERP后台「显示维度」枚举值下拉框第几位 |
4)点击确定后,可以看到已经将数据列表获取至数跨境了。如下图所示:
5. 同步数据
1)完成授权后,在左侧就获取了数据列表。此时还没有获取数据,可以先点击「同步数据源」先将数据全量同步一次。
本次操作是手动全量同步,数跨境还支持批量同步,定时同步等,详情参见文档:同步数据源。
2)之后可以根据自己的实际需求,对单表进行手动同步或者定时同步。减少全量同步,避免等待时间过长。如下图所示:
6. 数据源协作
A 在团队 1 中添加了一个 金蝶云星空数据源,那么 A 默认拥有这个数据源的管理权限。且团队 1 中的成员拥有数据源的使用权限。
点击「权限设置」按钮,A 可以对数据源进行权限设置,以便分配给其他成员使用。如下图所示:
详情参见文档:数据源权限设置