STORY #12687 JAVA中台-综合平台-平衡库存-JDW：preLockNum补偿逻辑 - 技术中心-需求池

业务需求

需求描述

一、需求背景

1、线上测试时，订单预占库存导致“平衡库存”的2类策略，执行“调整可售数”时不准确

2、成因：前期JD对接人未说明“库存数量、订单预占”的关系、接口对应的参数，故为了避免影响上线，仅考虑了“库存数量”

3、现状：通过线上数据，验证了数据关系

二、已验证

（一）JD参数关系&业务含义：库存数量（改listing所有库存）=订单预占（listing出单锁定的库存）+锁定库存+可销售库存

1、考虑到业务中、API中，未出现参数“锁定库存”，预计是非业务情况，则暂时不考虑此参数

（二）API&页面的参数对应关系、业务含义

1、instockNum=库存数量

2、preLockNum=订单预占

（三）SKU有多个仓库，API出参格式是
-1，instockNum=4，preLockNum=2
-2，instockNum=5，preLockNum=5

三、补偿逻辑

（一）应用系统节点：调用API前的入参获取

验收标准

价值描述

库存数更准确

历史记录

2022-11-18 10:11:03, 由 zhangcehong 创建。
2022-11-18 11:34:16, 由 zhangcehong 变更。
修改了 版本号 ，旧值为 "1"，新值为 "2"。
修改了 需求描述，区别为：
015-
015+
016-
016+
017- ~~（三）SKU有多个仓库，API出参格式是-1，instockNum=4，preLockNum=2-2，instockNum=5，preLockNum=5~~
017+ （三）SKU有多个仓库，API出参格式是-1，instockNum=4，preLockNum=2-2，instockNum=5，preLockNum=5
018-
018+
019-
019+
020-
020+ 三、补偿逻辑
021- ~~三、补偿逻辑~~
021+ （一）自动补货策略：条件-可售数
022- ~~（一）应用系统节点：调用API前的入参获取~~
022+ 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
023-
023+ 2、各仓库可售数=instockNum-preLockNum【变更点】
024-
024+ E.g.下方listing的总可售数=（4-2）+（5-5）=2
025+
026+
027+ （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
028+ 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
029+ 1.1“可售数差值”【后称差值】≥0
030+ 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
031+ 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
032+ 1.1.3以上述2者执行策略
033+ E.g.按上述例子
034+
035+ 策略目标可售数=20
036+ 差值=20-（4-2）-（5-5）=18
037+ 接口可调整的只有instockNum
038+ 当前instockNum=4，那么调用API的值=18+4=22
039+ 验证可售数：22-（4-2）-（5-5）=20
040+
041+
042+ 1.2“可售数差值”＜0
043+ 1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；
044+ 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
045+ 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
046+ 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”
047+ 1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）
048+ ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
049+ ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
050+
051+ E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5
052+ 策略目标可售数=20
053+ 差值=20-（24-2）-（25-5）=-22
054+ 1、新差值1=-22+（25-5）=-2
055+ 2、新差值2=-2+（24-2）=20
056+ 那么调用API的值
057+ 1、-2仓：5
058+ 2、-1仓：当前instock+差值+=24+（-2）=22
059+ 验证可售数：（22-2）-（5-5）=20
060+
061+

