金蝶云星空-销售出库单同步插件 - 简道云

1. 简介

1.1 插件简介

金蝶云星空-销售出库单同步插件支持根据表单业务数据，同步在金蝶云星空企业版生成销售出库单。

1.2 应用场景

常用于在简道云中发生订单类业务时，通过该插件自动在金蝶云星空企业版中生成对应的销售出库单。

1.3 预期效果

开启金蝶云星空-销售出库单同步插件，在「销售出库单」表单中输入信息提交后，自动在金蝶云星空中生成对应的销售出库单。效果如下所示：

1.4 使用说明

该插件为付费插件，请联系我们增购。插件购买流程如下所示：

2. 金蝶云星空平台配置

「三方授权」和「账号密码」为插件配置时的两种不同授权模式，您可根据配置插件时选择的授权模式，来查看不同的参数获取步骤。

2.1 获取三方授权下参数

1）系统管理员登录金蝶云星空后台，在应用菜单中搜索「第三方系统登录授权」，进入第三方系统登录授权页面。

2）在第三方系统登录授权页面，点击「新增」，填写好应用名称、集成用户等信息，复制「应用密钥」后点击「保存」：

3）保存后，点击「生成测试链接」。链接生成后，复制链接中的数据中心 ID、应用 ID、用户名称、请求地址前缀。链接中的信息与插件配置项的对应关系如下所示：

数据中心 ID：账套 ID
应用 ID：应用 ID
用户名称：授权用户
请求地址前缀：接口地址

2.2 获取账号密码下参数

1）系统管理员登录金蝶云星空后台，在应用菜单中搜索「web api」，进入公共设置下的 Web API 页面。

2）在 Web API 页面中，任意点击一张表单，再点击「在线测试 WebAPI」，进入 WebAPI 在线验证页面。复制并保存站点地址、帐套 id、用户名和用户密码等信息。验证页面内的信息与插件配置项的对应关系如下所示：

站点地址：请求地址
帐套 ID：帐套 ID
授权用户：授权用户
用户密码：用户密码

注：您页可在金蝶云星空「首页 >> 系统管理 >> 系统管理 >> 用户管理 >> 创建用户」处，新建一个用户单独用于插件使用。

3. 插件安装及启用

3.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：金蝶云星空-销售出库单同步插件安装。
安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。

2）在简道云「插件市场」处，安装「金蝶云星空-销售出库单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

在插件管理中，点击「调整插件配置」按钮，配置「授权模式」「账套ID」「授权用户」「用户密码」「用户ID」「应用密钥」「接口地址」，点击保存。

注：

1）金蝶云星空全部公有云版本和私有云 7.3 以上版本可使用三方授权模式，私有云 7.3 以下版本需使用账号密码授权模式。

2）三方授权模式无需填写用户密码，其他参数必填；账号密码授权模式无需填写应用 ID /应用密钥，其他参数必填。不同的授权模式，插件配置参数的获取方式不同。详情可见【2. 金蝶云星空平台配置】。

3.3 启用插件

在插件管理中，打开「金蝶云星空-销售出库单同步」插件右侧开关，启用插件。

4. 表单搭建

插件使用体验可先安装：金蝶云星空-销售出库单同步插件应用模板。本文将按照示例表单进行讲解。

以销售出库单为例，新建「销售出库单」流程表单，字段设置如下所示：

分类	字段名称	字段类型	字段说明
基础信息	单据编号	单行文本	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE("CK",TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3))
	销售日期	日期时间-年月日	——
	客户名称	单行文本
	客户编码
	产品编码
	出库明细	子表单
	出库明细.物料名称	单行文本	需要为金蝶云星空中的物料名称及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 物料列表」中查询。
	出库明细.物料编码	单行文本
	出库明细.含税单价	数字-数值	——
	出库明细.实发数量	数字-数值	——
	出库明细.税率	数字-数值	税率无百分号，填写 1-100 的数值
	出库明细.仓库名称	单行文本	需要为金蝶云星空中的仓库名称及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 供应链 >> 仓库列表」中查询。
	出库明细.仓库编码
	出库明细.库存单位名称		需要为金蝶云星空中的库存单位及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 计量单位列表」中查询。
	出库明细.库存单位编码
	出库明细.货主类型		需为以下 3 种类型：组织机构供应商客户注：一般情况下是组织，特殊业务才会用到供应商/客户
	出库明细.货主		需要为金蝶云星空中的货主及其对应编码。可在「金蝶云星空 >> 系统管理 >> 组织机构 >> 组织机构 >> 组织结构」中查询。注：只有 admin 账号可以查看
	出库明细.货主编号
	出库明细.是否赠品	下拉框	在「字段属性 >> 选项」处，选择默认为「否」
	出库明细.备注	单行文本	——
	出库明细.单行出库明细拼接字段	单行文本，	设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"fmaterialid":出库明细.物料编码',',"frealqty":出库明细.实发数量',',"ftaxprice":'+IF(ISEMPTY(出库明细.含税单价),0,出库明细.含税单价),',"fentrytaxrate ":'+IF(ISEMPTY(出库明细.税率),0,出库明细.税率),',"fstockid":出库明细.仓库编码',',"funitid":出库明细.库存单位编码',',"fownertypeid":出库明细.货主类型',',"fownerid":出库明细.货主编号',',"fisfree":'+IF(出库明细.是否赠品=="是",'"true"','"false"'),',"fentrynote":出库明细.备注','}')
	多行出库明细拼接字段	多行文本，	设置默认值为公式编辑，公式设置如下所示： JOIN(出库明细.单行出库明细拼接字段,CHAR(10))
