物料清单同步 - 简道云

物料清单同步

1. 简介

1.1 插件简介

该函数支持根据表单业务数据，在金蝶云星空企业版同步生成物料清单。

1.2 应用场景

常用于在简道云中发生生产类业务时，通过该函数支持自动在金蝶云星空企业版中生成对应的物料清单。

1.3 预期效果

开启金蝶云星空-生产订单同步插件，选择物料清单函数进行配置，在「物料清单-BOM」表单中输入信息提交后，自动在金蝶云星空中生成对应的物料清单。效果如下所示：

1.4 使用说明

该插件为付费插件，请联系我们增购。插件购买流程如下所示：

2. 插件安装及启用

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：金蝶云星空-生产订单同步插件安装。
安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。

2）在简道云「插件市场」处，安装「金蝶云星空-生产订单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

在插件管理中，点击「调整插件配置」按钮，配置「授权模式」「账套ID」「授权用户」「用户密码」「用户ID」「应用密钥」「接口地址」，点击保存。

注：

1）金蝶云星空全部公有云版本和私有云 7.3 以上版本可使用三方授权模式，私有云 7.3 以下版本需使用账号密码授权模式。

2）三方授权模式无需填写用户密码，其他参数必填；账号密码授权模式无需填写应用 ID /应用密钥，其他参数必填。不同的授权模式，插件配置参数的获取方式不同。详情可见金蝶云星空-生产订单同步【2. 金蝶云星空平台配置】。

2.3 启用插件

在插件管理中，打开「金蝶云星空-生产订单同步」插件右侧开关，启用插件。

3. 表单搭建

插件使用体验可先安装：金蝶云星空-生产订单同步插件应用模板。本文将按照示例表单「物料清单」进行讲解。

新建「物料清单-BOM」表单，字段设置如下所示：

分类	字段名称	字段类型	是否必填	字段设置
基础信息	BOM 版本	单行文本	必填	注：自己定义一个 BOM 版本，需要是唯一，同时作为金蝶云星空 BOM 版本。公式举例： CONCATENATE("A",TEXT(INT(RAND()*10000)),RIGHT("0"+RECNO(),1))
	BOM 简称	单行文本	非必填	——
	创建组织	单行文本	必填	需要为金蝶云星空中对应的创建编码。
	使用组织	单行文本		需要为金蝶云星空中对应的使用组织编码。
	父项物料编码	单行文本		需要为金蝶云星空中父项物料编码。
	父项物料单位			需要为金蝶云星空中的父项物料单位。
	BOM 分类	下拉框		设置下拉框选项为：标准 BOM 配置 BOM
	BOM 分类用途	下拉框		设置下拉框选项为：通用自制委外组装报价
BOM 明细	物料明细-子项物料编码	子表单-单行文本		需要为金蝶云星空中的子项物料编码。
	物料明细-子项类型	子表单-下拉框		设置下拉框选项为：标准件返还件替代件
	物料明细-子项单位	子表单-单行文本		需要为金蝶云星空中的子项物料单位。
	物料明细-用量类型	子表单-下拉框		设置下拉框选项为：固定变动阶梯
	物料明细-生效日期	子表单-日期时间		——
	物料明细-失效日期	子表单-日期时间		——
	物料明细-发料方式	子表单-下拉框		设置下拉框选项为：直接领料直接倒冲调拨领料调拨倒冲不发料
	物料明细-明细聚合	子表单-单行文本	非必填	在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下： CONCATENATE('{','"fmaterialidchild":物料明细.子项物料编码,"FMATERIALTYPE":物料明细.子项类型,"fchildunitid":物料明细.子项单位,"FDOSAGETYPE":物料明细.用量类型,"FEFFECTDATE":物料明细.生效日期,"FEXPIREDATE":物料明细.失效日期,"FISSUETYPE":物料明细.发料方式','}')
辅助字段	多行物料明细拼接字段	多行文本		在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下： JOIN(物料明细.明细聚合,CHAR(10))
辅助字段	主表扩展字段	单行文本		在「字段属性 >> 默认值」处选择「公式编辑」，公式示范如下： CONCATENATE('{','"FDescription":"测试"','}') 注：可根据需要添加任意主表字段，最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API 中心查询）

4. 流程节点设置

4.1 流程发起节点

点击流程发起节点，在「节点属性 >> 节点名称」处，修改节点名称为「发起生产订单」；在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：

注：「可见」、「可编辑」权限可根据自身业务需求设定，除「明细聚合」、「多行物料明细拼接字段」和「主表扩展字段」等公式字段外，其他字段均可勾选「可见」、「可编辑」权限。

4.2 审批节点

新增流程节点，在「节点属性 >> 节点名称」处，修改节点名称为「审批节点」；在「节点属性 >> 字段权限」处，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：

4.3 启用流程

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

5. 智能助手Pro配置

5.1 表单触发设置

1）进入「物料清单-BOM」流程表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro 的名称为「物料清单同步」，并选择触发方式为「表单触发」：

2）触发动作进行如下设置：

触发表单：默认当前表单；
触发动作：选择「新增数据」时和「修改数据」勾选「任意字段」修改时。

5.2 插件节点设置

点击节点连接线上的加号按钮，添加插件节点，且插件节点设置如下：

执行插件：选择「金蝶云星空-生产订单同步 >>物料清单」；
操作类型：设置为「自定义」，选择「审核」；
BOM 版本：选择「字段值」，选择「触发数据--BOM 版本」；
BOM 简称：选择「字段值」，选择「触发数据--BOM 简称」；
创建组织：选择「字段值」，选择「触发数据--创建组织」；
使用组织：选择「字段值」，选择「触发数据--使用组织」；
父项物料编码：选择「字段值」，选择「触发数据--父项物料编码」；
父项物料单位：选择「字段值」，选择「触发数据--负向物料单位」；
BOM 分类：选择「字段值」，选择「触发数据--BOM 分类」；
BOM 用途：选择「字段值」，选择「触发数据--BOM 用途」；
物料明细：选择「字段值」，选择「触发数据--物料明细」；
主表扩展字段：选择「字段值」，选择「触发数据--主表扩展字段」。

5.3 保存并启用

全部设置完成后，点击右上方「保存并启用流程」，启用流程节点。

5.4 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

6.1 插件节点配置字段说明

字段名称	是否必填	字段来源	字段说明
操作类型	必填	自定义	可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 3 种操作：保存：仅保存提交：保存并提交审核：保存并提交和审核
BOM 版本		字段值	金蝶云星空此物料清单的版本，版本需要是唯一的。
BOM 简称		自定义/字段值	可自定义
创建组织		自定义/字段值	为金蝶云星空中对应的创建组织对应的编码，一般这个编码是固定的，特殊业务可动态传对应的编码
使用组织		自定义/字段值	为金蝶云星空中对应的创建组织对应的编码，一般这个编码是固定的，特殊业务可动态传对应的编码
父项物料编码	——	字段值	为金蝶云星空中对应的父项物料编码。
父项物料单位			为金蝶云星空中对应的父项物料单位。
BOM 分类			可根据表单提交后，金蝶云星空需要同步哪种分类进行选择，有以下 2 种选择：标准 BOM 配置 BOM
BOM 用途			可根据表单提交后，金蝶云星空需要同步哪种用途进行选择，有以下 5 种选择：通用自制委外组装报价
主表扩展字段	非必填	字段值	可根据需要添加任意主表字段，最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API 中心查询）

6.2 关于插件的测试说明

因物料清单的同步后，涉及金蝶云星空关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶云星空系统中的业务规则相结合。

7. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）