金蝶云星空旗舰版-直接调拨单同步插件

1. 简介

1.1 插件简介

金蝶云星空旗舰版-直接调拨单同步插件支持根据表单业务数据，同步在金蝶云星空旗舰版生成直接调拨单。

1.2 应用场景

常用于在简道云中发生仓库之间的货物调拨‌时，完成不同仓库之间的货物调度，通过该插件可以自动在金蝶云星空旗舰版中同步直接调拨单。减少人工录入，同时保证数据同步的准确性和时效性。

1.3 预期效果

开启金蝶云星空旗舰版-直接调拨单插件，在「直接调拨单」表单中输入信息提交后，自动在金蝶云星空旗舰版中生成对应的直接调拨单。效果如下所示：

1.4 使用说明

金蝶云星空旗舰版-直接调拨单同步插件为付费插件，插件购买流程如下所示：

2. 金蝶云星空旗舰版平台配置

2.1 创建应用

1）进入金蝶云星空旗舰版，在搜索栏中输入「第三方应用」。进入「第三方应用>>OpenAPI」，进入列表后，点击左上「新增」按钮。

2）在应用信息设置页面，设置应用的基本信息，系统编码、系统名称、启用时间、停止时间和应用联系人等内容。

2.2 获取应用编码和授权用户

创建好应用后，将「代理用户」、「accountId」、「appId」和「x-acgw-identity」内容获取并保存，用于后续插件配置。

获取到的「代理用户」即为插件配置中的「授权用户」；
获取到的「accountId」即为插件配置中的「认证编码」；
获取到的「appId」即为插件配置中的「应用编码」；
获取到的「x-acgw-identity」即为插件配置中的「身份标识」。

2.3 获取应用密钥

在下方「访问策略」处，点击「编辑」按钮，设置并保存 Access Token 认证密钥，并开启增强型 Token 认证开关。

设置的「认证密钥」即为插件配置中的「应用密钥」。

注：认证密钥需立即记录并存档，不支持后续查看。

2.4 保存并启用

设置完成之后，点击下方「服务授权 >> 授权新服务」将需要用到的 API 服务进行授权；授权完成后点击上方「保存」按钮并点击禁用下拉框中的「启用」按钮，启用应用。

3. 插件安装及启用

3.1 安装插件

1）直接安装

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

2）在简道云「插件市场」处，安装「金蝶云星空旗舰版-直接调拨单」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

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

注：接口地址填写金蝶云星空旗舰版地址，并在 com 后添加固定值：/kapi

3.3 启用插件

在插件管理中，打开「金蝶云星空-直接调拨单」插件右侧开关，启用插件。

4. 表单搭建

插件使用体验可先安装：金蝶云星空旗舰版-直接调拨单插件应用模板。本文将按照示例中对应表单进行讲解。

新建「直接调拨单」流程表单，字段设置如下所示：

分类	字段名称	字段类型	是否必填	字段说明
基础信息	单据编号	单行文本	必填	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空旗舰版此单据的编号。公式举例： CONCATENATE(TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3))
	单据类型	下拉框		下拉框选项为：标准直接调拨单受托加工直接调拨单产品委外直接调拨单受托委外直接调拨单 VMI委外直接调拨单 VMI直接调拨单
	调出组织	单行文本		填写金蝶云星空旗舰版中对应的组织编码。
	业务类型			填写金蝶云星空旗舰版中对应的业务类型编码。
	库存事务			填写金蝶云星空旗舰版中对应的库存事务编码。
	调拨类型	下拉框		下拉框选项为：组织内调拨跨组织调拨
	调入组织	单行文本		填写金蝶云星空旗舰版中对应的组织编码。
	业务日期	日期时间		年-月-日
