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

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.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":出库明细.含税单价,"fentrytaxrate ":出库明细.税率,"fstockid":出库明细.仓库编码,"funitid":出库明细.库存单位编码,"FOwnerTypeID":出库明细.货主类型,"FOwnerID":出库明细.货主编号','}')

注:可根据需要添加任意子表字段,最终通过在「出库明细.单行出库明细拼接字段」中拼接字段名和字段值进行子表数据传递;(字段名可在 金蝶云星空API中心 查询)

多行出库明细拼接字段

多行文本

设置默认值为公式编辑,公式设置如下所示:

JOIN(出库明细.单行出库明细拼接字段,CHAR(10))

主表扩展字段

单行文本

设置默认值为公式编辑,公式设置如下所示:

CONCATENATE('{','"FSaleDeptID.fnumber":销售部门编号,"FSalesManID.fnumber":销售员编号,"FStockerID.fnumber":结算方式编码,"FStockerID.fnumber":收款条件编码,"FNote":备注','}')

辅助信息

(非必填)

销售部门

——

销售部门编号

为金蝶云星空中对应的销售部门编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。

销售员

——

销售员编号

为金蝶云星空中对应的销售组编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。

结算方式

——

结算方式编码

为金蝶云星空中对应的结算方式编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 结算方式」中查询。

收款条件

——

收款条件编码

为金蝶云星空中对应的收款条件编码。

可在「金蝶云星空 >> 财务会计 >> 应收款管理 >> 基础资料 >> 收款条件」中查询。

备注

——

……

……

可根据需要添加任意主表字段,最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递;(字段名可在 金蝶云星空API中心 查询)

5. 流程节点设置

5.1 流程发起节点

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

注:除「单行出库明细拼接字段」、「多行出库明细拼接字段」和「主表扩展字段」,其余字段均勾选「可见」「可编辑」权限。

5.2 插件节点

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

5.2.1 添加插件节点

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

5.2.2 设置插件节点

插件节点配置如下所示:

  • 插件:选择「金蝶云星空-销售出库单同步」插件;
  • 操作类型:设置为自定义,下拉框中选择「保存」;
  • 单据编号:设置为表单字段值,即「单据编号」字段;
  • 单据类型:设置为自定义,下拉框中选择「现销出库单」;
  • 销售日期:设置为表单字段值,即「销售日期」字段;
  • 发货组织编码/销售组织编码:设置为自定义,如 0001;
  • 客户编码:设置为表单字段值,即「客户编码」字段;
  • 出库明细:设置为表单字段值,即「多行出库明细拼接字段」;
  • 主表扩展字段:设置为表单字段值,即「主表扩展字段」。

5.3 启用流程

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

5.4 效果演示

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

6. 注意事项

6.1 插件节点配置字段说明

字段分类

字段名称

是否必填

字段来源

字段说明

基础字段

操作类型

必填

自定义

可根据表单提交后,金蝶云进行哪些操作进行选择,提供以下 3 种操作:

  • 保存:仅保存
  • 提交:保存并提交
  • 审核:保存并提交和审核

单据编号

字段值

金蝶云星空此收款单的编号,编号需要是唯一的。

单据类型

自定义/字段值

出库单的类型,包含以下 3 种:

  • 标准销售出库单
  • 零售出库单
  • 现销出库单

销售日期

字段值

——

发货组织编码/销售组织编码/结算组织编码

自定义/字段值

通常情况下,这三个编码是固定且相同的,特殊业务可分别传对应的编码。

客户编码

为金蝶云星空中的客户编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 客户列表」中查询。

出库明细

字段值

收款详情。即表单中的「多行出库明细拼接字段」。

辅助字段

销售部门编码

非必填

自定义/字段值

为金蝶云星空中对应的销售部门编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。

销售组编码

为金蝶云星空中对应的销售组编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务组列表」中查询。

销售员编码

为金蝶云星空中对应的销售组编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务员列表」中查询。

收货方编码/结算方编码/付款方编码

通常情况下,这三个编码都是客户编码,特殊业务可分别传对应的编码。

结算方式编码

为金蝶云星空中对应的结算方式编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 财务会计 >> 结算方式」中查询。

收款条件编码

为金蝶云星空中对应的收款条件编码。

可在「金蝶云星空 >> 财务会计 >> 应收款管理 >> 基础资料 >> 收款条件」中查询。

承运商编码

为金蝶云星空中对应的承运商编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 供应商列表」中查询。

发货部门编码

为金蝶云星空中对应的发货部门编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 部门列表」中查询。

库存组编码

为金蝶云星空中对应的发货部门编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 公共资料 >> 业务组列表」中查询。

仓管员编码

为金蝶云星空中对应的发货部门编码。

可在「金蝶云星空 >> 基础管理 >> 基础资料 >> 主数据 >> 员工列表」中查询。

主表扩展字段

……

……

可根据需要添加任意主表字段,最终通过在「主表扩展字段」中拼接字段名和字段值进行主表数据传递;(字段名可在 金蝶云星空API中心 查询)

6.2 关于插件的测试说明

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

7. 联系方式

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

  • 公司:成都轻如燕企业服务有限公司
  • 联系人:赵鹏
  • 联系电话:18583980516(微信同号)

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验