简单生产领料单/退料单

1. 简介

1.1 插件简介

简单生产领料单/退料单函数支持根据表单业务数据，在金蝶云星空企业版同步生成简单生产领料单/退料单。

1.2 应用场景

常用于在简道云中发生简单生产领料类业务时，通过该插件自动在金蝶云星空企业版中生成对应的简单生产领料单/退料单。

1.3 预期效果

开启金蝶云星空-生产领料/退料/补料单插件，以「简单生产领料单」为例，在表单中输入信息提交后，自动在金蝶云星空中生成对应的简单生产领料单。效果如下所示：

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. 表单搭建

插件使用体验可先安装：金蝶云星空-生产领料/退料/补料单插件应用模板。本文将按照示例表单进行讲解。

3.1 简单生产领料表单搭建

新建「简单生产领料」表单，字段设置如下所示：

分类	字段名称	字段类型	是否必填	字段设置
基础信息	单据编号	单行文本	是	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE(1000+RECNO())
	单据类型	下拉框		下拉框选项为：简单生产领料 VMI简单生产领料
	单据日期	日期时间		在「字段属性 >> 类型」处选择「年-月-日」
	发料组织	单行文本		填写金蝶云星空企业版中对应的发料组织编码。
	货主类型	下拉框		下拉框选项为：业务组织供应商客户
	生产组织	单行文本		填写金蝶云星空企业版中对应的生产组织编码。
	生产车间	单行文本		填写金蝶云星空企业版中对应的生产车间编码。
领料明细	物料编码	子表单-单行文本	是	填写金蝶云星空企业版中对应的物料编码。
	单位	子表单-单行文本		填写金蝶云星空企业版中对应的单位编码。
	申请数量	子表单-数字		填写申请数量。
	实发数量	子表单-数字		在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下：领料明细.申请数量
	仓库	子表单-单行文本		填写金蝶云星空企业版中对应的调出仓库编码。
	货主			填写金蝶云星空企业版中对应的货主编码。
	备注		否	填写领料明细中的备注。
	子表聚合			在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下： CONCATENATE('{','"FMaterialId":领料明细.物料编码,"FUnitID":领料明细.单位,"FAppQty":领料明细.申请数量,"FActualQty":领料明细.实发数量,"FStockId":领料明细.仓库,"FOwnerId":领料明细.货主,"FEntrtyMemo":领料明细.备注','}') 注：可根据需要添加任意子表字段，最终通过在「领料明细.子表聚合」中拼接字段名和字段值进行子表数据传递；（字段名可在金蝶云星空 API 中心查询）
	简单生产领料明细	多行文本		设置默认值为公式编辑，公式设置如下所示： JOIN(领料明细.子表聚合,CHAR(10))
扩展参数	备注	单行文本		主表示例字段，可填写单据备注。
扩展参数	扩展字段	单行文本		设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"FDescription":备注','}') 注：可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API中心查询）

3.2 简单生产退料表单搭建

新建「简单生产退料」表单，字段设置如下所示：

分类	字段名称	字段类型	是否必填	字段设置
基础信息	单据编号	单行文本	是	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE(1000+RECNO())
	单据类型	下拉框		下拉框选项为：简单生产退料 VMI简单生产退料
	单据日期	日期时间		在「字段属性 >> 类型」处选择「年-月-日」
	收料组织	单行文本		填写金蝶云星空企业版中对应的收料组织编码。
	货主类型	下拉框		下拉框选项为：业务组织供应商客户
	生产组织	单行文本		填写金蝶云星空企业版中对应的生产组织编码。
	生产车间	单行文本		填写金蝶云星空企业版中对应的生产车间编码。
