销售退货单同步 - 简道云

销售退货单同步

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))
	单据类型	下拉框		下拉框选项为：标准销售退货单 VMI销售退货单
	库存组织	单行文本		填写金蝶云星空旗舰版中对应的库存组织编码。
	业务类型			填写金蝶云星空旗舰版中对应的业务类型编码。
	库存事务			填写金蝶云星空旗舰版中对应的库存事务编码。
	业务日期	日期时间		年-月-日
	收货客户	单行文本		填写金蝶云星空旗舰版中对应的客户编码。
	销售组织	单行文本		填写金蝶云星空旗舰版中对应的组织编码。
退货明细	物料编码	子表单-单行文本	必填	填写金蝶云星空旗舰版中对应的物料编码。
	库存单位	子表单-单行文本		填写金蝶云星空旗舰版中物料编码对应的库存单位。
	数量	子表单-数字		——
	仓库	子表单-单行文本	非必填	填写金蝶云星空旗舰版中对应的仓库编码。
	出库货主类型	子表单-下拉框	必填	下拉框选项为：供应商客户核算组织
	出库货主	子表单-单行文本		填写金蝶云星空旗舰版中出库货主对应的组织编码。
	出库保管者类型	子表单-下拉框		下拉框选项为：供应商客户库存组织
	出库保管者	子表单-单行文本		填写金蝶云星空旗舰版中出库保管者对应的组织编码。
	折扣方式	子表单-下拉框		下拉框选项为：折扣率(%) 单位折扣额无
	结算组织	子表单-单行文本		填写金蝶云星空旗舰版中对应的组织编码
	销售出库单编号		非必填	填写金蝶云星空旗舰版中的销售出库单编号。
	子表明细聚合		非必填	设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"material_number":退货明细.物料编码,"unit_number":退货明细.库存单位,"qty":退货明细.数量,"warehouse_number":退货明细.仓库,"outownertype":退货明细.出库货主类型,"outowner_number":退货明细.出库货主,"outkeepertype":退货明细.出库保管者类型,"outkeeper_number":退货明细.出库保管者,"discounttype":退货明细.折扣方式,"entrysettleorg_number":退货明细.结算组织,"order_code":退货明细.销售出库单编号','}') 注：根据需要添加任意子表字段，最终通过在「子表明细聚合字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空旗舰版API中心查询）
	退货明细聚合			设置默认值为公式编辑，公式设置如下所示： JOIN(退货明细.子表明细聚合,CHAR(10))
辅助字段	备注	单行文本		填写备注。
辅助字段	主表扩展字段	单行文本		设置默认值为公式编辑，公式参考如下所示： CONCATENATE('{','"comment":备注','}') 注：根据需要添加任意主表字段，最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递；（字段名可在金蝶云星空旗舰版API中心查询）

4. 流程节点设置

4.1 流程发起节点

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

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

4.2 插件节点

4.2.1 添加插件节点

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

4.2.2 设置插件节点

插件节点配置如下所示：

插件：选择「金蝶云星空旗舰版-销售订单/销售出库单>>销售退货单」插件；
请求方法：设置为自定义，通常使用默认地址：/v2/im/im_saloutbill 即可；
操作类型：设置为自定义，勾选「保存」、「提交」或「审核」；
单据编号：设置为字段值，即「单据编号」字段；
单据类型：设置为字段值，即「单据类型」字段；
库存组织：设置为字段值，即「库存组织」字段；
业务类型：设置为字段值，即「业务类型」字段；
业务日期：设置为字段值，即「业务日期」字段；
库存事务：设置为字段值，即「库存事务」字段；
收货客户：设置为字段值，即「收货客户」字段；
销售组织：设置为字段值，即「销售组织」字段；
退货明细：设置为字段值，即「退货明细聚合」
扩展字段：设置为字段值，即「主表扩展字段」。

4.3 启用流程

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

4.4 效果演示

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

5. 注意事项

5.1 插件节点配置字段说明

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

5.2 关于插件的测试说明

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

6. 联系方式

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

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