即时库存查询

1. 简介

1.1 插件简介

即时库存查询函数支持根据查询条件,查询金蝶云星空企业版中即时库存的信息,返回至简道云表单中。

1.2 应用场景

常用于在简道云中需要查询即时库存时,通过该插件查询在金蝶云星空企业版中的即时库存信息到表单,减少人工录入,避免库存信息滞后

1.3 预期效果

开启金蝶云星空-组装拆卸单/其他入库/其他出库单插件,在「即时库存查询」表单中输入信息提交后,自动在金蝶云星空中生成对应的返回信息。效果如下所示:

1.4 使用说明

该插件为付费插件插件购买和试用流程如下所示:

2. 插件安装及启用

2.1 安装插件

1)直接安装

2)开放市场处安装

在简道云「开放市场」处,安装「金蝶云星空-组装拆卸单/其他入库/其他出库单」插件。开放市场处安装方法可参见文档:插件市场中【2.3 插件安装】

2.2 配置插件

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

注:

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

2)三方授权模式无需填写用户密码,其他参数必填;账号密码授权模式无需填写应用 ID /应用密钥,其他参数必填。不同的授权模式,插件配置参数的获取方式不同。详情可见 金蝶云星空-组装拆卸单/其他入库/其他出库单【2. 金蝶云星空平台配置 】

2.3 启用插件

在插件管理中,打开「金蝶云星空-组装拆卸单/其他入库/其他出库单」插件右侧开关,启用插件。

3. 表单搭建

插件使用体验可先安装:金蝶云星空-组装拆卸单/其他入库/其他出库单插件应用模板。本文将按照示例中对应表单进行讲解。

新建「即时库存查询」表单,字段设置如下所示:

分类

字段名称

字段类型

是否必填

字段说明

查询条件

物料编码

单行文本

填写金蝶云星空企业版中对应的物料编码。

查询条件

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

'FMaterialId.fnumber=物料编码'

即时库存查询

按钮

设置为前端事件,按钮触发查询。

查询信息反馈

库存量

数字

返回字段,无需填写。

可用量

4. 前端事件设置

本文以前端事件调用为例,进行插件的调用配置示例。

4.1 添加按钮执行动作

进入「即时库存查询」表单中,点击「即时库存查询」按钮字段,在「字段属性>>执行动作」处,点击「设置>>添加执行动作」:

4.2 设置事件名称和说明

添加好前端事件后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分前端事件:

4.3 设置执行动作

设置执行动作如下:

  • 执行动作:选择「金蝶云星空-组装拆卸单/其他入库/其他出库单>>即时库存」插件;
  • 查询条件:选择「字段值>>查询条件」。
  • 存储关系:
    • 「库存量」 的值存储到「库存量」字段;
    • 「可用量」 的值存储到「可用量」字段;

设置完成后点击「保存」。

注:同一物料可能存在不同仓库,此处「库存量」和「可用量」 均为合计数量,如需精准到仓库或者批次查询,可参考下方【5.1 关于精准查询的说明】

4.4 效果演示

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

5. 注意事项

5.1 关于精准查询的说明

1)同一物料编码,可能对应多个库存组织、仓库、批号等信息,如需查询精准的库存信息,可参考下方新增查询条件,以增加仓库名称作为查询条件,设置示例如下:

字段名称

字段类型

是否必填

字段说明

物料编码

单行文本

填写金蝶云星空企业版中对应的物料编码。

仓库名称

填写金蝶云星空企业版中对应的仓库名称。可选填,仓库名称对应编码。

查询条件

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

IFS(AND(物料编码!="",仓库名称!=""),'FMaterialId.fnumber=物料编码 and fstockid.fnumber=仓库名称',ISEMPTY(物料编码),'fstockid.fnumber=仓库名称',ISEMPTY(仓库名称),'FMaterialId.fnumber=物料编码')

注:可根据需要添加查询条件,最终拼接查询条件中;(字段名可在 金蝶云星空API中心 查询)

注:

1.参考上方公式设置查询条件后,「仓库名称」可以设置为非必填,查询条件填写「仓库名称」和者「物料编码」或者填写其一,均可查询。

2.上述公式仅做示例,如条件增加有多种组合情况,需结合业务做穷尽。也可在前端事件中设置查询条件,此时仓库名称需为必填,查询条件勾选为:组合,设置为:FMaterialId.fnumber='物料编码(文本)' and FStockId.fnumber='仓库名称(文本)'

2)如需查询不同库存组织的即时库存信息,同上述设置类似,FStockOrgId.fnumber 为库存组织编码,查询条件示例公式如下:IFS(AND(物料编码!="",库存组织编码!=""),'FMaterialId.fnumber=物料编码 and FStockOrgId.fnumber=库存组织编码',ISEMPTY(物料编码),'FStockOrgId.fnumber=库存组织编码',ISEMPTY(库存组织编码),'FMaterialId.fnumber=物料编码')

6. 联系方式

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

  • 公司:成都轻如燕企业服务有限公司
  • 联系人:赵鹏
  • 联系电话:18583980516(微信同号)
  • 财务软件对接插件交流群,二维码如下:

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