一、 背景介绍

余额通常包括即时库存余额、期间库存余额、核算期间余额，是供应链中查询和更新最频繁的数据，对企业的管理具有极其重要的意义，所以客户对余额的准确性要求也非常高。并且根据过往经验，余额相关功能属于问题高发区域，本章节通过对使用过程中常见问题的总结，指导用户、顾问或现场开发人员快速准确的定位问题，并从根本上解决问题。

二、 常见问题分析方法

1、 出库提示库存不足

1.1 库存不足不是程序出了问题，在负库存校验开启的情况下这是对即时余额更新正常的业务控制。想要找出库存不足的原因，必须要了解如下内容：

余额表有哪些库存维度

余额更新规则中单据与余额表字段如何映射的

1.2 通过单据分录的库存查询有库存，但单据审核出库时提示库存不足？

1） 库存查询和余额更新是可以分别配置的，如果两边配置不一致就有可能更新的维度并不是查询看到的。我们需要做的是参照单据对应的余额更新规则，逐一比对库存余额和单据值是否完全匹配，数量是否足够。维度包括货主、保管者、计量单位、批号、辅助属性等等。

库存单据与即时库存维度逐一比对

2） 常见问题为增加或减少了库存维度，余额更新规则没有完全修改，比如某客户增加了“入库日期”作为库存维度，入库单的更新规则配置了字段映射，入库后即时库存明细就会存“入库日期”字段，而出库单的更新规则未配置，则出库时不会带单据上的字段去匹配库存，任何维度对不上都会提示库存不足。

同理，也出现过某客户要求减少库存维度，如“项目”不用更新到库存余额，只需要在余额更新规则中将维度字段映射修改“匹配方式”为“系统默认值”即可。

3） 若人工实在排查不出来，结合环境情况，开启负库存，让单据先审核，再看下余额记录变化，若你认为要出库的记录没变，多了一条负的，则就是维度对不上导致，比对一正一负的两条余额记录找到哪个维度对不上。注意：生产环境切记不能随便修改负库存配置，找到问题后，数据和配置要还原。

1.3即时库存明细报表上一正一负，但看上去所有维度仍然一致怎么办？

先仔细检查文本字段前后是否加了空格。

另外只有后台查询数据库存分析了，因为前台报表显示的是编码或名称，而后台数据库存储的是ID，可以通过平台的查询分析器或其他可用的数据库存工具查询t_im_inv_realbalance表，比对一正一负的两条余额。根据以往案例，某客户的物料是通过接口生成的，后来又通过接口删除再重新生成相同的物料，但这时物料ID发生了变化，出库单据是获取新的基础资料，与历史库存余额就不一致了，对于这样的问题首先要解决接口的控制问题才能根本上避免再次出现。

1.4入库单据为什么也会提示库存不足？

可能有人认为入库单据就是增加库存，为啥还会提示库存不足呢，其实单据是增加库存还是减少库存是由余额更新规则配置决定的，并不能仅根据单据名称叫入库单还是出库单来简单认为。比如采购入库单当业务类型为“收货检验合格入库”时，单据审核会减少“待检”库存，同时增加“可用”库存，当待检状态库存不足时也会正常提示出来。

2、 库存余额数量不对

这可能有多种原因引起需要具体分析余额的更新快照，先在开发平台找到即时库存余额表，列表界面预览后设置过滤条件，选中有问题的库存明细行查看更新快照

2.1快照中显示的单据编号查寻不到？

根据过往经验，有如下场景可能造成这种问题：

1） 场景1，非法删单问题，曾经有的顾问对星瀚不了解，反审核单据不成功（正常的单据校验不通过）然后就通过开发平台扩展放开删除按钮或者直接通过数据库删除单据，并认为单据没有了余额记录也会自动更新。其实没有通过余额更新规则配置的回滚操作，如反审核单据，就不会更新余额。对于这种后台操作一定要尽可能的避免，不得已要如此处理时也要充分评估风险。且后台操作在系统中没有操作日志，很难分析定位问题，往往需要找可能的负责人沟通询问。

2） 场景2，某客户是通过MES系统对接星瀚生成完工入库单，生成单据时调用了单据的审核操作，审核操作会触发余额更新规则更新余额，然后单据审核可能存在校验不通过的情况，然后单据生成失败并回滚，而余额更新是在另外的事务处理，却更新成功（代码级联操作，A操作触发了B操作，A操作失败回滚），这样也造成了余额错误。这种问题需要在技术方案上重新考虑。单据被删除的问题，需要按单据ID重算余额，可以将原余额快照回滚，同时重新计算余额。

2.2即时余额明细报表与收发汇总表/明细表结存数量为什么对不上？

我们先了解一下这两个报表的数据来源，即时余额明细报表取的是im_inv_realbalance即时库存余额表，而收发汇总表/明细表的期初和结存数量是根据im_inv_periodbalance库存期间余额表最近一期的期初数量加减截止日期当期的出入库单据计算得出的，正常情况下收发汇总表/明细表截止到当天的结存数量应该与即时余额表数量一致，如