huangping / API-Interfaces · Commits

Go to a project

Authored by tanling
Commit 58eab629d7334064bd25942bdfb74aab4754dcd9 1 parent 4bff59f7

Update ShopReportController.md

Inline Side-by-side
Showing 1 changed file with 88 additions and 173 deletions
@@ -31,35 +31,31 @@ @@ -31,35 +31,31 @@
31 请求示例 31 请求示例
32 http://192.168.102.217:8080/gateway?method=app.shops.sales 32 http://192.168.102.217:8080/gateway?method=app.shops.sales
33 33
34 -## 请求样例数据  
35 -```json 34 +``` json
  35 +请求样例：
36 { 36 {
37 - "page": 1,  
38 - "size": 2 37 +"beginTime": "20160516",
  38 +"endTime": "20160528",
  39 +"type":2
39 } 40 }
40 -```  
41 -  
42 -### 响应  
43 -code为200即为成功，否则是失败。  
44 -响应JSON格式如下所示:  
45 -```json 41 +正常返回：
46 { 42 {
47 "alg": "SALT_MD5", 43 "alg": "SALT_MD5",
48 "code": 200, 44 "code": 200,
49 "data": { 45 "data": {
50 "additionInfo": { 46 "additionInfo": {
51 - "allAmount": 2977123.6,  
52 - "allAmountRate": 0,  
53 - "allNumber": 14749,  
54 - "allNumberRate": 0,  
55 - "lastAllAmount": 2977323.78,  
56 - "lastAllNumber": 14746 47 + "allAmount": 2977818.56,//订单商品金额
  48 + "allAmountRate": 29.56,//环比 乘100后的数据
  49 + "allNumber": 14747,//订单商品总数
  50 + "allNumberRate": 14//环比 乘100后的数据
  51 + "lastAllAmount": 2977323.78,//上期金额总数
  52 + "lastAllNumber": 14746//上期商品总数
57 }, 53 },
58 "list": [ 54 "list": [
59 { 55 {
60 - "allAmounts": 2970434.16,  
61 - "allNums": 14731,  
62 - "dateId": "20160518" 56 + "allAmounts": 2970434.16,//汇总金额
  57 + "allNums": 14731,//汇总商品数
  58 + "dateId": "20160518"//日期
63 }, 59 },
64 { 60 {
65 "allAmounts": 295.04, 61 "allAmounts": 295.04,
@@ -67,23 +63,22 @@ code为200即为成功，否则是失败。 @@ -67,23 +63,22 @@ code为200即为成功，否则是失败。
67 "dateId": "20160525" 63 "dateId": "20160525"
68 } 64 }
69 ], 65 ],
70 - "page": 1,  
71 - "size": 1,  
72 - "total": 1,  
73 - "totalPage": 1 66 + "page": 0,
  67 + "size": 0,
  68 + "total": 0,
  69 + "totalPage": 0
74 }, 70 },
75 "md5": "6bed08aeaa2b44e6238f889d007c358d", 71 "md5": "6bed08aeaa2b44e6238f889d007c358d",
76 "message": "getOrdersGoodsRptForApi result" 72 "message": "getOrdersGoodsRptForApi result"
77 } 73 }
78 -```  
79 -  
80 -```json 74 +异常返回：
81 { 75 {
82 "code": 405, 76 "code": 405,
83 "data": [], 77 "data": [],
84 "md5": "d751713988987e9331980363e24189ce", 78 "md5": "d751713988987e9331980363e24189ce",
85 - "message": "getOrdersGoodsRptList" 79 + "message": "getOrdersGoodsRptForApi"
86 } 80 }
  81 +
87 ``` 82 ```
88 83
89 84
@@ -120,73 +115,56 @@ code为200即为成功，否则是失败。 @@ -120,73 +115,56 @@ code为200即为成功，否则是失败。
120 http://192.168.102.217:8080/gateway?method=app.shops.refund 115 http://192.168.102.217:8080/gateway?method=app.shops.refund
121 116
122 ## 请求样例数据 117 ## 请求样例数据
123 -```json 118 +``` json
  119 +请求样例：