015- ~~<img src="{225653.png}" alt="" width="500" height="185" title="" />~~
015+ 
016- ~~~~
016+ 
017- ~~（三）SKU有多个仓库，API出参格式是 -1，instockNum=4，preLockNum=2 -2，instockNum=5，preLockNum=5~~
017+ （三）SKU有多个仓库，API出参格式是 -1，instockNum=4，preLockNum=2 -2，instockNum=5，preLockNum=5
018-
018+ <img src="{225654.png}" alt="" width="384" height="500" title="" />
019- ~~<img src="{225654.png}" alt="" width="384" height="500" title="" />~~
019+ 
020- ~~ ~~
020+ 三、补偿逻辑
021- ~~三、补偿逻辑~~
021+ （一）自动补货策略：条件-可售数
022- ~~（一）应用系统节点：调用API前的入参获取~~
022+ 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
023- ~~ ~~
023+ 2、各仓库可售数=instockNum-preLockNum【变更点】
024- ~~ ~~
024+ E.g.下方listing的总可售数=（4-2）+（5-5）=2
025+ <img src="{225653.png}" alt="" width="500" height="185" title="" />
026+ 
027+ （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
028+ 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
029+ 1.1“可售数差值”【后称差值】≥0
030+ 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
031+ 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
032+ 1.1.3以上述2者执行策略
033+ E.g.按上述例子
034+ 
035+ 策略目标可售数=20 
036+ 差值=20-（4-2）-（5-5）=18
037+ 接口可调整的只有instockNum
038+ 当前instockNum=4，那么调用API的值=18+4=22
039+ 验证可售数：22-（4-2）-（5-5）=20
040+ 
041+ 
042+ 1.2“可售数差值”＜0
043+ 1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；
044+ 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
045+ 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
046+ 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”
047+ 1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）
048+ ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
049+ ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
050+ 
051+ E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5
052+ 策略目标可售数=20
053+ 差值=20-（24-2）-（25-5）=-22
054+ 1、新差值1=-22+（25-5）=-2
055+ 2、新差值2=-2+（24-2）=20
056+ 那么调用API的值
057+ 1、-2仓：5
058+ 2、-1仓：当前instock+差值+=24+（-2）=22
059+ 验证可售数：（22-2）-（5-5）=20
060+ 
061+
2022-11-18 11:37:45, 由 zhangcehong 变更。
修改了 版本号 ，旧值为 "2"，新值为 "3"。
修改了 需求描述，区别为：
008- ~~1、考虑到业务中、API中，未出现参数“锁定库存”，预计是非业务情况，则暂时不考虑此参数~~
008+ 1、考虑到业务中、API中，未出现参数“锁定库存”（JD未回复用途），预计是非业务情况，则暂时不考虑此参数
009-
009+ （二）API&页面的参数对应关系、业务含义
010-
010+ 1、instockNum=库存数量
011- ~~（二）API&页面的参数对应关系、业务含义~~
011+ 2、preLockNum=订单预占
012- ~~1、instockNum=库存数量~~
012+ （三）SKU有多个仓库，API出参格式是-1，instockNum=4，preLockNum=2-2，instockNum=5，preLockNum=5
013- ~~2、preLockNum=订单预占~~
013+
015-
015+ 三、补偿逻辑
016-
016+ （一）自动补货策略：条件-可售数
017- ~~（三）SKU有多个仓库，API出参格式是-1，instockNum=4，preLockNum=2-2，instockNum=5，preLockNum=5~~
017+ 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
018-
018+ 2、各仓库可售数=instockNum-preLockNum【变更点】
019-
019+ E.g.下方listing的总可售数=（4-2）+（5-5）=2
020- ~~三、补偿逻辑~~
020+
021- ~~（一）自动补货策略：条件-可售数~~
021+
022- ~~1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】~~
022+ （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
023- ~~2、各仓库可售数=instockNum-preLockNum【变更点】~~
023+ 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
024- ~~E.g.下方listing的总可售数=（4-2）+（5-5）=2~~
024+ 1.1“可售数差值”【后称差值】≥0
025-
025+ 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
026-
026+ 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
027- （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
027+ 1.1.3以上述2者执行策略
028- ~~1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】~~
028+ E.g.按上述例子
029- ~~1.1“可售数差值”【后称差值】≥0~~
029+
030- ~~1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”~~
030+ 策略目标可售数=20
031- ~~1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值~~
031+ 差值=20-（4-2）-（5-5）=18
032- ~~1.1.3以上述2者执行策略~~
032+ 接口可调整的只有instockNum
033- ~~E.g.按上述例子~~
033+ 当前instockNum=4，那么调用API的值=18+4=22
034-
034+ 验证可售数：22-（4-2）-（5-5）=20
035- ~~策略目标可售数=20~~
035+
036- ~~差值=20-（4-2）-（5-5）=18~~
036+ 1.2“可售数差值”＜0
037- ~~接口可调整的只有instockNum~~
037+ 1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；
038- ~~当前instockNum=4，那么调用API的值=18+4=22~~
038+ 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
039- ~~验证可售数：22-（4-2）-（5-5）=20~~
039+ 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
040-
040+ 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”【定义：≥0的新差值是新差值N，新差值N前一个差值是新差值M】
041-
041+ 1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）
042- ~~1.2“可售数差值”＜0~~
042+ ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
043- ~~1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；~~
043+ ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
044- ~~1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】~~
044+
045- ~~1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”~~
045+ E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5
046- ~~1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”~~
046+ 策略目标可售数=20
047- ~~1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）~~
047+ 差值=20-（24-2）-（25-5）=-22
048- ~~①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略~~
048+ 1、新差值M=-22+（25-5）=-2
049- ~~②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略~~
049+ 2、新差值N=-2+（24-2）=20
050-
050+ 那么调用API的值
051- ~~E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5~~
051+ 1、-2仓：5
052- ~~策略目标可售数=20~~
052+ 2、-1仓：当前instock+差值+=24+（-2）=22
053- ~~差值=20-（24-2）-（25-5）=-22~~
053+ 验证可售数：（22-2）-（5-5）=20
054- ~~1、新差值1=-22+（25-5）=-2~~
055- ~~2、新差值2=-2+（24-2）=20~~
056- ~~那么调用API的值~~
057- ~~1、-2仓：5~~
058- ~~2、-1仓：当前instock+差值+=24+（-2）=22~~
059- ~~验证可售数：（22-2）-（5-5）=20~~
060-
061-

