物料同步
1. 简介
1.1 场景简介
物料同步场景指的是,根据表单业务数据,通过物料同步函数在金蝶星空旗舰版中同步物料相关数据。
1.2 应用场景
常用于在简道云中发生物料相关信息更新时,通过该函数自动在金蝶星空旗舰版中同步物料信息。
1.3 预期效果
开启金蝶星空采购单据同步插件,在「物料」表单中输入信息提交后,自动在金蝶星空旗舰版中同步对应的物料信息。效果如下所示:

1.4 使用说明
该插件为付费插件,进入简道云「开放平台 >> 插件市场」,找到「金蝶星空旗舰采购单据同步」插件,点击进去进行购买:
2. 插件安装及启用
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:金蝶星空旗舰采购单据同步插件安装。
- 安装成功后,可参考本文【2.2 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处启用插件。
2)在简道云「插件市场」处,安装「金蝶星空旗舰采购单据同步」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。

2.2 配置插件
在插件管理中,点击「调整插件配置」按钮,配置「应用编码」「应用密钥」「授权用户」「认证编码」「身份标识」「接口地址」,点击保存。

注:接口地址填写金蝶云星空旗舰版地址,并在 com 后添加固定值:/kapi
2.3 启用插件
在插件管理中,打开「金蝶星空旗舰采购单据同步」插件右侧开关,启用插件。

3. 表单搭建
插件使用体验可先安装:金蝶星空旗舰采购单据同步插件应用模板。本文将按照示例中的「物料同步」表单进行讲解。
新建「物料同步」流程表单,字段设置如下所示:
分类 | 字段名称 | 字段类型 | 字段说明 |
物料信息 | 物料编码 | 单行文本 | 必填,注:自己定义一个物料编号,需要是唯一,同时作为金蝶星空此物料的编号。公式举例: CONCATENATE(1000+RECNO()) |
物料名称 | 必填,填写该物料名称。 | ||
创建组织 | 必填,一般这个编码是固定的,填写金蝶星空旗舰对应的组织编码。 | ||
基本单位 | 必填,填写基本物料单位。 | ||
扩展信息 | 备注 | 单行文本 | 填写备注。 |
扩展字段 | 多行文本 | 设置默认值为公式编辑,公式设置如下所示: CONCATENATE('{','"description":备注','}') 注:根据需要添加任意主表字段,最终通过在「扩展字段」中拼接字段名和字段值进行数据传递;(字段名可在 金蝶云星空旗舰版API中心 查询) | |
返回信息 | 单据状态 | 单行文本 | 返回信息无需填写。 「单据状态」返回标识和含义如下所示: A 表示:创建;B 表示:审核中;C 表示:已审核;D 表示:重新审核;Z 表示:暂存。 |
单据主键 | —— |

4. 流程节点设置
4.1 流程发起节点
点击流程发起节点,在「节点属性 >> 字段权限」处,勾选部分字段的「可见」「可编辑」权限:

注:除「扩展字段」等公式编辑字段,其余字段均勾选「可见」「可编辑」权限。
4.2 插件节点
4.2.1 添加插件节点
在「流程设定」中,从工具栏中选择「插件节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来,并修改插件节点的名称为「物料同步」,选中插件节点,在「节点属性 >> 插件」处,点击「插件配置」:

4.2.2 设置插件节点
插件节点配置如下所示:
- 插件:选择「金蝶星空旗舰采购单据同步>>物料」插件;
- 请求方法:设置为自定义,如有填写单据自定义接口地址(不包含域名),如无就不填写。
- 操作类型:设置为自定义,勾选「保存」、「提交」或「审核」;
- 物料编号:设置为字段值,即「物料编号」字段;
- 物料名称:设置为字段值,即「物料名称」字段;
- 创建组织:设置为字段值,即「创建组织」字段;
- 基本单位:设置为字段值,即「基本单位」字段;
- 扩展字段:设置为字段值,即「扩展字段」。
- 字段存储关系:点击「添加」按钮,进行如下设置:
- 单据主键:的值存储到,「单据主键」字段;
- 单据状态:的值存储到,「单据状态」字段。

4.3 启用流程
流程设定完成后,点击「保存」后,再点击「启用流程」,即可启用当前流程。

4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 插件节点配置字段说明
字段分类 | 字段名称 | 是否必填 | 字段来源 | 字段说明 |
基础字段 | 操作类型 | 必填 | 自定义 | 可根据表单提交后,金蝶云星空旗舰版进行哪些操作进行选择,提供以下 3 种操作:
|
物料编号 | 字段值 | 此物料的编号。 | ||
物料名称 | 此物料的名称。 | |||
基本单位 | 为金蝶星空旗舰版中的基本单位编码,可点击星空后台对应字段字段查看。 | |||
创建组织 | 为金蝶星空旗舰版中的创建组织编码,可点击星空后台对应字段字段查看。 | |||
扩展字段 | 扩展字段 | 非必填 | 字段值 | 根据需要添加任意主表字段,最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递;(字段名可在 金蝶云星空旗舰版API中心 查询) |
5.2 关于插件的测试说明
因物料同步后,涉及金蝶云星空旗舰版关键单据/关联单据/关联事件的变化,建议大家测试时请自己的金蝶云星空服务顾问进行协助,以便更好的和自己的金蝶云星空旗舰版系统中的业务规则相结合。
6. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)
- 财务软件对接插件交流群,二维码如下:

400-111-0890
在线咨询