供应商同步
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('{','"contactperson":联系人信息.姓名,"phone":联系人信息.联系电话','}') 注:根据需要添加任意子表字段,最终通过在「子表聚合字段」中拼接字段名和字段值进行数据传递;(字段名可在 金蝶云星空旗舰版API中心 查询) | ||
扩展信息 | 创建人编码 | 单行文本 | 填写创建人编码。 |
修改人编码 | 填写修改人编码。 | ||
扩展字段 | 多行文本 | 设置默认值为公式编辑,公式设置如下所示: CONCATENATE('{','"creator_number":创建人编码,"modifier_number":修改人编码,"bizfunction":业务职能,"entry_linkman":['+JOIN(联系人信息.聚合字段,",")+']','}') 注:根据需要添加任意主表字段,最终通过在「扩展字段」中拼接字段名和字段值进行数据传递;(字段名可在 金蝶云星空旗舰版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
在线咨询