金蝶云星空-收款单同步插件 - 简道云

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）直接安装

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

2）在简道云「插件市场」处，安装「金蝶云星空-收款单同步」插件。

3.2 配置插件

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

注：

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

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

3.3 启用插件

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

4. 表单搭建

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

以销售收款为例，新建「销售收款单」表单，字段设置如下所示：

分类	字段名称	字段类型	字段说明
基础信息 (必填)	单据编号	单行文本	注：自己定义一个单据编号，需要是唯一，同时作为金蝶云星空此单据的编号。公式举例： CONCATENATE("SK",TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3))
	业务日期	日期时间-年月日	——
	付款单位	单行文本	——
	付款单位编码		需要为金蝶云星空中的付款单位类型对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料」中查询。
	收款明细.结算方式		需要为金蝶云星空中的结算方式及其对应编码。可在「金蝶云星空 >>基础管理 >> 基础资料 >> 财务会计 >> 结算方式」中查询。
	收款明细.结算方式编码
	收款明细.收款用途		需要为金蝶云星空中的收款用途及其对应编码。可在「金蝶云星空 >> 财务会计 >> 出纳管理 >> 基础资料 >> 收付款用途」中查询。
	收款明细.收款用途编码
	收款明细.应收金额	数字-数值	——
	收款明细.现金折扣
	收款明细.手续费
	收款明细.长短款
	收款明细.银行账号	单行文本	需要为金蝶云星空中的银行账号及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 银行账号」中查询。
	收款明细.银行账号编码
	收款明细.现金账号		需要为金蝶云星空中的现金账号及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 现金账号」中查询。
	收款明细.现金账号编码
	收款明细.费用项目		需要为金蝶云星空中的费用项目及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 费用项目」中查询。
	收款明细.费用项目编码
	收款明细.费用承担部门		需要为金蝶云星空中的费用承担部门及其对应编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	收款明细.费用承担部门编码
	收款明细.单行收款明细拼接字段		单行文本，设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"fsettletypeid":收款明细.结算方式编码',',"fpurposeid":收款明细.收款用途编码',',"frectotalamountfor":'+IF(ISEMPTY(收款明细.应收金额),0,收款明细.应收金额),',"fsettledistamountfor ":'+IF(ISEMPTY(收款明细.现金折扣),0,收款明细.现金折扣),',"fhanlingchargefor":'+IF(ISEMPTY(收款明细.手续费),0,收款明细.手续费),',"foverunderamountfor":'+IF(ISEMPTY(收款明细.长短款),0,收款明细.长短款),',"faccountid":收款明细.银行账号编码',',"fcashaccount":收款明细.现金账号编码',',"fcostid":收款明细.费用项目编码',',"fcostdepartmentid":收款明细.费用承担部门编号','}')
	多行收款明细拼接字段	多行文本，	设置默认值为公式编辑，公式设置如下所示： JOIN(收款明细.单行收款明细拼接字段,CHAR(10))
辅助信息 (非必填)	销售部门	单行文本	——
	销售部门编号		为金蝶云星空中对应的销售部门编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。
	销售员		——
	销售员编号		为金蝶云星空中对应的销售组编码。可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。
	备注		——

5. 流程节点设置

5.1 流程发起节点

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

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

5.2 插件节点

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

5.2.1 添加插件节点

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

5.2.2 设置插件节点

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

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

插件：选择「金蝶云星空-收款单同步」插件
操作类型：设置为自定义，下拉框中选择「保存」；
单据编号：设置为表单字段值，即「单据编号」字段；
单据类型：设置为自定义，下拉框中选择「销售收款单」；
业务日期：设置为表单字段值，即「业务日期」字段；
收款组织编码/结算组织编码/销售组织编码：设置为自定义，如 0001；
付款单位类型：设置为自定义，企业可根据自身需求在下拉框中选择；
付款单位编码：设置为表单字段值，即「付款单位编码」字段；
往来单位类型：设置为自定义，企业可根据自身需求在下拉框中选择；
往来单位编码：设置为自定义，如 0004；
收款明细：设置为表单字段值，即「多行收款明细拼接字段」。

5.3 启用流程

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

5.4 效果演示

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

6. 注意事项

6.1 插件节点配置字段说明

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

6.2 关于插件的测试说明

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

7. 联系方式

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

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