008- ~~1、考虑到业务中、API中，未出现参数“锁定库存”，预计是非业务情况，则暂时不考虑此参数~~
008+ 1、考虑到业务中、API中，未出现参数“锁定库存”（JD未回复用途），预计是非业务情况，则暂时不考虑此参数
009- ~~ ~~
009+ （二）API&页面的参数对应关系、业务含义
010- ~~ ~~
010+ 1、instockNum=库存数量
011- ~~（二）API&页面的参数对应关系、业务含义~~
011+ 2、preLockNum=订单预占
012- ~~1、instockNum=库存数量~~
012+ （三）SKU有多个仓库，API出参格式是 -1，instockNum=4，preLockNum=2 -2，instockNum=5，preLockNum=5
013- ~~2、preLockNum=订单预占~~
013+ <img src="{225654.png}" alt="" width="384" height="500" title="" />
015- ~~ ~~
015+ 三、补偿逻辑
016- ~~ ~~
016+ （一）自动补货策略：条件-可售数
017- ~~（三）SKU有多个仓库，API出参格式是 -1，instockNum=4，preLockNum=2 -2，instockNum=5，preLockNum=5~~
017+ 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
018- ~~<img src="{225654.png}" alt="" width="384" height="500" title="" />~~
018+ 2、各仓库可售数=instockNum-preLockNum【变更点】
019- ~~ ~~
019+ E.g.下方listing的总可售数=（4-2）+（5-5）=2
020- ~~三、补偿逻辑~~
020+ <img src="{225653.png}" alt="" width="500" height="185" title="" />
021- ~~（一）自动补货策略：条件-可售数~~
021+ 
022- 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
022+ （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
023- ~~2、各仓库可售数=instockNum-preLockNum【变更点】~~
023+ 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
024- ~~E.g.下方listing的总可售数=（4-2）+（5-5）=2~~
024+ 1.1“可售数差值”【后称差值】≥0
025- ~~<img src="{225653.png}" alt="" width="500" height="185" title="" />~~
025+ 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
026- ~~ ~~
026+ 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
027- （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
027+ 1.1.3以上述2者执行策略
028- 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
028+ E.g.按上述例子
029- ~~1.1“可售数差值”【后称差值】≥0~~
029+ 
030- 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
030+ 策略目标可售数=20 
031- 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
031+ 差值=20-（4-2）-（5-5）=18
032- ~~1.1.3以上述2者执行策略~~
032+ 接口可调整的只有instockNum
033- ~~E.g.按上述例子~~
033+ 当前instockNum=4，那么调用API的值=18+4=22
034- ~~~~
034+ 验证可售数：22-（4-2）-（5-5）=20
035- ~~策略目标可售数=20 ~~
035+ 
036- 差值=20-（4-2）-（5-5）=18
036+ 1.2“可售数差值”＜0
037- ~~接口可调整的只有instockNum~~
037+ 1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；
038- ~~当前instockNum=4，那么调用API的值=18+4=22~~
038+ 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
039- 验证可售数：22-（4-2）-（5-5）=20
039+ 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
040- ~~ ~~
040+ 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”【定义：≥0的新差值是新差值N，新差值N前一个差值是新差值M】
041- ~~ ~~
041+ 1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）
042- ~~1.2“可售数差值”＜0~~
042+ ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
043- ~~1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；~~
043+ ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
044- 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
044+ 
045- 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
045+ E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5
046- 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”
046+ 策略目标可售数=20
047- ~~1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）~~
047+ 差值=20-（24-2）-（25-5）=-22
048- ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
048+ 1、新差值M=-22+（25-5）=-2
049- ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
049+ 2、新差值N=-2+（24-2）=20
050- ~~~~
050+ 那么调用API的值
051- ~~E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5~~
051+ 1、-2仓：5
052- ~~策略目标可售数=20~~
052+ 2、-1仓：当前instock+差值+=24+（-2）=22
053- ~~差值=20-（24-2）-（25-5）=-22~~
053+ 验证可售数：（22-2）-（5-5）=20
054- ~~1、新差值1=-22+（25-5）=-2~~
055- ~~2、新差值2=-2+（24-2）=20~~
056- ~~那么调用API的值~~
057- ~~1、-2仓：5~~
058- ~~2、-1仓：当前instock+差值+=24+（-2）=22~~
059- ~~验证可售数：（22-2）-（5-5）=20~~
060- ~~ ~~
061- ~~ ~~
2022-11-18 11:37:53, 由 zhangcehong 记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-11-18"。
修改了 当前状态，旧值为 "draft"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "zhangcehong"。
2022-11-18 11:48:56, 由 zhangcehong 变更。
修改了 当前状态，旧值为 "active"，新值为 "changed"。
修改了 版本号 ，旧值为 "3"，新值为 "4"。
修改了 由谁评审，旧值为 "zhangcehong"，新值为 ""。
修改了 评审时间，旧值为 "2022-11-18"，新值为 "0000-00-00"。
修改了 需求描述，区别为：
034- ~~验证可售数：22-（4-2）-（5-5）=20~~
034+ 验证可售数：（22-2）-（5-5）=20

