一、 功能介绍

库存查询指在供应链单据上根据界面录入的库存维度，对即时库存进行查询并返回到单据的功能。主要目的是为了用户能快捷录入，且用户的使用频率非常高。

功能在星瀚供应链发布之初就已经提供，随着客户数量的增加，部分应用场景原功能不能支持，所以在4.0.020版本上提供了全新的一套功能。那么新功能能带给我们什么样的使用体验呢？请看下节详细介绍

二、 新特性说明

1、 查询配置界面迁移到前台

库存查询需要通用和兼容各单据，就需要支持可配置，比如单据字段与余额字段如何映射？单据哪些字段作为查询条件？查询出的结果返回哪些字段？以及其他各参数配置。原功能是要通过开发平台扩展单据进行配置的，新功能将配置迁移到了前台，配置相关菜单权限即可使用。

菜单路径：【供应链云】-【业务设置】-【通用配置】-【库存查询配置】

2、 支持返回库存到单据子分录

部分单据由于表结构比较特殊，例如组装单，为双分录结构，即组装前物料明细为组装后物料明细下的子分录。原有功能不能支持将查询的库存返回到子分录，而新功能已经从技术上实现了。

3、 支持返回新行插入原行之后

存在通过单据上按一行物料查询返回多行的场景，原来系统处理是将新增的行增加到分录的最后，当某些单据本身分录行数较多或已经分页时，用户需要拖动滚动条或翻页才能查看，影响用户体验。新功能配置中增加了参数，可配置返回到当前选中行之后。

4、 返回新行携带原行信息

同样的按一行查询返回多行场景，原来系统处理逻辑是与手工新增行一致，非通过余额返回的字段，如：结算组织、赠品、单价等字段会按单据界面逻辑获取默认值。新功能处理了将原选中行中的信息自动携带到新行中，比如用户已经录入了“结算组织”，再通过此行查询返回的多行都会自动复制携带此字段。（此特性不升级到新功能也可获得）

5、 支持单据计量单位与库存单位不一致的返回

应用场景1：例如某企业销售单位为“吨”，库存单位为“千克”，用户创建销售订单时需要依据查询的库存量下单。需要查询为“千克”的库存，计算为“吨”的数量后返回单据。

应用场景2：某客户仅用“基本数量”更新余额，但单据上又需要体现计量单位和数量。

原功能仅能支持按即时库存的单位和数量返回到单据，而新功能支持参数配置，实现按单据上的计量单位与库存单位换算率计算后返回数量到单据。

6、 支持设置单据字段必录校验

开启此参数后，在执行库存查询前将校验单据上该字段是否为空，如果为空则不执行查询并提示用户必须录入。可用于缩小查询范围，避免查询大量数据影响查询效率以及方便用户查看。

7、 支持设置单据和余额的过滤条件（V6.0.1版本发布）

应用场景：例如希望只查询出来库存状态为“可用”的库存，待检、冻结、在途等库存不要查询出来。

配置此过滤条件后，会按此条件对单据或库存余额进行过滤。

8、 库存查询返回多行到单据，支持按选中顺序返回并逐行分摊数量（V6.0.4版本发布）

库存查询弹窗增加了“顺序返回”的开关（默认不开启，如果希望默认开启，可以在开发平台弹窗元数据设置默认值），开启后会在下发显示另外一个表格，用于记录用户手工选择库存明细行的顺序，最后会按此表格的数据返回到单据。

应用场景：例如出库单需求A物料，数量15件，查询库存分别有三个批号PH-002 3件、PH-003 4件、PH-006 10件，用户希望出库顺序为PH-006、PH-003、PH-002，那么就按此顺序选择后，会添加到记录顺序的表格，点击返回后，单据上为三行分别为PH-006 10件、PH-003 4件、PH-002 1件，总共15件。

9、 支持打开弹窗默认不执行查询（V6.0.8版本发布）

库存查询弹窗增加了“默认执行查询”的开关，如果关闭，则再次打开弹窗时不会默认执行查询，用户录入完查询条件后由值改变触发查询。此开关为用户参数，用户修改后会进行记录，当前用户再次打开时会保持上次的默认值。

应用场景：有的客户库存数据量大，在不选中单据分录行执行查询时，不会带查询条件，即相当于全量查询库存。这样有可能造成查询慢，用户等待时间长，并且这样的数据对用户没有意义，还要再次录入查询条件过滤出需要的数据。所以用户希望打开弹窗不要马上执行查询，等录入了查询条件，缩小了查询范围后再执行。

10、 支持仅查询可用库存不为0的明细行（V6.0.8版本发布）

库存查询弹窗增加了“仅查询可用库存不为0”的开关，如果开启，则会过滤掉可用库存为0的行。此开关为用户参数，用户修改后会进行记录，当前用户再次打开时会保持上次的默认值。

应用场景：在使用了库存预留的情况下，某些物料的库存明细行被完全预留了，即“预留数量”等于“库存数量”，则“可用数量”等于0。将没有可用量的物料返回到单据上也没法出库，所以有的客户则不想查询出这部分库存。

11、 支持将库存一个字段返回到单据上两个字段（V6.0.8版本发布）

库存查询配置的字段映射栏增加了“关联返回单据字段”的配置，支持库存字段返回到单据字段同时返回到此关联字段。

应用场景：例如某出库申请单，查询库存需要同时返回到数量和申请数量字段；例如调拨单，查询库存需要同时返回到调出方和调入方的字段。

三、 功能升级策略

1、 系统不做自动升级，原功能正常可用。但建议用户都升级到新功能，因为后续迭代，只会基于新功能进行优化。

2、 对新特性有需要的客户可以手工升级，通过配置列表的升级按钮操作（升级按钮出厂默认隐藏，需要到开发平台设置可见，V6.0.8版本后默认显示）。

3、对于新客户，上线到V6.0.8及以上版本，无需再手工升级，上线自动启用新功能。

3、 历史已有配置切换，客户扩展修改过出厂预置的配置，或者二开单据新增的配置，系统会通过程序在升级同时获取原有配置自动创建到新配置中。

4、 升级注意事项：

      1）目前仅支持“单据”类型的实体从元数据配置升级到前台配置，如动态表单类型实体的配置暂无法自动升级，请到前台手工新增配置。

5、 配置界面字段说明，请查阅链接：界面字段简介

四、 常见问题

1、 提示未找到配置

库存查询操作无关联的查询配置或配置被禁用。

2、 提示存在多个规则

同一个操作存在多条配置，需要将多余的禁用。

3、 出库单通过库存查询返回，为什么出库仍然提示库存不足？

上面已经介绍了，库存查询功能也是可配置的，可以检查其配置的查询条件与余额更新规则配置是否一致，同时检查返回单据的维度，用户自定义增加的库存维度也别忘记在配置中增加，总之只有单据与余额表所有维度一致了才可以扣减库存。

4、单据点击库存查询按钮，提示没有权限

库存查询功能是单独的菜单，与即时库存报表不同，需要对用户或角色分配【物料即时库存查询】的权限。

5、用户感觉库存查询弹窗太小，是否能配置全屏？

开发平台扩展im_materialinvacc元数据，设置样式即可。

变更记录

-the end-