其他入库/出库单

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

插件使用体验可先安装：金蝶星空旗舰库存单据同步插件应用模板。本文将按照示例中对应表单进行讲解。

3.1 其他入库单

新建「其他入库单」流程表单，字段设置如下所示：

分类	字段名称	字段类型	是否必填	字段说明
基础信息	单据编号	单行文本	是	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE("RK",TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3))
	单据类型	下拉框		下拉框选项为：标准其他入库单标准其他入库退回单
	库存组织	单行文本		填写金蝶星空旗舰中对应的库存组织编码。
	业务日期	单行文本		——
入库明细	行类型	子表单-下拉框	是	下拉框选项为：物资服务
	物料编码	子表单-单行文本		填写金蝶星空旗舰中对应的物料组织编码。
	库存单位			填写金蝶星空旗舰中对应的单位编码。
	仓库			填写金蝶星空旗舰中对应的仓库编码。
	数量	子表单-数字		——
	入库库存类型	子表单-单行文本		填写金蝶星空旗舰中对应的入库库存状态。如普通。
	入库库存状态			填写金蝶星空旗舰中对应的入库库存状态。如可用。
	子表聚合		否	设置默认值为公式编辑，公式设置如下所示：CONCATENATE('{','"linetype_number":入库明细.行类型,"material_number":入库明细.物料编码,"unit_number":入库明细.库存单位,"qty":入库明细.数量,"warehouse_number":入库明细.仓库,"invtype_number":入库明细.入库库存类型,"invstatus_number":入库明细.入库库存状态','}') 注：可根据需要添加任意主表字段，最终通过在「子表聚合字段」中拼接字段名和字段值进行数据传递；（字段名可在金蝶云星空API中心查询）
	入库聚合明细	多行文本		设置默认值为公式编辑，公式设置如下所示：JOIN(入库明细.子表聚合,CHAR(10))
扩展信息	备注	单行文本		——
扩展信息	扩展字段			设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"comment":备注','}') 注：可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API中心查询）
返回信息	单据主键			返回信息无需填写：「单据状态」返回标识和含义如下所示： A 表示：创建；B 表示：审核中；C 表示：已审核；D 表示：重新审核；Z 表示：暂存。
返回信息	单据状态

3.2 其他出库单

新建「其他出库单」流程表单，字段设置如下所示：

分类	字段名称	字段类型	是否必填	字段说明
基础信息	单据编号	单行文本	是	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE("CK",TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3))
	单据类型	下拉框		下拉框选项为：标准其他出库单资产其他出库单标准其他出库退回单 VMI其他出库单
	库存组织	单行文本		填写金蝶星空旗舰中对应的库存组织编码。
	领用组织
	业务日期			——
出库明细	行类型	子表单-下拉框	是	下拉框选项为：物资服务
	物料编码	子表单-单行文本		填写金蝶星空旗舰中对应的物料组织编码。
	库存单位			填写金蝶星空旗舰中对应的单位编码。
	仓库			填写金蝶星空旗舰中对应的仓库编码。
	数量	子表单-数字		——
	出库库存类型	子表单-单行文本		填写金蝶星空旗舰中对应的入库库存状态。如普通。
	出库库存状态			填写金蝶星空旗舰中对应的入库库存状态。如可用。
	子表聚合		否	设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"linetype_number":出库明细.行类型,"material_number":出库明细.物料编码,"unit_number":出库明细.库存单位,"qty":出库明细.数量,"warehouse_number":出库明细.仓库,"outinvtype_number":出库明细.出库库存类型,"outinvstatus_number":出库明细.出库库存状态','}') 注：可根据需要添加任意主表字段，最终通过在「子表聚合字段」中拼接字段名和字段值进行数据传递；（字段名可在金蝶云星空API中心查询）
	出库聚合明细	多行文本		设置默认值为公式编辑，公式设置如下所示：JOIN(出库明细.子表聚合,CHAR(10))
扩展信息	备注	单行文本		——
扩展信息	扩展字段			设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"comment":备注','}') 注：可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空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 种操作：保存：仅保存提交：保存并提交审核：保存并提交和审核
单据编号	是	字段值	此单据的编号。
单据类型	是		其他出库单有以下几种类型：标准其他出库单资产其他出库单标准其他出库退回单 VMI其他出库单其他入库单有以下几种类型：标准其他入库单标准其他入库退回单
库存组织	是		填写金蝶星空旗舰中对应的库存组织编码。
业务日期	是		——
出库聚合明细	是		表单中的「出库/入库明细聚合」字段。
扩展字段	否		可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空API中心查询）

5.2 关于插件的测试说明

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

6. 联系方式

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

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）
财务软件对接插件交流群，二维码如下：