124 { 120 {
125 - "page": 1,  
126 - "size": 2 121 +"beginTime": "20160516",
  122 +"endTime": "20160528",
  123 +"type":2
127 } 124 }
128 -```  
129 -  
130 -### 响应  
131 -code为200即为成功，否则是失败。  
132 -响应JSON格式如下所示:  
133 -```json 125 +正常返回：
134 { 126 {
135 - "alg": "SALT_MD5",  
136 - "code": 200,  
137 - "data": {  
138 - "additionInfo": {  
139 - "allAmount": 2977818.56,  
140 - "allAmountRate": 2977817.56,  
141 - "allNumber": 14747,  
142 - "allNumberRate": 14746  
143 - },  
144 - "list": [  
145 - {  
146 - "brandId": 144,  
147 - "brandName": "VANS",  
148 - "buyNumber": 1,  
149 - "colorId": 2,  
150 - "colorName": "黑色",  
151 - "dateId": 20160518,  
152 - "factoryCode": "VN0004PA1861",  
153 - "goodsName": "VANS Sk8-Hi Lite 超轻来袭 ",  
154 - "imageUrl": "",  
155 - "maxSortId": 6,  
156 - "maxSortName": "鞋靴",  
157 - "middleSortId": 44,  
158 - "middleSortName": "休闲/运动鞋",  
159 - "orderAmount": 665,  
160 - "orderCode": 1605008704,  
161 - "productSkc": 371718,  
162 - "productSkn": 51227423,  
163 - "productSku": 1159909,  
164 - "retailPrice": 665,  
165 - "salesPrice": 665,  
166 - "shopName": "",  
167 - "sizeId": 125,  
168 - "sizeName": "42码",  
169 - "smallSortId": 147,  
170 - "smallSortName": "休闲/运动鞋"  
171 - }  
172 - ],  
173 - "page": 1,  
174 - "size": 10,  
175 - "total": 1,  
176 - "totalPage": 1 127 + "alg": "SALT_MD5",
  128 + "code": 200,
  129 + "data": {
  130 + "additionInfo": {
  131 + "allAmount": 2977818.56,//退货商品金额
  132 + "allAmountRate": 29.56,//环比 乘100后的数据
  133 + "allNumber": 14747,//退货商品总数
  134 + "allNumberRate": 14//环比 乘100后的数据
  135 + "lastAllAmount": 2977323.78,//上期金额总数
  136 + "lastAllNumber": 14746//上期商品总数
  137 + "returnAmountRate":12.12//退货率
  138 + "returnRingRate":1.1//退货率环比
177 }, 139 },
178 - "md5": "ce4964c1e6defece5035c81b63c3c51d",  
179 - "message": "getOrdersGoodsRptList result" 140 + "list": [
  141 + {
  142 + "allAmounts": 2970434.16,//汇总金额
  143 + "allNums": 14731,//汇总商品数
  144 + "dateId": "20160518"//日期
  145 + },
  146 + {
  147 + "allAmounts": 295.04,
  148 + "allNums": 4,
  149 + "dateId": "20160525"
  150 + }
  151 + ],
  152 + "page": 0,
  153 + "size": 0,
  154 + "total": 0,
  155 + "totalPage": 0
  156 + },
  157 + "md5": "6bed08aeaa2b44e6238f889d007c358d",
  158 + "message": "getOrdersGoodsRptForApi result"
180 } 159 }
181 -```  
182 -  
183 -```json 160 +异常返回：
184 { 161 {
185 "code": 405, 162 "code": 405,
186 "data": [], 163 "data": [],
187 "md5": "d751713988987e9331980363e24189ce", 164 "md5": "d751713988987e9331980363e24189ce",
188 - "message": "getOrdersGoodsRptList" 165 + "message": "getOrdersGoodsRptForApi"
189 } 166 }
  167 +