034- 验证可售数：22-（4-2）-（5-5）=20
034+ 验证可售数：（22-2）-（5-5）=20
2022-11-18 11:49:03, 由 zhangcehong 记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-11-18"。
修改了 当前状态，旧值为 "changed"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "zhangcehong"。
2022-11-18 11:49:58, 由 zhangcehong 编辑。
修改了 优先级，旧值为 "3"，新值为 "1"。
2022-11-18 11:51:05, 由 zhangcehong 指派给宋宁。
修改了 指派给，旧值为 "zhangcehong"，新值为 "songning"。
2022-11-18 11:53:52, 由 zhangcehong 变更。
修改了 版本号 ，旧值为 "4"，新值为 "5"。
修改了 由谁评审，旧值为 "zhangcehong"，新值为 ""。
修改了 评审时间，旧值为 "2022-11-18"，新值为 "0000-00-00"。
修改了 需求描述，区别为：
016- ~~（一）自动补货策略：条件-可售数~~
016+ PS、产品定义：平衡库存之前产生的订单预占库存，视为已经出库的库存。故平衡库存的目标值，不计算订单预占库存
017- ~~1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】~~
017+
018- ~~2、各仓库可售数=instockNum-preLockNum【变更点】~~
018+ （一）自动补货策略：条件-可售数
019- ~~E.g.下方listing的总可售数=（4-2）+（5-5）=2~~
019+ 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
020-
020+ 2、各仓库可售数=instockNum-preLockNum【变更点】
021-
021+ E.g.下方listing的总可售数=（4-2）+（5-5）=2
022- （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
022+
023- ~~1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】~~
023+
024- ~~1.1“可售数差值”【后称差值】≥0~~
024+ （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
025- ~~1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”~~
025+ 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
026- ~~1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值~~
026+ 1.1“可售数差值”【后称差值】≥0
027- ~~1.1.3以上述2者执行策略~~
027+ 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
028- ~~E.g.按上述例子~~
028+ 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
029-
029+ 1.1.3以上述2者执行策略
030- ~~策略目标可售数=20~~
030+ E.g.按上述例子
031- ~~差值=20-（4-2）-（5-5）=18~~
031+
032- ~~接口可调整的只有instockNum~~
032+ 策略目标可售数=20
033- ~~当前instockNum=4，那么调用API的值=18+4=22~~
033+ 差值=20-（4-2）-（5-5）=18
034- ~~验证可售数：（22-2）-（5-5）=20~~
034+ 接口可调整的只有instockNum
035-
035+ 当前instockNum=4，那么调用API的值=18+4=22
036- ~~1.2“可售数差值”＜0~~
036+ 验证可售数：（22-2）-（5-5）=20
037- ~~1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；~~
037+
038- ~~1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】~~
038+ 1.2“可售数差值”＜0
039- ~~1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”~~
039+ 1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；
040- ~~1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”【定义：≥0的新差值是新差值N，新差值N前一个差值是新差值M】~~
040+ 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
041- ~~1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）~~
041+ 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
042- ~~①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略~~
042+ 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”【定义：≥0的新差值是新差值N，新差值N前一个差值是新差值M】
043- ~~②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略~~
043+ 1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）
044-
044+ ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
045- ~~E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5~~
045+ ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
046- ~~策略目标可售数=20~~
046+
047- ~~差值=20-（24-2）-（25-5）=-22~~
047+ E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5
048- ~~1、新差值M=-22+（25-5）=-2~~
048+ 策略目标可售数=20
049- ~~2、新差值N=-2+（24-2）=20~~
049+ 差值=20-（24-2）-（25-5）=-22
050- ~~那么调用API的值~~
050+ 1、新差值M=-22+（25-5）=-2
051- ~~1、-2仓：5~~
051+ 2、新差值N=-2+（24-2）=20
052- ~~2、-1仓：当前instock+差值+=24+（-2）=22~~
052+ 那么调用API的值
053- ~~验证可售数：（22-2）-（5-5）=20~~
053+ 1、-2仓：5
054+ 2、-1仓：当前instock+差值+=24+（-2）=22
055+ 验证可售数：（22-2）-（5-5）=20

