单据保存时提示“更新库存失败，即时库存表唯一索引冲突”如何解决

【问题描述】

• 单据操作（保存、审核、反审核、删除等）时提示：更新库存失败，即时库存表唯一索引冲突，

  
  

【原因分析】

1. 即时库存表 上存在 库存维度的唯一索引 ，即保证同一库存纬度下仅存在一条即时库存明细数据。

2. 即时库存表 上存在 三个单位（库存主单位、基本单位、库存辅单位）并非库存维度，如若后续 单据上单位和已存在库存的单位不一致时，则会在即时库存数据写入时，产生上述提示：即时库存表唯一索引冲突。

• 场景一：物料入库已存在库存后，后续该维度下即时库存再次出入库时，单据上的基本单位 或 库存辅单位与即时库存基本单位 或 库存辅单位 不一致时，则会在产生上述提示。

• 场景二：物料入库已存在库存后，后续该维度下即时库存再次出入库时，单据物料上的库存单位 与 即时库存对应库存主单位 不一致时，也会在产生上述提示。

    补充：有些单据上单位的名称叫法不一致：基本单位叫法基本一致，库存辅单位则不同单据叫法不一致，具体可以参考以下配置确认：如何查询即时库存单位对应单据上的是哪个单位字段

标准产品禁止业务单据使用后：修改物料的基本单位、辅助单位。 如若二开及扩展或后台强行调整单位引发问题，对应问题分析修复需自行承担负责。

【解决方案】

1. 检查单据上的 基本单位、库存辅单位（可以暂存单据在列表查看，不同单据此单位名称存在差异） 和 即时库存 的基本单位、库存辅单位 是否一致。（有些单据上的单位列表不可见，则需要bos设计器设置该字段可见性；对应即时库存明细列表 开启下显示零库存 避免异常数据为0库存导致无法排查到）

2. 检查单据物料的库存单位 和 即时库存 的库存主单位是否一致。

   
   

3. 按照上述1、2确认是哪个单位不一致后，再分析此单位 来源：

• 上游下推：依次往上查上游单据，异常来源于上游对应单位字段值，或 单据路线字段映射设置错误。

• WEBAPI：异常来源于 对应传输的数据包给定单位字段值错误。

• 引入：异常来源于 EXECL对应单位字段数据错误。

• 手工新增：异常来源于 非法修改了物料上的：基本单位 或 辅助单位 或 库存单位。

  
  

4. 分析其来源后，再根据不同场景处理：

• 如若异常来源于 单据上的单位错误，需要调整单据上单位数据 。

• 如若异常来源于 即时库存上的单位错误，需要联查物料收发明细查看其来源，修复单据及即时库存的单位数据，如果联查报表未发现其来源且为0库存时，则可以尝试使用 清除0库存 操作看能否将此笔异常库存清除。

• 如若还未找到异常数据，则也可以通过 库存云巡检 检查异常数据。

【延伸阅读】

1. 库存维度介绍

2. 如何查询即时库存单位对应单据上的是哪个单位字段

3. 如何使用“库存云巡检”

4. 使用“库存云巡检”检查即时库存表唯一索引冲突