辅助信息	销售部门	单行文本
	销售部门编号		为金蝶云星空中对应的销售部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	销售员		——
	销售员编号		为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。
	结算方式		——
	结算方式编号		为金蝶云星空中对应的结算方式编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 结算方式」中查询。
	收款条件		——
	收款条件编号		为金蝶云星空中对应的收款条件编码。可在「金蝶云星空 >> 财务会计 >> 应收款管理 >> 基础资料 >> 收款条件」中查询。
	收货方地址		——
	收货人姓名
	联系电话

5. 流程节点设置

5.1 流程发起节点

点击流程发起节点，在「节点属性 >> 节点名称」处，修改节点名称为「发起销售出库单」；在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：

注：除「单行出库明细拼接字段」和「多行出库明细拼接字段」，其余字段均勾选「可见」「可编辑」权限。

5.2 插件节点

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

5.2.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来，并修改插件节点的名称为「同步金蝶云星空」。

5.2.2 设置插件节点

1）选中插件节点，在「节点属性 >> 插件」处，点击「插件配置」：

2）插件节点配置如下所示：

插件：选择「金蝶云星空-销售出库单同步」插件；
操作类型：设置为自定义，下拉框中选择「审核」；
单据编号：设置为表单字段值，即「单据编号」字段；
单据类型：设置为自定义，下拉框中选择「现销出库单」；
销售日期：设置为表单字段值，即「销售日期」字段；
发货组织编码/销售组织编码/结算组织编码：设置为自定义，如 FH0001；
客户编码：设置为表单字段值，即「客户编码」字段；
出库明细：设置为表单字段值，即「多行出库明细拼接字段」。

5.3 启用流程

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

5.4 效果演示

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

6. 注意事项

6.1 插件节点配置字段说明

字段分类	字段名称	是否必填	字段来源	字段说明
基础字段	操作类型	必填	自定义	可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 3 种操作：保存：仅保存提交：保存并提交审核：保存并提交和审核
	单据编号		字段值	金蝶云星空此收款单的编号，编号需要是唯一的。
	单据类型		自定义/字段值	出库单的类型，包含以下 3 种：标准销售出库单零售出库单现销出库单
	销售日期		字段值	——
	发货组织编码/销售组织编码/结算组织编码		自定义/字段值	通常情况下，这三个编码是固定且相同的，特殊业务可分别传对应的编码。
	客户编码		自定义/字段值	为金蝶云星空中的客户编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 客户列表」中查询。
	出库明细		字段值	收款详情。即表单中的「多行出库明细拼接字段」。
辅助字段	销售部门编码	非必填	自定义/字段值	为金蝶云星空中对应的销售部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	销售组编码			为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务组列表」中查询。
	销售员编码			为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。
	收货方编码/结算方编码/付款方编码			通常情况下，这三个编码都是客户编码，特殊业务可分别传对应的编码。
	结算方式编码			为金蝶云星空中对应的结算方式编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 结算方式」中查询。
	收款条件编码			为金蝶云星空中对应的收款条件编码。可在「金蝶云星空 >> 财务会计 >> 应收款管理 >> 基础资料 >> 收款条件」中查询。
	承运商编码			为金蝶云星空中对应的承运商编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 供应商列表」中查询。
	发货部门编码			为金蝶云星空中对应的发货部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	库存组编码			为金蝶云星空中对应的发货部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务组列表」中查询。
	仓管员编码			为金蝶云星空中对应的发货部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 员工列表」中查询。

6.2 关于插件的测试说明

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

7. 联系方式

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

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