016- ~~（一）自动补货策略：条件-可售数~~
016+ PS、产品定义：平衡库存之前产生的订单预占库存，视为已经出库的库存。故平衡库存的目标值，不计算订单预占库存
017- 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
017+ 
018- ~~2、各仓库可售数=instockNum-preLockNum【变更点】~~
018+ （一）自动补货策略：条件-可售数
019- ~~E.g.下方listing的总可售数=（4-2）+（5-5）=2~~
019+ 1、获取该listing所有可发货仓库的可售数，求和，得出listing总可售数【即，页面上的可销售库存】
020- ~~<img src="{225653.png}" alt="" width="500" height="185" title="" />~~
020+ 2、各仓库可售数=instockNum-preLockNum【变更点】
021- ~~ ~~
021+ E.g.下方listing的总可售数=（4-2）+（5-5）=2
022- （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
022+ <img src="{225653.png}" alt="" width="500" height="185" title="" />
023- 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
023+ 
024- ~~1.1“可售数差值”【后称差值】≥0~~
024+ （二）自动补货、防超卖策略：策略执行环节“调用API-调整可售数”。【为了保证listing总可售数=目标可售数（定义：策略执行的目标值）】【可接口调整的是instockNum；即，执行目标值=参数instockNum】
025- 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
025+ 1、确认该listing的可售数差值=目标可售数-所有仓库可售数之和【仓库可售数=instockNum-preLockNum】
026- 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
026+ 1.1“可售数差值”【后称差值】≥0
027- ~~1.1.3以上述2者执行策略~~
027+ 1.1.1以“中国默认仓”、storecode“-1”为“执行目标仓（定义：要修改的仓库）”
028- ~~E.g.按上述例子~~
028+ 1.1.2以“差值+当前instock”【变动点；此场景未改动其他仓】为执行目标值
029- ~~~~
029+ 1.1.3以上述2者执行策略
030- ~~策略目标可售数=20 ~~
030+ E.g.按上述例子
031- 差值=20-（4-2）-（5-5）=18
031+ 
032- ~~接口可调整的只有instockNum~~
032+ 策略目标可售数=20 
033- ~~当前instockNum=4，那么调用API的值=18+4=22~~
033+ 差值=20-（4-2）-（5-5）=18
034- 验证可售数：（22-2）-（5-5）=20
034+ 接口可调整的只有instockNum
035- ~~ ~~
035+ 当前instockNum=4，那么调用API的值=18+4=22
036- ~~1.2“可售数差值”＜0~~
036+ 验证可售数：（22-2）-（5-5）=20
037- ~~1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；~~
037+ 
038- 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
038+ 1.2“可售数差值”＜0
039- 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
039+ 1.2.1以“差值”遍历仓库（非“中国默认仓”优先），与仓库可售数做加法；
040- 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”【定义：≥0的新差值是新差值N，新差值N前一个差值是新差值M】
040+ 1.2.2新差值=旧差值+仓库可售数【仓库可售数=instockNum-preLockNum】
041- ~~1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）~~
041+ 1.2.3新差值＜0，记录“计算过的仓库”的“可售数=0”，以新值循环“1.2.2”
042- ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
042+ 1.2.4新差值N≥0，停止，记录本轮循环的仓库、使“新差值N≥0”的前一个“差值M”【定义：≥0的新差值是新差值N，新差值N前一个差值是新差值M】
043- ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
043+ 1.2.5以“计算过的仓库”为“执行目标仓”（可能有N个）
044- ~~ ~~
044+ ①记录“可售数=0”的仓库【当前instockNum-preLockNum=0】，以当前该仓库的“preLockNum”【变更点】为执行目标值，执行策略
045- ~~E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5~~
045+ ②“触发1.2.4”的仓库，以“差值M+当前instock”【变更点】为执行目标值，执行策略
046- ~~策略目标可售数=20~~
046+ 
047- ~~差值=20-（24-2）-（25-5）=-22~~
047+ E.g.假设instockNum=24（-1仓）、25（-2仓），prolockNum=2、5
048- ~~1、新差值M=-22+（25-5）=-2~~
048+ 策略目标可售数=20
049- ~~2、新差值N=-2+（24-2）=20~~
049+ 差值=20-（24-2）-（25-5）=-22
050- ~~那么调用API的值~~
050+ 1、新差值M=-22+（25-5）=-2
051- ~~1、-2仓：5~~
051+ 2、新差值N=-2+（24-2）=20
052- ~~2、-1仓：当前instock+差值+=24+（-2）=22~~
052+ 那么调用API的值
053- ~~验证可售数：（22-2）-（5-5）=20~~
053+ 1、-2仓：5
054+ 2、-1仓：当前instock+差值+=24+（-2）=22
055+ 验证可售数：（22-2）-（5-5）=20
2022-11-18 13:57:13, 由 zhangcehong 变更。
修改了 当前状态，旧值为 "active"，新值为 "changed"。
修改了 版本号 ，旧值为 "5"，新值为 "6"。
修改了 需求名称，区别为：
001- ~~JAVA中台-综合平台-平衡库存-JDW：preLockNum补偿逻辑~~
001+ 综合平台-平衡库存-JDW：preLockNum补偿逻辑