退料明细	物料编码	子表单-单行文本	是	填写金蝶云星空企业版中对应的物料编码。
	单位	子表单-单行文本		填写金蝶云星空企业版中对应的单位编码。
	申请数量	子表单-数字		填写申请数量。
	实退数量	子表单-数字		在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下：退料明细.申请数量
	退料类型	子表单-下拉框		下拉框选项为：良品退料来料不良退料作业不良退料
	仓库	子表单-单行文本		填写金蝶云星空企业版中对应的调出仓库编码。
	货主	子表单-单行文本		填写金蝶云星空企业版中对应的货主编码。
	入库日期	子表单-日期时间		在「字段属性 >> 类型」处选择「年-月-日」
	备注	子表单-单行文本	否	填写退料明细中的备注。
	子表聚合	子表单-单行文本		在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下： CONCATENATE('{','"FMaterialId":退料明细.物料编码,"FUnitID":退料明细.单位,"FAppQty":退料明细.申请数量,"FActualQty":退料明细.实发数量,"FStockId":退料明细.仓库,"FOwnerId":退料明细.货主,"FEntrtyMemo":退料明细.备注','}') 注：可根据需要添加任意子表字段，最终通过在「退料明细.子表聚合」中拼接字段名和字段值进行子表数据传递；（字段名可在金蝶云星空 API 中心查询）
	简单生产退料明细	多行文本		设置默认值为公式编辑，公式设置如下所示： JOIN(退料明细.子表聚合,CHAR(10))
扩展参数	备注	单行文本		主表示例字段，可填写单据备注。
扩展参数	扩展字段	单行文本		设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"FDescription":备注','}') 注：可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API中心查询）

4. 流程节点设置

该插件可在智能助手、前端事件、流程插件节点等地方使用，因简单生产领料单，退料单的插件节点配置方式类似，为同一插件的不同函数，企业可结合自身业务需求进行选择，故本文以 流程节点-简单生产领料单 配置为例进行讲解。

4.1 流程发起节点

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

4.2 插件节点

4.2.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「简单生产领料单」。

4.2.2 设置插件节点

选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」。

插件：选择「金蝶云星空-生产补料单/退料单/补料单」插件 >>「简单生产领料单函数」；
操作类型：设置为自定义，下拉框中选择「审核」；
单据编号：设置为表单字段值，即「单据编号」字段；
单据类型：设置为表单字段值，即「单据类型」字段；
单据日期：设置为字段值，即「单据日期」字段；
发料组织：设置为字段值，即「发料组织」字段；
货主类型：设置为字段值，即「货主类型」字段；
生产组织：设置为字段值，即「生产组织」字段；
领料明细：设置为字段值，即「简单生产领料明细字段」；
扩展字段：设置为字段值，即「扩展字段」。

注：简单生产退料单插件函数的配置类似，参考简单生产领料单选择对应的函数匹配即可。

4.3 启用流程

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

4.4 效果演示

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

5. 注意事项

5.1 插件节点配置字段说明

字段名称	是否必填	字段来源	字段说明
操作类型	必填	自定义	可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 4 种操作：暂存：仅暂存保存：仅保存提交：保存并提交审核：保存并提交和审核
单据编号		字段值	金蝶云星空此简单生产领料/退料单的编号，编号需要是唯一的。
单据类型		自定义/字段值	简单生产领料单的类型，包含以下 2 种：简单生产领料 VMI 简单生产领料简单生产退料单的类型，包含以下 2 种：简单生产退料 VMI 简单生产退料
单据日期		字段值	——
发料组织		自定义/字段值	填写编码，一般这个编码是固定的，特殊业务可动态传对应的编码
货主类型			货主的类型，包含以下 3种：业务组织供应商客户
生产组织		自定义/字段值	填写编码，一般这个编码是固定的，特殊业务可动态传对应的编码
生产车间		自定义/字段值	填写编码，填写对应的生产车间编码。
领料/退料明细		字段值 ——	表单中的「简单生产领料/退料明细」字段
扩展字段	非必填	字段值	可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API中心查询）

5.2 关于插件的测试说明

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

6. 联系方式

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

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