分步式调入单
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. 表单搭建
插件使用体验可先安装：金蝶云星空-组装拆卸单/其他入库/其他出库单插件应用模板。本文将按照示例中对应表单进行讲解。
新建「分步式调入单」流程表单，字段设置如下所示：
分类 | 字段名称 | 字段类型 | 是否必填 | 字段说明 |
基础信息 | 单据编号 | 单行文本 | 是 | 注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE(1000+RECNO()) |
单据类型 | 下拉框 | 下拉框选项为：
| ||
单据日期 | 日期 | 年-月-日 | ||
调入库存组织 | 单行文本 | 填写金蝶云星空企业版中对应的调入库存组织编码。 | ||
调入货主类型 | 下拉框 | 下拉框选项为：
| ||
调出库存组织 | 单行文本 | 填写金蝶云星空企业版中对应的调出库存组织编码。 | ||
调出货主类型 | 下拉框 | 下拉框选项为：
| ||
调拨方向 | 下拉框选项为：
| |||
业务类型 | 下拉框选项为：
| |||
调拨类型 | 下拉框选项为：
| |||
调入明细 | 产品类型 | 子表单-下拉框 | 是 | 下拉框选项为：
|
物料编码 | 子表单-单行文本 | 填写金蝶云星空企业版中对应的物料编码。 | ||
调出物料 | 设置默认值为公式编辑，公式设置如下所示： | |||
父物料编码 | 否 | 填写金蝶云星空企业版中对应的父物料编码。 | ||
单位 | 是 | 填写金蝶云星空企业版中对应的单位编码。 | ||
调入数量 | 填写调入的数量。 | |||
计划调拨数量 | 子表单-数字 | 等于字段值：调入数量。 | ||
调出仓库 | 子表单-单行文本 | 填写金蝶云星空企业版中对应的调出仓库编码。 | ||
调出货主 | 填写金蝶云星空企业版中对应的调出货主编码。 | |||
调入仓库 | 填写金蝶云星空企业版中对应的调入仓库编码。 | |||
调入货主 | 填写金蝶云星空企业版中对应的调入货主编码。 | |||
备注 | 否 | 填写调入明细中的备注。 | ||
子表聚合 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"FRowType":调入明细.产品类型,"FMaterialId":调入明细.物料编码,"FSrcMaterialId.fnumber":调入明细.调出物料,"FParentMatId.fnumber":调入明细.父物料编码,"FUnitID":调入明细.单位,"FPlanTransferQty":调入明细.计划调拨数量,"FQty":调入明细.调入数量,"FSrcStockId.fnumber":调入明细.调出仓库,"FOwnerOutID":调入明细.调出货主,"FDestStockId.fnumber":调入明细.调入仓库,"FOwnerID":调入明细.调入货主,"FEntryNote":调入明细.备注','}') 注：可根据需要添加任意主表字段，最终通过在「子表聚合」字段中拼接字段名和字段值进行数据传递；（字段名可在 金蝶云星空API中心 查询） | |||
调出明细聚合 | 多行文本 | 设置默认值为公式编辑，公式设置如下所示： JOIN(调出明细.子表聚合,CHAR(10)) | ||
扩展参数 | 源单关联 | 下拉框 | 是 | 下拉框选项为：
|
源单名称 | 下拉框选项为：
| |||
源单编码 | 单行文本 | 填写源分步式调出单的编码。 | ||
扩展字段 | 否 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"relation":源单关联,"relationName":源单名称,"relationCode":源单编码','}') 注：可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在 金蝶云星空API中心 查询） |
注：分步式调入单的源单关联、源单名称、源单编码是必填项。
4. 流程节点设置
4.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：结合企业实际业务设置字段权限，除公式编辑字段，其余字段均可勾选「可见」「可编辑」权限。
4.2 插件节点
4.2.1 添加插件节点
在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「分步式调入单」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：
4.2.2 设置插件节点
插件节点配置如下所示：
- 插件：选择「金蝶云星空-组装拆卸单/其他入库/其他出库单>>分步式调入单」插件；
- 操作类型：设置为自定义，下拉框中选择「保存」；
- 单据编号：设置为字段值，即「单据编号」字段；
- 单据类型：设置为字段值，即「单据类型」字段；
- 调拨类型：设置为字段值，即「调拨类型」；
- 调拨方向：设置为字段值，即「调拨方向」字段；
- 调入库存组织：设置为字段值，即「调入库存组织」字段；
- 调入货主类型：设置为字段值，即「调入货主类型」字段；
- 调出库存组织：设置为字段值，即「调出库存组织」字段；
- 调出货主类型：设置为字段值，即「调出货主类型」字段；
- 日期：设置为字段值，即「单据日期」字段；
- 业务类型：设置为字段值，即「业务类型」；
- 调出明细：设置为字段值，即「调入明细聚合」；
- 扩展字段：设置为字段值，即「扩展字段」。
4.3 启用流程
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 插件节点配置字段说明
字段分类 | 字段名称 | 是否必填 | 字段来源 | 字段说明 |
基础字段 | 操作类型 | 是 | 自定义 | 可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 4 种操作：
|
单据编号 | 字段值 | 金蝶云星空此单据的编号，编号需要是唯一的。 | ||
单据类型 | 分布式调入单的类型，包含以下2种：
| |||
调入货主类型 | 调入货主类型，包含以下3种：
| |||
调入库存组织 | 填写金蝶云星空企业版中对应的调入库存组织编码。 | |||
调出货主类型 | 调出货主类型，包含以下3种：
| |||
调出库存组织 | 填写金蝶云星空企业版中对应的调出库存组织编码。 | |||
日期 | —— | |||
业务类型 | 业务类型包含以下1种：
| |||
调拨方向 | 调拨方向，包含以下2种：
| |||
调拨类型 | 调拨类型包含一下一种：
| |||
辅助字段 | 调入明细 | 否 | 字段值 | 调入明细，即表单中的「调入明细聚合」字段。 |
扩展字段 | 可根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在 金蝶云星空API中心 查询） |
5.2 关于插件的测试说明
因分步式调入单同步后，涉及金蝶云星空关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶云星空系统中的业务规则相结合。
6. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
400-111-0890
在线咨询