001- ~~JAVA中台-综合平台-平衡库存-JDW：preLockNum补偿逻辑~~
001+ 综合平台-平衡库存-JDW：preLockNum补偿逻辑
2022-11-18 13:57:28, 由 zhangcehong 变更。
修改了 版本号 ，旧值为 "6"，新值为 "7"。
修改了 需求名称，区别为：
001- ~~综合平台-平衡库存-JDW：preLockNum补偿逻辑~~
001+ 综合平台-平衡库存-JDW1.0.2：preLockNum补偿逻辑

001- ~~综合平台-平衡库存-JDW：preLockNum补偿逻辑~~
001+ 综合平台-平衡库存-JDW1.0.2：preLockNum补偿逻辑
2022-11-18 13:57:39, 由 zhangcehong 记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-11-18"。
修改了 指派给 ，旧值为 "songning"，新值为 "zhangcehong"。
修改了 当前状态，旧值为 "changed"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "zhangcehong"。
2022-11-18 13:57:43, 由闫峰指派给闫峰。
修改了 指派给，旧值为 "zhangcehong"，新值为 "yanfeng"。
2022-11-18 13:57:48, 由 zhangcehong 指派给王谦。
修改了 指派给，旧值为 "yanfeng"，新值为 "wangqian"。
2022-11-18 18:17:50, 由 zhangcehong 编辑。
修改了 所属模块，旧值为 "1737"，新值为 "1728"。
2022-11-21 16:32:00, 由 zhengqiao 关联到迭代 JDWalmart平衡库存 。
2022-12-08 10:32:11, 由 zhangcehong 变更。
修改了 指派给 ，旧值为 "wangqian"，新值为 "zhangcehong"。
修改了 当前状态，旧值为 "active"，新值为 "changed"。
修改了 版本号 ，旧值为 "7"，新值为 "8"。
修改了 由谁评审，旧值为 "zhangcehong"，新值为 ""。
修改了 评审时间，旧值为 "2022-11-18"，新值为 "0000-00-00"。
修改了 需求名称，区别为：
001- ~~综合平台-平衡库存-JDW1.0.2：preLockNum补偿逻辑~~
001+ 综合平台-平衡库存-JDW1.0.1：preLockNum补偿逻辑