190 ``` 168 ```
191 169
192 ## 3、查询进库统计报表## 170 ## 3、查询进库统计报表##
@@ -206,32 +184,25 @@ code为200即为成功，否则是失败。 @@ -206,32 +184,25 @@ code为200即为成功，否则是失败。
206 |:-------| -----:|-----:|-----:|----:| 184 |:-------| -----:|-----:|-----:|----:|
207 |page|int||是|2|第几页| 185 |page|int||是|2|第几页|
208 |size|int|是|10|每页条数| 186 |size|int|是|10|每页条数|
209 -|type|int|是|1|1 日 2 周 3 月|  
210 |beginTime|string|是|20150306|周报：开始日期| 187 |beginTime|string|是|20150306|周报：开始日期|
211 |endTime|string|是|20150308|周报：结束日期| 188 |endTime|string|是|20150308|周报：结束日期|
212 -|productSkn|int|是|1222|skn|  
213 -|productSkc|int|是|1222|skc|  
214 -|productSku|int|是|1222|sku|  
215 -|factoryCode|string|是|234234|出厂编号|  
216 -|sortId|int|是|12|产品分类 |  
217 -|shopId|int|否|17|是|店铺ID | 189 +
218 190
219 注意，通用的头部没有列出。 191 注意，通用的头部没有列出。
220 请求示例 192 请求示例
221 http://192.168.102.217:8080/gateway?method=app.shops.storagein 193 http://192.168.102.217:8080/gateway?method=app.shops.storagein
222 194
223 ## 请求样例数据 195 ## 请求样例数据
224 -```json 196 +### 返回
  197 +
  198 +``` json
  199 +请求样例：
225 { 200 {
226 "page": 1, 201 "page": 1,
227 "size": 2 202 "size": 2
228 } 203 }
229 -``` 204 +正常返回：
230 205
231 -### 响应  
232 -code为200即为成功，否则是失败。  
233 -响应JSON格式如下所示:  
234 -```json  
235 { 206 {
236 "alg": "SALT_MD5", 207 "alg": "SALT_MD5",
237 "code": 200, 208 "code": 200,
@@ -244,44 +215,21 @@ code为200即为成功，否则是失败。 @@ -244,44 +215,21 @@ code为200即为成功，否则是失败。
244 }, 215 },
245 "list": [ 216 "list": [
246 { 217 {
247 - "brandId": 144,  
248 - "brandName": "VANS",  
249 - "buyNumber": 1,  
250 - "colorId": 2,  
251 - "colorName": "黑色",  
252 - "dateId": 20160518,  
253 - "factoryCode": "VN0004PA1861",  
254 - "goodsName": "VANS Sk8-Hi Lite 超轻来袭 ",  
255 - "imageUrl": "",  
256 - "maxSortId": 6,  
257 - "maxSortName": "鞋靴",  
258 - "middleSortId": 44,  
259 - "middleSortName": "休闲/运动鞋",  
260 - "orderAmount": 665,  
261 - "orderCode": 1605008704,  
262 - "productSkc": 371718,  
263 - "productSkn": 51227423,  
264 - "productSku": 1159909,  
265 - "retailPrice": 665,  
266 - "salesPrice": 665,  
267 - "shopName": "",  
268 - "sizeId": 125,  
269 - "sizeName": "42码",  
270 - "smallSortId": 147,  
271 - "smallSortName": "休闲/运动鞋" 218 + "dateId": 20160518,//日期
  219 + "inStorageNums": 665,//数量
  220 + "requisitionFormId": 1605008704,//单号
  221 + "inStorageAmount": 2342//金额
272 } 222 }
273 ], 223 ],
274 "page": 1, 224 "page": 1,
275 "size": 10, 225 "size": 10,
276 - "total": 1,  
277 - "totalPage": 1 226 + "total": 14612,
  227 + "totalPage": 1462