调拨明细	物料编码	子表单-单行文本	必填	填写金蝶云星空旗舰版中对应的物料编码。
	库存单位	子表单-单行文本		填写金蝶云星空旗舰版中物料编码对应的库存单位编码。
	数量	子表单-数字		——
	调出仓库	子表单-单行文本		填写金蝶云星空旗舰版中对应的仓库编码。
	出库货主类型	子表单-下拉框	非必填	下拉框选项为：供应商客户核算组织
	出库货主	子表单-单行文本		填写金蝶云星空旗舰版中出库货主对应的组织编码。
	出库保管者类型	子表单-下拉框		下拉框选项为：供应商客户库存组织
	调入仓库	子表单-单行文本	必填	填写金蝶云星空旗舰版中对应的仓库编码。
	调入货主类型	子表单-下拉框	非必填	下拉框选项为：供应商客户核算组织
	调入货主	子表单-单行文本		填写金蝶云星空旗舰版中对应的组织编码。
	调入保管者类型	子表单-下拉框		下拉框选项为：库存组织供应商客户
	调入保管者	子表单-单行文本		填写金蝶云星空旗舰版中对应的组织编码。
	子表明细聚合	子表单-单行文本		设置默认值为公式编辑，公式设置如下所示：CONCATENATE('{','"material_number":调拨明细.物料编码,"unit_number":调拨明细.库存单位,"qty":调拨明细.数量,"outwarehouse_number":调拨明细.调出仓库,"outownertype":调拨明细.出库货主类型,"outowner_number":调拨明细.出库货主,"outkeepertype":调拨明细.出库保管者类型,"outkeeper_number":调拨明细.出库保管者,"warehouse_number":调拨明细.调入仓库,"ownertype":调拨明细.调入货主类型,"owner_number":调拨明细.调入货主,"keepertype":调拨明细.调入保管者类型,"keeper_number":调拨明细.调入保管者','}') 注：根根据需要添加任意子表字段（如调出库存类型、调出库存状态等字段），最终通过在「子表明细聚合字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空旗舰版API中心查询）
	调拨明细聚合	多行文本		设置默认值为公式编辑，公式设置如下所示： JOIN(调拨明细.子表明细聚合,CHAR(10))
辅助字段	备注	单行文本		填写备注。
辅助字段	扩展字段	单行文本		设置默认值为公式编辑，公式参考如下所示： CONCATENATE('{','"comment":备注','}') 根据需要添加任意主表字段，最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空旗舰版API中心查询）

5. 流程节点设置

5.1 流程发起节点

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

注：除「子表聚合明细」、「调拨明细聚合」和「主表扩展字段」等公式编辑字段，其余字段均勾选「可见」「可编辑」权限。

5.2 插件节点

该插件支持在前端事件、智能助手Pro 和插件节点中调用触发，本文以插件节点调用为例，进行插件的调用配置。

5.2.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「直接调拨单」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：

5.2.2 设置插件节点

插件节点配置如下所示：

插件：选择「金蝶云星空旗舰版-直接调拨单」插件；
请求方法：设置为自定义，一般使用默认地址：/v2/im/im_transdirbill 即可；
操作类型：设置为自定义，勾选「保存」、「提交」或「审核」；
单据编号：设置为字段值，即「单据编号」字段；
单据类型：设置为字段值，即「单据类型」字段；
调出组织：设置为字段值，即「调出组织」字段；
业务类型：设置为字段值，即「业务类型」字段；
库存事务：设置为字段值，即「库存事务」字段；
调拨类型：设置为字段值，即「调拨类型」字段；
调入组织：设置为字段值，即「调入组织」字段；
业务日期：设置为字段值，即「业务日期」字段；
调拨明细：设置为字段值，即「调拨明细聚合」；
扩展字段：设置为字段值，即「主表扩展字段」。

5.3 启用流程

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

5.4 效果演示

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

6. 注意事项

6.1 插件节点配置字段说明

字段分类	字段名称	是否必填	字段来源	字段说明
基础字段	请求方法	必填	自定义	默认为标准地址，如有单据自定义地址，可填写自定义地址，地址不包含域名。
	操作类型		自定义	可根据表单提交后，金蝶云星空旗舰版进行哪些操作进行选择，提供以下 3 种操作：保存：仅保存提交：保存并提交审核：保存并提交和审核
	单据编号		字段值	此单价的编号。
	单据类型			直接调拨单的类型，包含以下几种：标准直接调拨单受托加工直接调拨单产品委外直接调拨单受托委外直接调拨单 VMI委外直接调拨单 VMI直接调拨单
	调出组织			为金蝶云星空旗舰版中的组织编码，可点击对应字段查看。
	业务类型			为金蝶云星空旗舰版中的业务类型编码，可点击对应字段勾选查看。
	库存事务			为金蝶云星空旗舰版中的库存事务编码，可点击对应字段查看。
	调拨类型			调拨的类型，包含以下2种：组织内调拨跨组织调拨
	调入组织			为金蝶云星空旗舰版中的组织编码，可点击对应字段查看。
	业务日期			——
	调拨明细			调拨明细，即表单中的「调拨明细聚合」。
扩展字段	扩展字段	非必填	字段值	根据需要添加任意主表字段，最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空旗舰版API中心查询）

6.2 关于插件的测试说明

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

7. 联系方式

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

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