说明：

系统迭代至今，已经封装了多种获取库存相关的通用操作与服务、供不同场景下使用配置。

1. 很多客户、实施、开发人员刚接触的话，无法有效快速区分各个操作与服务的区别，下文供整理介绍各个操作与服务的区别以及应用场景。

2. 每个操作或服务的处理逻辑其实很复杂受控参数也非常多，下面仅针对主逻辑做描述。

3. 另外关于拣货，系统菜单中以“拣货”描述、而bos中服务以“捡货”描述，目前两者没有区别，由于众多地方已经引用了很难统一。

详述：

（下面以以上各个操作与服务做详细介绍）

1. 库存查询

   应用场景：

   a. 配置于单据表体按钮点击事件。 b. 单据上明细信息的焦点行以及焦点字段，点击库存查询，勾选此次需要返回的即时库存明细信息，点击返回按钮，即时库存明细数据返回至单据明细信息行中。

   处理逻辑：

   a. 根据设置的过滤字段 按照焦点行对应维度映射字段值过滤展示数据；b. 根据设置的返回匹配字段来判断是否匹配当前行，匹配行时则根据需求供给数量来确定返回数量 需要新增行时以关联复制行新增，不匹配时则做普通新增行处理；c. 根据设置的返回字段返回值至单据对应字段；

2. 获取即时库存信息

   应用场景：

   a. 配置于单据表体某字段值更新事件，或者配置于单据表体按钮点击事件。 b. 通过录入某字段触发获取当前行维度下对应的库存数量，或者通过点击按钮获取当前表体所有行对应的库存数量。

   处理逻辑

   a. 按照单据行设置的单据匹配的非空字段值 过滤即时库存数据;b. 根据符合条件数据合计基本单位数量、辅单位数量;c. 根据配置的单位换算出业务单位数量返回至设置接受字段;

   

3. 获取即时库存操作

   应用场景：

   a. 配置于单据表体按钮点击事件、或者 搭配列表插件配置于单据列表的按钮点击事件。 b. 通过点击按钮获取当前表体所有行对应的库存数量、或者点击列表按钮返回当前列表行对应的库存数量。

   处理逻辑：同上述 “获取即时库存信息服务”。该操作相当于”获取即时库存信息服务”的升级版，支持列表获取库存。

4. 无源单批号捡货

   应用场景：

   a. 配置于单据表体字段值更新事件。标准系统默认配置出库类单据物料字段值更新。b. 新增单据录入物料时触发该服务携带最近一条满足条件的库存明细填充至单据。

   处理逻辑：

   a. 根据当前服务设置的条件以及拣货设置规则判断当前行是否需要执行；b. 根据当前行设置的映射字段非空值且参与过滤的维度过滤出即时库存；c. 返回优先级最高的一条库存;d. 根据设置的返回字段，将拣货的库存维度返回至对应字段；

5. 批号捡货

   应用场景：

   a. 配置于单据转换路线-表单服务策略。标准系统默认配置目标单为出库类单据的转换路线服务上。 b. 单据下推至目标单根据下推后目标单数据进行拣货将拣货结果数据返回至目标单。

   处理逻辑：

   a. 根据当前服务设置的条件以及拣货设置规则判断当前行是否需要执行；b. 根据当前行设置的映射字段非空值且参与过滤的维度过滤出即时库存；c. 根据单据行需求数量匹配优先级高的多条即时库存拆分返回行;d. 根据设置的返回字段，将拣货的库存维度返回至对应字段；

   

6. 匹配库存返回

   应用场景：

   a. 配置于单据表体按钮点击事件。标准系统默认配置出库类单据物料字段值更新。 b. 新增单据录入物料等库存维度字段、以及录入单据数量后，点击匹配库存，即可根据单据行维度和需求数量匹配返回库存。

   处理逻辑：

   a. 根据当前服务设置的条件以及拣货设置规则判断当前行是否需要执行；b. 根据当前行设置的映射字段非空值且参与过滤的维度过滤出即时库存；c. 根据单据行需求数量匹配优先级高的多条即时库存拆分返回行;d. 根据设置的返回字段，将拣货的库存维度返回至对应字段；