关于现存量查询接口说明

YonJiao

以下系统场景为当前组织分配了可用量计算规则的情况，没有分配可用量计算规则的情况下可用量和现存量是相等的，可用量计算规则分配如图：

一、切换分组条件的不同场景：
1、当分组条件按某维度（比如：明细查询）展示，现存量=可用量+占用量(不展示占用量情况)，如下图：



2、当分组条件为“无”时，如果有占用量的情况，则会展示一条可用量为负数的数据，如下图：


注意：可用量为负数的数据实际就是有单据占用库存，比如销售订单（切记订单要选择仓库）。现存量都相加，可用量都相加后即为场景一的结果。

二、接口支持查询的两种场景

首先入参如下：

1. {
   
2.     "warehouse": "1742914729255370768",
   
3.     "product": "1821711814172868615",
   
4.     "bStockStatusDocNotNull": false,   // 该条件为false或者null时，查询结果会包含占用量的数据，具体形式为一条可用量为负数，现存量为0的数据。

复制代码

1、当"bStockStatusDocNotNull": true时，返回的是没有计算可用量的数据，现存量=可用量。所以如果当前组织设置了可用量计算规则，则不能将bStockStatusDocNotNull传true，否则返回的可用量没有减去占用量数据。
示例如下：

1. {
   
2.         "code": "200",
   
3.         "message": "操作成功",
   
4.         "data": [
   
5.                 {
   
6.                         "productsku_name": "火腿",
   
7.                         "statusType": "01",
   
8.                         "reserveid": 0,
   
9.                         "tradeorder": 0,
   
10.                         "warehouse_code": "000001",
    
11.                         "stockStatusDoc": 1602070655955110065,
    
12.                         "sensitiveUID": "～",
    
13.                         "product_unitName": "根",
    
14.                         "currentqty": 60,
    
15.                         "product_code": "0002000001",
    
16.                         "salesorder": 0,
    
17.                         "outnoticeqty": 0,
    
18.                         "poin": 0,
    
19.                         "innoticeqty": 0,
    
20.                         "manageClass_name": "零食",
    
21.                         "transferapplyout": 0,
    
22.                         "returnorder": 0,
    
23.                         "retailTrade": 0,
    
24.                         "purchaseorder": 0,
    
25.                         "manageClass": 1603403066475806723,
    
26.                         "planavailableqty": 60,
    
27.                         "materialreq": 0,
    
28.                         "aimequipcard": 0,
    
29.                         "morphologyconversionout": 0,
    
30.                         "transferapplyin": 0,
    
31.                         "pofreport": 0,
    
32.                         "posubarrivalorder": 0,
    
33.                         "delivery": 0,
    
34.                         "product": 1603412128856801287,
    
35.                         "arrivalorder": 0,
    
36.                         "org": "1603399261136879623",
    
37.                         "posubin": 0,
    
38.                         "productsku_code": "0002000001",
    
39.                         "storenotice": 0,
    
40.                         "warehouse": 1603425546334633984,
    
41.                         "product_name": "火腿",
    
42.                         "pickingreq": 0,
    
43.                         "poout": 0,
    
44.                         "unit": 1603411742292443142,
    
45.                         "productsku": 1603412128856801301,
    
46.                         "warehouse_name": "焦仓",
    
47.                         "manageClass_code": "000002",
    
48.                         "availableqty": 60,
    
49.                         "preretailqty": 0,
    
50.                         "tradedelivery": 0
    
51.                 }
    
52.         ]
    
53. }

复制代码

2、当"bStockStatusDocNotNull": false或者为空时，返回所有数据，包含可用量为负数的数据。所以对接系统需要按照现存量都相加，可用量都相加的方法进行汇总即可。

1. {
   
2.         "code": "200",
   
3.         "message": "操作成功",
   
4.         "data": [
   
5.                 {
   
6.                         "productsku_name": "火腿",
   
7.                         "statusType": "01",
   
8.                         "reserveid": 0,
   
9.                         "tradeorder": 0,
   
10.                         "warehouse_code": "000001",
    
11.                         "stockStatusDoc": 1602070655955110065,
    
12.                         "sensitiveUID": "～",
    
13.                         "product_unitName": "根",
    
14.                         "currentqty": 60,     //现存量
    
15.                         "product_code": "0002000001",
    
16.                         "salesorder": 0,
    
17.                         "outnoticeqty": 0,
    
18.                         "poin": 0,
    
19.                         "innoticeqty": 0,
    
20.                         "manageClass_name": "零食",
    
21.                         "transferapplyout": 0,
    
22.                         "returnorder": 0,
    
23.                         "retailTrade": 0,
    
24.                         "purchaseorder": 0,
    
25.                         "manageClass": 1603403066475806723,
    
26.                         "planavailableqty": 60,
    
27.                         "materialreq": 0,
    
28.                         "aimequipcard": 0,
    
29.                         "morphologyconversionout": 0,
    
30.                         "transferapplyin": 0,
    
31.                         "delivery": 0,
    
32.                         "pofreport": 0,
    
33.                         "posubarrivalorder": 0,
    
34.                         "product": 1603412128856801287,
    
35.                         "arrivalorder": 0,
    
36.                         "org": "1603399261136879623",
    
37.                         "posubin": 0,
    
38.                         "productsku_code": "0002000001",
    
39.                         "storenotice": 0,
    
40.                         "warehouse": 1603425546334633984,
    
41.                         "product_name": "火腿",
    
42.                         "pickingreq": 0,
    
43.                         "poout": 0,
    
44.                         "unit": 1603411742292443142,
    
45.                         "productsku": 1603412128856801301,
    
46.                         "warehouse_name": "焦仓",
    
47.                         "manageClass_code": "000002",
    
48.                         "availableqty": 60,       //可用量
    
49.                         "preretailqty": 0,
    
50.                         "tradedelivery": 0
    
51.                 },
    
52.                 {
    
53.                         "productsku_name": "火腿",
    
54.                         "reserveid": 0,
    
55.                         "tradeorder": 0,
    
56.                         "warehouse_code": "000001",
    
57.                         "stockStatusDoc": 0,
    
58.                         "sensitiveUID": "～",
    
59.                         "product_unitName": "根",
    
60.                         "currentqty": 0,   //现存量
    
61.                         "product_code": "0002000001",
    
62.                         "salesorder": 50,
    
63.                         "outnoticeqty": 0,
    
64.                         "poin": 0,
    
65.                         "innoticeqty": 0,
    
66.                         "manageClass_name": "零食",
    
67.                         "transferapplyout": 0,
    
68.                         "returnorder": 0,
    
69.                         "retailTrade": 0,
    
70.                         "purchaseorder": 0,
    
71.                         "manageClass": 1603403066475806723,
    
72.                         "planavailableqty": 0,
    
73.                         "materialreq": 0,
    
74.                         "aimequipcard": 0,
    
75.                         "morphologyconversionout": 0,
    
76.                         "transferapplyin": 0,
    
77.                         "delivery": 0,
    
78.                         "pofreport": 0,
    
79.                         "posubarrivalorder": 0,
    
80.                         "product": 1603412128856801287,
    
81.                         "arrivalorder": 0,
    
82.                         "org": "1603399261136879623",
    
83.                         "posubin": 0,
    
84.                         "productsku_code": "0002000001",
    
85.                         "storenotice": 0,
    
86.                         "warehouse": 1603425546334633984,
    
87.                         "product_name": "火腿",
    
88.                         "pickingreq": 0,
    
89.                         "poout": 0,
    
90.                         "unit": 1603411742292443142,
    
91.                         "productsku": 1603412128856801301,
    
92.                         "warehouse_name": "焦仓",
    
93.                         "manageClass_code": "000002",
    
94.                         "availableqty": -50,    //可用量
    
95.                         "preretailqty": 0,
    
96.                         "tradedelivery": 0
    
97.                 }
    
98.         ]
    
99. }

复制代码

三、事件订阅也是同样的道理，如果分配了可用量计算规则，则多返回一条负数的可用量数据，如果没有分配可用量计算规则，则多返回一条可用量为0的数据。
遵顼现存量都相加，可用量都相加的方法进行汇总。

1. {
   
2.         "data": [
   
3.                 {
   
4.                         "productClass_name": "零食",
   
5.                         "product_cCode": "0002000001",
   
6.                         "productsku_skuName": "火腿",
   
7.                         "sensitiveUID": "～",
   
8.                         "currentqty": 60.0,     //现存量
   
9.                         "salesorder": 0.0,
   
10.                         "product_cName": "火腿",
    
11.                         "purchaseorder": 0.0,
    
12.                         "retailTrade": 0.0,
    
13.                         "productClass_code": "000002",
    
14.                         "aimequipcard": 0.0,
    
15.                         "pofreport": 0.0,
    
16.                         "acolytesUnit": 0,
    
17.                         "productClass": 1603403246847131655,
    
18.                         "unitName": "根",
    
19.                         "storenotice": 0.0,
    
20.                         "warehouse": 1603425546334633984,
    
21.                         "pickingreq": 0.0,
    
22.                         "poout": 0.0,
    
23.                         "unit": 1603411742292443142,
    
24.                         "productsku": 1603412128856801301,
    
25.                         "warehouse_name": "焦仓",
    
26.                         "productsku_cCode": "0002000001",
    
27.                         "org_code": "yongyoujituan",
    
28.                         "preretailqty": 0.0,
    
29.                         "inventoryowner": 0,
    
30.                         "tradedelivery": 0.0,
    
31.                         "product_modelDescription": null,
    
32.                         "reserveid": 0,
    
33.                         "tradeorder": 0.0,
    
34.                         "warehouse_code": "000001",
    
35.                         "stockStatusDoc": 1602070655955110065,
    
36.                         "poin": 0.0,
    
37.                         "outnoticeqty": 0.0,
    
38.                         "innoticeqty": 0,
    
39.                         "transferapplyout": 0.0,
    
40.                         "returnorder": 0.0,
    
41.                         "inorderqty": 0,
    
42.                         "org_name": "用友集团",
    
43.                         "materialreq": 0.0,
    
44.                         "morphologyconversionout": 0.0,
    
45.                         "transferapplyin": 0.0,
    
46.                         "posubarrivalorder": 0.0,
    
47.                         "delivery": 0.0,
    
48.                         "product": 1603412128856801287,
    
49.                         "arrivalorder": 0.0,
    
50.                         "org": "1603399261136879623",
    
51.                         "posubin": 0.0,
    
52.                         "availableqty": 60.0   //可用量
    
53.                 },
    
54.                 {
    
55.                         "productClass_name": "零食",
    
56.                         "product_cCode": "0002000001",
    
57.                         "productsku_skuName": "火腿",
    
58.                         "sensitiveUID": "～",
    
59.                         "currentqty": 0.0,    //现存量
    
60.                         "salesorder": 53.0,
    
61.                         "product_cName": "火腿",
    
62.                         "purchaseorder": 0.0,
    
63.                         "retailTrade": 0.0,
    
64.                         "productClass_code": "000002",
    
65.                         "aimequipcard": 0.0,
    
66.                         "pofreport": 0.0,
    
67.                         "acolytesUnit": 0,
    
68.                         "productClass": 1603403246847131655,
    
69.                         "unitName": "根",
    
70.                         "storenotice": 0.0,
    
71.                         "warehouse": 1603425546334633984,
    
72.                         "pickingreq": 0.0,
    
73.                         "poout": 0.0,
    
74.                         "unit": 1603411742292443142,
    
75.                         "productsku": 1603412128856801301,
    
76.                         "warehouse_name": "焦仓",
    
77.                         "productsku_cCode": "0002000001",
    
78.                         "org_code": "yongyoujituan",
    
79.                         "preretailqty": 53.0,
    
80.                         "inventoryowner": -1,
    
81.                         "tradedelivery": 0.0,
    
82.                         "product_modelDescription": null,
    
83.                         "reserveid": 0,
    
84.                         "tradeorder": 0.0,
    
85.                         "warehouse_code": "000001",
    
86.                         "stockStatusDoc": 0,
    
87.                         "poin": 0.0,
    
88.                         "outnoticeqty": 0.0,
    
89.                         "innoticeqty": 0,
    
90.                         "transferapplyout": 0.0,
    
91.                         "returnorder": 0.0,
    
92.                         "inorderqty": 0,
    
93.                         "org_name": "用友集团",
    
94.                         "materialreq": 0.0,
    
95.                         "morphologyconversionout": 0.0,
    
96.                         "transferapplyin": 0.0,
    
97.                         "posubarrivalorder": 0.0,
    
98.                         "delivery": 0.0,
    
99.                         "product": 1603412128856801287,
    
100.                         "arrivalorder": 0.0,
     
101.                         "org": "1603399261136879623",
     
102.                         "posubin": 0.0,
     
103.                         "availableqty": -53.0 //可用量
     
104.                 }
     
105.         ]
     
106. }

复制代码