278 }, 228 },
279 "md5": "ce4964c1e6defece5035c81b63c3c51d", 229 "md5": "ce4964c1e6defece5035c81b63c3c51d",
280 "message": "getOrdersGoodsRptList result" 230 "message": "getOrdersGoodsRptList result"
281 } 231 }
282 -```  
283 -  
284 -```json 232 +异常返回：
285 { 233 {
286 "code": 405, 234 "code": 405,
287 "data": [], 235 "data": [],
@@ -307,32 +255,21 @@ code为200即为成功，否则是失败。 @@ -307,32 +255,21 @@ code为200即为成功，否则是失败。
307 |:-------| -----:|-----:|-----:|----:| 255 |:-------| -----:|-----:|-----:|----:|
308 |page|int||是|2|第几页| 256 |page|int||是|2|第几页|
309 |size|int|是|10|每页条数| 257 |size|int|是|10|每页条数|
310 -|type|int|是|1|1 日 2 周 3 月|  
311 |beginTime|string|是|20150306|周报：开始日期| 258 |beginTime|string|是|20150306|周报：开始日期|
312 |endTime|string|是|20150308|周报：结束日期| 259 |endTime|string|是|20150308|周报：结束日期|
313 -|productSkn|int|是|1222|skn|  
314 -|productSkc|int|是|1222|skc|  
315 -|productSku|int|是|1222|sku|  
316 -|factoryCode|string|是|234234|出厂编号|  
317 -|sortId|int|是|12|产品分类 |  
318 -|shopId|int|否|17|是|店铺ID | 260 +
319 261
320 注意，通用的头部没有列出。 262 注意，通用的头部没有列出。
321 请求示例 263 请求示例
322 http://192.168.102.217:8080/gateway?method=app.shops.storageout 264 http://192.168.102.217:8080/gateway?method=app.shops.storageout
323 265
324 -## 请求样例数据  
325 -```json 266 +``` json
  267 +请求样例：
326 { 268 {
327 "page": 1, 269 "page": 1,
328 "size": 2 270 "size": 2
329 } 271 }
330 -```  
331 -  
332 -### 响应  
333 -code为200即为成功，否则是失败。  
334 -响应JSON格式如下所示:  
335 -```json 272 +正常返回：
336 { 273 {
337 "alg": "SALT_MD5", 274 "alg": "SALT_MD5",
338 "code": 200, 275 "code": 200,
@@ -345,50 +282,28 @@ code为200即为成功，否则是失败。 @@ -345,50 +282,28 @@ code为200即为成功，否则是失败。
345 }, 282 },
346 "list": [ 283 "list": [
347 { 284 {
348 - "brandId": 144,  
349 - "brandName": "VANS",  
350 - "buyNumber": 1,  
351 - "colorId": 2,  
352 - "colorName": "黑色",  
353 "dateId": 20160518, 285 "dateId": 20160518,
354 - "factoryCode": "VN0004PA1861",  
355 - "goodsName": "VANS Sk8-Hi Lite 超轻来袭 ",  
356 - "imageUrl": "",  
357 - "maxSortId": 6,  
358 - "maxSortName": "鞋靴",  
359 - "middleSortId": 44,  
360 - "middleSortName": "休闲/运动鞋",  
361 - "orderAmount": 665,  
362 - "orderCode": 1605008704,  
363 - "productSkc": 371718,  
364 - "productSkn": 51227423,  
365 - "productSku": 1159909,  
366 - "retailPrice": 665,  
367 - "salesPrice": 665,  
368 - "shopName": "",  
369 - "sizeId": 125,  
370 - "sizeName": "42码",  
371 - "smallSortId": 147,  
372 - "smallSortName": "休闲/运动鞋" 286 + "outStorageNums": 665,
  287 + "outFormId": 1605008704,
  288 + "outStorageAmount": 2342
373 } 289 }
374 ], 290 ],
375 "page": 1, 291 "page": 1,
376 "size": 10, 292 "size": 10,
377 - "total": 1,  
378 - "totalPage": 1 293 + "total": 14612,
  294 + "totalPage": 1462
379 }, 295 },
380 "md5": "ce4964c1e6defece5035c81b63c3c51d", 296 "md5": "ce4964c1e6defece5035c81b63c3c51d",
381 - "message": "getOrdersGoodsRptList result" 297 + "message": "result"
382 } 298 }
383 -```  
384 -  
385 -```json 299 +异常返回：
386 { 300 {
387 "code": 405, 301 "code": 405,
388 "data": [], 302 "data": [],
389 "md5": "d751713988987e9331980363e24189ce", 303 "md5": "d751713988987e9331980363e24189ce",
390 - "message": "getOrdersGoodsRptList" 304 + "message": "getStorageOutRptForApi"
391 } 305 }
  306 +
392 ``` 307 ```
393 308
394 ## 5、获取店铺的品牌排名，当前等级、排名、上升名词## 309 ## 5、获取店铺的品牌排名，当前等级、排名、上升名词##