发货通知单
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. 表单搭建
插件使用体验可先安装：金蝶星空旗舰销售单据同步插件应用模板。本文将按照示例中对应表单进行讲解。
新建「发货通知单」流程表单，字段设置如下所示：
字段分类 | 字段名称 | 字段类型 | 是否必填 | 字段说明 |
基础信息 | 单据编号 | 单行文本 | 是 | 自己定义一个单据编号，需要是唯一，同时作为金蝶云星空旗舰版此单据的编号。公式举例： CONCATENATE(TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3)) |
单据类型 | 下拉框 | 下拉框选项为：
| ||
发货组织 | 单行文本 | 填写金蝶云星空旗舰版中对应的发货组织和销售组织编码。 | ||
销售组织 | ||||
订货客户 | 填写金蝶星空旗舰版中对应的客户编码。 | |||
业务日期 | 日期时间 | 年-月-日 | ||
通知明细 | 行类型 | 子表单-下拉框 | 是 | 下拉框选项为：
|
物料编码 | 子表单-单行文本 | 填写金蝶星空旗舰版中对应的物料编码。 | ||
库存单位 | 填写金蝶星空旗舰版中对应的单位编码。 | |||
数量 | 子表单-数字 | —— | ||
结算组织 | 子表单-单行文本 | 否 | 填写金蝶星空旗舰版中对应的结算组织编码。 | |
子表明细聚合字段 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"linetype_number":通知明细.行类型,"material_number":通知明细.物料编码,"unit_number":通知明细.库存单位,"qty":通知明细.数量,"entrysettleorg_number":通知明细.结算组织','}') 注：根据需要添加任意子表字段，最终通过在「子表明细聚合字段」中拼接字段名和字段值进行数据传递；（字段名可在 金蝶星空旗舰版API中心 查询） | |||
通知聚合明细 | 多行文本 | 设置默认值为公式编辑，公式设置如下所示： JOIN(应付明细.聚合字段,CHAR(10)) | ||
扩展信息 | 备注 | 单行文本 | —— | |
扩展字段 | 设置默认值为公式编辑，公式参考如下所示： CONCATENATE('{','"comment":备注','}') 注：根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在 金蝶星空旗舰版API中心 查询） | |||
返回信息 | 单据主键 | 返回信息无需填写。 「单据状态」返回标识和含义如下所示： A 表示：创建；B 表示：审核中；C 表示：已审核；D 表示：重新审核；Z 表示：暂存。 | ||
单据状态 |
4. 流程节点设置
该插件支持在 前端事件、 智能助手Pro 和 插件节点 中调用触发，本文以插件节点调用为例，进行插件的调用配置。
4.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：除「子表聚合明细」、「通知明细聚合」和「扩展字段」等公式编辑字段，其余字段均勾选「可见」「可编辑」权限。
4.2 插件节点
4.2.1 添加插件节点
在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「发货通知单」，选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：
4.2.2 设置插件节点
插件节点配置如下所示：
- 插件：选择「金蝶星空旗舰销售单据同步插件>>发货通知单」插件；
- 请求方法：设置为自定义，有自定义接口地址时需填写；
- 操作类型：设置为自定义，勾选「保存」、「提交」或「审核」；
- 单据编号：设置为字段值，即「单据编号」字段；
- 单据类型：设置为字段值，即「单据类型」字段；
- 发货组织：设置为字段值，即「发货组织」字段；
- 销售组织：设置为字段值，即「销售组织」字段；
- 业务日期：设置为字段值，即「业务日期」字段；
- 订货客户：设置为字段值，即「订货客户」字段；
- 通知明细：设置为字段值，即「通知聚合明细」
- 扩展字段：设置为字段值，即「扩展字段」。
- 字段存储关系：点击「添加」按钮，进行如下设置：
- 单据主键：的值存储到，「单据主键」字段；
- 单据状态：的值存储到，「单据状态」字段。
4.3 启用流程
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 插件节点配置字段说明
字段分类 | 字段名称 | 是否必填 | 字段来源 | 字段说明 |
基础字段 | 请求方法 | 必填 | 自定义 | 默认为标准地址，如有单据自定义地址，可填写自定义地址，地址不包含域名。 |
操作类型 | 可根据表单提交后，金蝶云星空旗舰版进行哪些操作进行选择，提供以下 3 种操作：
| |||
单据编号 | 字段值 | 此单据的编号。 | ||
单据类型 | 发货通知单的类型，包含以下几种：
| |||
发货组织 | 为金蝶云星空旗舰版中的组织编码，可点击对应字段查看。 | |||
销售组织 | ||||
订货客户 | 为金蝶云星空旗舰版中的订货客户编码，可点击对应字段查看。 | |||
业务日期 | —— | |||
通知明细 | 通知明细，即表单中的「通知聚合明细」。 | |||
扩展字段 | 扩展字段 | 非必填 | 字段值 | 根据需要添加任意主表字段，最终通过在「扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在 金蝶云星空旗舰版API中心 查询） |
5.2 关于插件的测试说明
因发货通知单同步后，涉及金蝶星空旗舰版关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶星空旗舰版系统中的业务规则相结合。
6. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
- 财务软件对接插件交流群，二维码如下：
400-111-0890
在线咨询