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

【问题描述】

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

  

【原因说明】

• 库存单据保存时：会拿单据上录入的库存维度匹配即时库存表，如若发现单据上的 基本单位、库存辅单位  和即时库存的单位不一致，则会触发此校验提示。

出现此问题基本上来源于下面场景：

1. 业务发生已产生库存后，有物料覆盖引入或者后台修改基本单位和库存辅助单位。

2. 如未修改物料单位，则检查单据来源：

• 来源于下推时，则原因在于单据转换路线中对 基本单位、库存辅单位 映射错误

• 来源于引入或者WebAPI时，则原因在于数据包中对 基本单位、库存辅单位 赋值错误。
  

【详解步骤】

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

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

   
   

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

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

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

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

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

  
  

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

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

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

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

【延伸阅读】

1. 库存维度介绍

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

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

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