一、 功能介绍

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

功能在星瀚供应链发布之初就已经提供，随着客户数量的增加，部分应用场景原功能不能支持，所以在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版本发