001- ~~综合平台-平衡库存-JDW1.0.2：preLockNum补偿逻辑~~
001+ 综合平台-平衡库存-JDW1.0.1：preLockNum补偿逻辑

改名字版本信息
2022-12-08 10:32:18, 由 zhangcehong 记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-12-08"。
修改了 当前状态，旧值为 "changed"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "zhangcehong"。
2023-05-08 10:31:56, 由 李乐同 指派给 刘瀚泽。
修改了 指派给，旧值为 "zhangcehong"，新值为 "liuhanze"。

已发布
2023-05-11 17:10:57, 由闫峰编辑。
修改了 所处阶段 ，旧值为 "developed"，新值为 "released"。
修改了 设置阶段者，旧值为 ""，新值为 "yanfeng"。
2023-05-13 16:44:39, 由周杰关闭，原因为 已完成 。
修改了 由谁关闭，旧值为 ""，新值为 "zhoujie"。
修改了 关闭日期，旧值为 "0000-00-00 00:00:00"，新值为 "2023-05-13 16:44:37"。
修改了 指派给 ，旧值为 "liuhanze"，新值为 "closed"。
修改了 当前状态，旧值为 "active"，新值为 "closed"。
修改了 所处阶段，旧值为 "released"，新值为 "closed"。
修改了 关闭原因，旧值为 ""，新值为 "done"。

基本信息
需求的一生

迭代版本
提报业务部门
提报人员	试运营
需求来源	公司战略需求
所属项目	技术中心-需求池
所属模块	多平台 walmart
所属计划
业务价值
开发组
受益业务部门	综合平台运营中心
验收人员
业务目标类型
中心业务目标
业务价值	提升人效
每月价值量	1
每月节省人数	0
优先级	P0
价值类型
预计工时	1
成本
ROI
操作手册	否
高价值	-
主被动	被动接收
复杂度	一般性
工作流ID
工作流创建时间
更新点
是否高危	否
评分
当前状态	已关闭
所处阶段	已关闭
关键词
评审次数	一次
计划上线
上线时间
计划验收时间
业务验收时间
满意度
价值验收
满意度分值
业务回填价值
验收达成价值
验收达成ROI
抄送给

由谁创建	zhangcehong 于 2022-11-18 10:11:03
指派给	Closed 于 2023-05-13 16:44:37
由谁评审	zhangcehong
评审时间	2022-12-08
由谁关闭	周杰于 2023-05-13 16:44:37
关闭原因	已完成
最后修改	周杰于 2023-05-13 16:44:37

迭代任务
相关信息

[T]32922 综合平台-平衡库存-JDW1.0.2：preLockNum补偿逻辑 JDWalmart平衡库存

相关Bug
相关用例
相关需求
细分需求