Update ShopReportController.md
Showing
1 changed file
with
722 additions
and
652 deletions
| 1 | -## 1、查询销售统计报表## | ||
| 2 | - | ||
| 3 | -查询销售统计报表（method=app.shops.sales） | ||
| 4 | -#### 公共请求参数 | ||
| 5 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 6 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 7 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 8 | -|app_version|float|10|否|1||APP版本| | ||
| 9 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 10 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 11 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 12 | - | ||
| 13 | -#### 请求参数 | ||
| 14 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 15 | -|:-------| -----:|-----:|-----:|----:| | ||
| 16 | -|page|int|是|2|第几页| | ||
| 17 | -|size|int|是|10|每页条数| | ||
| 18 | -|type|int|否|1|1 日 2 周 3 月| | ||
| 19 | -|reqTime|int|是|20160521|日报 月报 日期| | ||
| 20 | -|beginTime|string|是|20160521|周报：开始日期| | ||
| 21 | -|endTime|string|是|20160527|周报：结束日期| | ||
| 22 | -|productSkn|long|是|1222|skn| | ||
| 23 | -|productSkc|long|是|1222|skc| | ||
| 24 | -|productSku|long|是|1222|sku| | ||
| 25 | -|factoryCode|string|是|234234|出厂编号| | ||
| 26 | -|sortId|int|是|12|是|产品分类 | | ||
| 27 | -|shopId|int|否|17|是|店铺ID | | ||
| 28 | -|brandId|int|否|17|是|品牌 | | ||
| 29 | - | ||
| 30 | -注意，通用的头部没有列出。 | ||
| 31 | -请求示例 | ||
| 32 | -http://192.168.102.217:8080/gateway?method=app.shops.sales | ||
| 33 | - | ||
| 34 | -## 请求样例数据 | ||
| 35 | -```json | ||
| 36 | -{ | ||
| 37 | - "page": 1, | ||
| 38 | - "size": 2 | ||
| 39 | -} | ||
| 40 | -``` | ||
| 41 | - | ||
| 42 | -### 响应 | ||
| 43 | -code为200即为成功，否则是失败。 | ||
| 44 | -响应JSON格式如下所示: | ||
| 45 | -```json | ||
| 46 | -{ | ||
| 47 | - "alg": "SALT_MD5", | ||
| 48 | - "code": 200, | ||
| 49 | - "data": { | ||
| 50 | - "additionInfo": { | ||
| 51 | - "allAmount": 2977123.6, | ||
| 52 | - "allAmountRate": 0, | ||
| 53 | - "allNumber": 14749, | ||
| 54 | - "allNumberRate": 0, | ||
| 55 | - "lastAllAmount": 2977323.78, | ||
| 56 | - "lastAllNumber": 14746 | ||
| 57 | - }, | ||
| 58 | - "list": [ | ||
| 59 | - { | ||
| 60 | - "allAmounts": 2970434.16, | ||
| 61 | - "allNums": 14731, | ||
| 62 | - "dateId": "20160518" | ||
| 63 | - }, | ||
| 64 | - { | ||
| 65 | - "allAmounts": 295.04, | ||
| 66 | - "allNums": 4, | ||
| 67 | - "dateId": "20160525" | ||
| 68 | - } | ||
| 69 | - ], | ||
| 70 | - "page": 1, | ||
| 71 | - "size": 1, | ||
| 72 | - "total": 1, | ||
| 73 | - "totalPage": 1 | ||
| 74 | - }, | ||
| 75 | - "md5": "6bed08aeaa2b44e6238f889d007c358d", | ||
| 76 | - "message": "getOrdersGoodsRptForApi result" | ||
| 77 | -} | ||
| 78 | -``` | ||
| 79 | - | ||
| 80 | -```json | ||
| 81 | -{ | ||
| 82 | - "code": 405, | ||
| 83 | - "data": [], | ||
| 84 | - "md5": "d751713988987e9331980363e24189ce", | ||
| 85 | - "message": "getOrdersGoodsRptList" | ||
| 86 | -} | ||
| 87 | -``` | ||
| 88 | - | ||
| 89 | - | ||
| 90 | -## 2、查询退货统计报表## | ||
| 91 | - | ||
| 92 | -查询退货统计报表（method=app.shops.refund） | ||
| 93 | -#### 公共请求参数 | ||
| 94 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 95 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 96 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 97 | -|app_version|float|10|否|1||APP版本| | ||
| 98 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 99 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 100 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 101 | - | ||
| 102 | -#### 请求参数 | ||
| 103 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 104 | -|:-------| -----:|-----:|-----:|----:| | ||
| 105 | -|page|int||是|2|第几页| | ||
| 106 | -|size|int|是|10|每页条数| | ||
| 107 | -|type|int|否|1|1 日 2 周 3 月| | ||
| 108 | -|reqTime|string|是|20150306|日报 月报 日期| | ||
| 109 | -|beginTime|string|是|20150306|周报：开始日期| | ||
| 110 | -|endTime|string|是|20150308|周报：结束日期| | ||
| 111 | -|productSkn|int|是|1222|skn| | ||
| 112 | -|productSkc|int|是|1222|skc| | ||
| 113 | -|productSku|int|是|1222|sku| | ||
| 114 | -|factoryCode|string|是|234234|出厂编号| | ||
| 115 | -|sortId|int|是|12|产品分类 | | ||
| 116 | -|shopId|int|否|17|是|店铺ID | | ||
| 117 | - | ||
| 118 | -注意，通用的头部没有列出。 | ||
| 119 | -请求示例 | ||
| 120 | -http://192.168.102.217:8080/gateway?method=app.shops.refund | ||
| 121 | - | ||
| 122 | -## 请求样例数据 | ||
| 123 | -```json | ||
| 124 | -{ | ||
| 125 | - "page": 1, | ||
| 126 | - "size": 2 | ||
| 127 | -} | ||
| 128 | -``` | ||
| 129 | - | ||
| 130 | -### 响应 | ||
| 131 | -code为200即为成功，否则是失败。 | ||
| 132 | -响应JSON格式如下所示: | ||
| 133 | -```json | ||
| 134 | -{ | ||
| 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 | ||
| 177 | - }, | ||
| 178 | - "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 179 | - "message": "getOrdersGoodsRptList result" | ||
| 180 | -} | ||
| 181 | -``` | ||
| 182 | - | ||
| 183 | -```json | ||
| 184 | -{ | ||
| 185 | - "code": 405, | ||
| 186 | - "data": [], | ||
| 187 | - "md5": "d751713988987e9331980363e24189ce", | ||
| 188 | - "message": "getOrdersGoodsRptList" | ||
| 189 | -} | ||
| 190 | -``` | ||
| 191 | - | ||
| 192 | -## 3、查询进库统计报表## | ||
| 193 | - | ||
| 194 | -查询进库统计报表（method=app.shops.storagein） | ||
| 195 | -#### 公共请求参数 | ||
| 196 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 197 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 198 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 199 | -|app_version|float|10|否|1||APP版本| | ||
| 200 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 201 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 202 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 203 | - | ||
| 204 | -#### 请求参数 | ||
| 205 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 206 | -|:-------| -----:|-----:|-----:|----:| | ||
| 207 | -|page|int||是|2|第几页| | ||
| 208 | -|size|int|是|10|每页条数| | ||
| 209 | -|type|int|是|1|1 日 2 周 3 月| | ||
| 210 | -|beginTime|string|是|20150306|周报：开始日期| | ||
| 211 | -|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 | | ||
| 218 | - | ||
| 219 | -注意，通用的头部没有列出。 | ||
| 220 | -请求示例 | ||
| 221 | -http://192.168.102.217:8080/gateway?method=app.shops.storagein | ||
| 222 | - | ||
| 223 | -## 请求样例数据 | ||
| 224 | -```json | ||
| 225 | -{ | ||
| 226 | - "page": 1, | ||
| 227 | - "size": 2 | ||
| 228 | -} | ||
| 229 | -``` | ||
| 230 | - | ||
| 231 | -### 响应 | ||
| 232 | -code为200即为成功，否则是失败。 | ||
| 233 | -响应JSON格式如下所示: | ||
| 234 | -```json | ||
| 235 | -{ | ||
| 236 | - "alg": "SALT_MD5", | ||
| 237 | - "code": 200, | ||
| 238 | - "data": { | ||
| 239 | - "additionInfo": { | ||
| 240 | - "allAmount": 2977818.56, | ||
| 241 | - "allAmountRate": 2977817.56, | ||
| 242 | - "allNumber": 14747, | ||
| 243 | - "allNumberRate": 14746 | ||
| 244 | - }, | ||
| 245 | - "list": [ | ||
| 246 | - { | ||
| 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": "休闲/运动鞋" | ||
| 272 | - } | ||
| 273 | - ], | ||
| 274 | - "page": 1, | ||
| 275 | - "size": 10, | ||
| 276 | - "total": 1, | ||
| 277 | - "totalPage": 1 | ||
| 278 | - }, | ||
| 279 | - "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 280 | - "message": "getOrdersGoodsRptList result" | ||
| 281 | -} | ||
| 282 | -``` | ||
| 283 | - | ||
| 284 | -```json | ||
| 285 | -{ | ||
| 286 | - "code": 405, | ||
| 287 | - "data": [], | ||
| 288 | - "md5": "d751713988987e9331980363e24189ce", | ||
| 289 | - "message": "getOrdersGoodsRptList" | ||
| 290 | -} | ||
| 291 | -``` | ||
| 292 | - | ||
| 293 | -## 4、查询销售出库统计报表## | ||
| 294 | - | ||
| 295 | -查询销售出库统计报表（method=app.shops.storageout） | ||
| 296 | -#### 公共请求参数 | ||
| 297 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 298 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 299 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 300 | -|app_version|float|10|否|1||APP版本| | ||
| 301 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 302 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 303 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 304 | - | ||
| 305 | -#### 请求参数 | ||
| 306 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 307 | -|:-------| -----:|-----:|-----:|----:| | ||
| 308 | -|page|int||是|2|第几页| | ||
| 309 | -|size|int|是|10|每页条数| | ||
| 310 | -|type|int|是|1|1 日 2 周 3 月| | ||
| 311 | -|beginTime|string|是|20150306|周报：开始日期| | ||
| 312 | -|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 | | ||
| 319 | - | ||
| 320 | -注意，通用的头部没有列出。 | ||
| 321 | -请求示例 | ||
| 322 | -http://192.168.102.217:8080/gateway?method=app.shops.storageout | ||
| 323 | - | ||
| 324 | -## 请求样例数据 | ||
| 325 | -```json | ||
| 326 | -{ | ||
| 327 | - "page": 1, | ||
| 328 | - "size": 2 | ||
| 329 | -} | ||
| 330 | -``` | ||
| 331 | - | ||
| 332 | -### 响应 | ||
| 333 | -code为200即为成功，否则是失败。 | ||
| 334 | -响应JSON格式如下所示: | ||
| 335 | -```json | ||
| 336 | -{ | ||
| 337 | - "alg": "SALT_MD5", | ||
| 338 | - "code": 200, | ||
| 339 | - "data": { | ||
| 340 | - "additionInfo": { | ||
| 341 | - "allAmount": 2977818.56, | ||
| 342 | - "allAmountRate": 2977817.56, | ||
| 343 | - "allNumber": 14747, | ||
| 344 | - "allNumberRate": 14746 | ||
| 345 | - }, | ||
| 346 | - "list": [ | ||
| 347 | - { | ||
| 348 | - "brandId": 144, | ||
| 349 | - "brandName": "VANS", | ||
| 350 | - "buyNumber": 1, | ||
| 351 | - "colorId": 2, | ||
| 352 | - "colorName": "黑色", | ||
| 353 | - "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": "休闲/运动鞋" | ||
| 373 | - } | ||
| 374 | - ], | ||
| 375 | - "page": 1, | ||
| 376 | - "size": 10, | ||
| 377 | - "total": 1, | ||
| 378 | - "totalPage": 1 | ||
| 379 | - }, | ||
| 380 | - "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 381 | - "message": "getOrdersGoodsRptList result" | ||
| 382 | -} | ||
| 383 | -``` | ||
| 384 | - | ||
| 385 | -```json | ||
| 386 | -{ | ||
| 387 | - "code": 405, | ||
| 388 | - "data": [], | ||
| 389 | - "md5": "d751713988987e9331980363e24189ce", | ||
| 390 | - "message": "getOrdersGoodsRptList" | ||
| 391 | -} | ||
| 392 | -``` | ||
| 393 | - | ||
| 394 | -## 5、获取店铺的品牌排名，当前等级、排名、上升名词## | ||
| 395 | - | ||
| 396 | -获取店铺的品牌排名，当前等级、排名、上升名词（method=app.shops.shopbrandrank） | ||
| 397 | -#### 公共请求参数 | ||
| 398 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 399 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 400 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 401 | -|app_version|float|10|否|1||APP版本| | ||
| 402 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 403 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 404 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 405 | - | ||
| 406 | -#### 请求参数 | ||
| 407 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 408 | -|:-------| -----:|-----:|-----:|----:| | ||
| 409 | -|brandId|int|否||品牌id| | ||
| 410 | -|dateId |int|否||日期| | ||
| 411 | - | ||
| 412 | - | ||
| 413 | -注意，通用的头部没有列出。 | ||
| 414 | -请求示例 | ||
| 415 | -http://192.168.102.217:8080/gateway?method=app.shops.shopbrandrank&brandId=1200&dateId=20160524 | ||
| 416 | - | ||
| 417 | - | ||
| 418 | -### 响应 | ||
| 419 | -code为200即为成功，否则是失败。 | ||
| 420 | -响应JSON格式如下所示: | ||
| 421 | -```json | ||
| 422 | -{ | ||
| 423 | - { | ||
| 424 | - "alg": "SALT_MD5", | ||
| 425 | - "code": 200, | ||
| 426 | - "data": { | ||
| 427 | - "brandId": 1200, | ||
| 428 | - "brandMainCategory": 2, | ||
| 429 | - "dateId": 20160524, | ||
| 430 | - "rankChange": 5, | ||
| 431 | - "rankLevel": 1, | ||
| 432 | - "rankNow": 15 | ||
| 433 | - }, | ||
| 434 | - "md5": "64cdf0d30ba9174ddce76ecf71a91ad8", | ||
| 435 | - "message": "shop business overview." | ||
| 436 | -} | ||
| 437 | -} | ||
| 438 | -``` | ||
| 439 | - | ||
| 440 | - | ||
| 441 | -## 6、查询库存列表## | ||
| 442 | - | ||
| 443 | -查询库存列表（method=app.shops.storagestatistics） | ||
| 444 | -#### 公共请求参数 | ||
| 445 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 446 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 447 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 448 | -|app_version|float|10|否|1||APP版本| | ||
| 449 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 450 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 451 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 452 | - | ||
| 453 | -#### 请求参数 | ||
| 454 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 455 | -|:-------| -----:|-----:|-----:|----:| | ||
| 456 | -|productSkn|int|是||商品skn| | ||
| 457 | -|factory_code|string|是||商品厂家编码| | ||
| 458 | -|productSku|int|是||商品sku| | ||
| 459 | -|shopId|int|是||店铺Id| | ||
| 460 | -|brandId|int|是||品牌Id| | ||
| 461 | -|maxSortId|int|是||一级分类Id| | ||
| 462 | -|middleSortId|int|是||二级分类Id| | ||
| 463 | -|smallSortId|int|是||三级分类Id| | ||
| 464 | - | ||
| 465 | -注意，通用的头部没有列出。 | ||
| 466 | -请求示例 | ||
| 467 | -http://192.168.102.217:8080/gateway?method=app.shops.storagestatistics&brandId=11 | ||
| 468 | - | ||
| 469 | - | ||
| 470 | -### 响应 | ||
| 471 | -code为200即为成功，否则是失败。 | ||
| 472 | -响应JSON格式如下所示: | ||
| 473 | -```json | ||
| 474 | -{ | ||
| 475 | - { | ||
| 476 | - "alg": "SALT_MD5", | ||
| 477 | - "code": 200, | ||
| 478 | - "data": { | ||
| 479 | - "additionInfo": { | ||
| 480 | - "onSaleTotalNum": 1, // 已上架商品数 | ||
| 481 | - "outSaleTotalNum": 1, // 已下架商品数 | ||
| 482 | - "preSaleTotalNum": 2, // 待上架商品数 | ||
| 483 | - "storageTotalMoney": 67.3, // 库存总金额（元） | ||
| 484 | - "storageTotalNum": 47 // 库存总数量 | ||
| 485 | - }, | ||
| 486 | - "list": [ | ||
| 487 | - { | ||
| 488 | - "brandId": 11, | ||
| 489 | - "brandName": "", | ||
| 490 | - "colorId": 0, | ||
| 491 | - "colorName": "", | ||
| 492 | - "dateId": 0, | ||
| 493 | - "goodsName": "", | ||
| 494 | - "imageUrl": "0", | ||
| 495 | - "maxSortId": 0, | ||
| 496 | - "maxSortName": "0", | ||
| 497 | - "middleSortId": 0, | ||
| 498 | - "middleSortName": "", | ||
| 499 | - "productSkc": 0, | ||
| 500 | - "productSkn": 0, | ||
| 501 | - "productSku": 0, | ||
| 502 | - "purchasePrice": 0, | ||
| 503 | - "salesPrice": 0, | ||
| 504 | - "shopId": 0, | ||
| 505 | - "shopName": "", | ||
| 506 | - "sizeId": 0, | ||
| 507 | - "sizeName": "", | ||
| 508 | - "smallSortId": 0, | ||
| 509 | - "smallSortName": "", | ||
| 510 | - "status": "1", | ||
| 511 | - "storageAmount": 33.3, | ||
| 512 | - "storeNums": 11 | ||
| 513 | - }, | ||
| 514 | - { | ||
| 515 | - "brandId": 11, | ||
| 516 | - "brandName": "", | ||
| 517 | - "colorId": 0, | ||
| 518 | - "colorName": "", | ||
| 519 | - "dateId": 0, | ||
| 520 | - "goodsName": "", | ||
| 521 | - "imageUrl": "0", | ||
| 522 | - "maxSortId": 0, | ||
| 523 | - "maxSortName": "0", | ||
| 524 | - "middleSortId": 0, | ||
| 525 | - "middleSortName": "", | ||
| 526 | - "productSkc": 0, | ||
| 527 | - "productSkn": 0, | ||
| 528 | - "productSku": 0, | ||
| 529 | - "purchasePrice": 0, | ||
| 530 | - "salesPrice": 0, | ||
| 531 | - "shopId": 0, | ||
| 532 | - "shopName": "", | ||
| 533 | - "sizeId": 0, | ||
| 534 | - "sizeName": "", | ||
| 535 | - "smallSortId": 0, | ||
| 536 | - "smallSortName": "", | ||
| 537 | - "status": "2", | ||
| 538 | - "storageAmount": 22, | ||
| 539 | - "storeNums": 22 | ||
| 540 | - }, | ||
| 541 | - { | ||
| 542 | - "brandId": 11, | ||
| 543 | - "brandName": "", | ||
| 544 | - "colorId": 0, | ||
| 545 | - "colorName": "", | ||
| 546 | - "dateId": 0, | ||
| 547 | - "goodsName": "", | ||
| 548 | - "imageUrl": "0", | ||
| 549 | - "maxSortId": 0, | ||
| 550 | - "maxSortName": "0", | ||
| 551 | - "middleSortId": 0, | ||
| 552 | - "middleSortName": "", | ||
| 553 | - "productSkc": 0, | ||
| 554 | - "productSkn": 0, | ||
| 555 | - "productSku": 0, | ||
| 556 | - "purchasePrice": 0, | ||
| 557 | - "salesPrice": 0, | ||
| 558 | - "shopId": 0, | ||
| 559 | - "shopName": "", | ||
| 560 | - "sizeId": 0, | ||
| 561 | - "sizeName": "", | ||
| 562 | - "smallSortId": 0, | ||
| 563 | - "smallSortName": "", | ||
| 564 | - "status": "3", | ||
| 565 | - "storageAmount": 11, | ||
| 566 | - "storeNums": 13 | ||
| 567 | - }, | ||
| 568 | - { | ||
| 569 | - "brandId": 11, | ||
| 570 | - "brandName": "", | ||
| 571 | - "colorId": 0, | ||
| 572 | - "colorName": "", | ||
| 573 | - "dateId": 0, | ||
| 574 | - "goodsName": "", | ||
| 575 | - "imageUrl": "0", | ||
| 576 | - "maxSortId": 0, | ||
| 577 | - "maxSortName": "0", | ||
| 578 | - "middleSortId": 0, | ||
| 579 | - "middleSortName": "", | ||
| 580 | - "productSkc": 0, | ||
| 581 | - "productSkn": 0, | ||
| 582 | - "productSku": 0, | ||
| 583 | - "purchasePrice": 0, | ||
| 584 | - "salesPrice": 0, | ||
| 585 | - "shopId": 0, | ||
| 586 | - "shopName": "", | ||
| 587 | - "sizeId": 0, | ||
| 588 | - "sizeName": "", | ||
| 589 | - "smallSortId": 0, | ||
| 590 | - "smallSortName": "", | ||
| 591 | - "status": "2", | ||
| 592 | - "storageAmount": 1, | ||
| 593 | - "storeNums": 1 | ||
| 594 | - } | ||
| 595 | - ], | ||
| 596 | - "page": 1, | ||
| 597 | - "size": 10, | ||
| 598 | - "total": 4, | ||
| 599 | - "totalPage": 1 | ||
| 600 | - }, | ||
| 601 | - "md5": "83ccbb2eb14e08c90558b7c00d6c0b8e", | ||
| 602 | - "message": "storage statistics list" | ||
| 603 | -} | ||
| 604 | -} | ||
| 605 | -``` | ||
| 606 | - | ||
| 607 | -## 7、获取店铺的经营指标：一个自然日内有效订单商品件数、有效订单商品 金额## | ||
| 608 | - | ||
| 609 | -获取店铺的经营指标：一个自然日内有效订单商品件数、有效订单商品 金额（method=app.shops.shopbusinessoverview） | ||
| 610 | -#### 公共请求参数 | ||
| 611 | -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 612 | -|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 613 | -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 614 | -|app_version|float|10|否|1||APP版本| | ||
| 615 | -|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 616 | -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 617 | -|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 618 | - | ||
| 619 | -#### 请求参数 | ||
| 620 | -| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 621 | -|:-------| -----:|-----:|-----:|----:| | ||
| 622 | -|brandId|int|否||品牌id| | ||
| 623 | -|dateId |int|否||日期| | ||
| 624 | - | ||
| 625 | - | ||
| 626 | -注意，通用的头部没有列出。 | ||
| 627 | -请求示例 | ||
| 628 | -http://192.168.102.217:8080/gateway?method=app.shops.shopbrandrank&brandId=1200&dateId=20160524 | ||
| 629 | - | ||
| 630 | - | ||
| 631 | -### 响应 | ||
| 632 | -code为200即为成功，否则是失败。 | ||
| 633 | -响应JSON格式如下所示: | ||
| 634 | -``` json | ||
| 635 | -{ | ||
| 636 | - "alg": "SALT_MD5", | ||
| 637 | - "code": 200, | ||
| 638 | - "data": { | ||
| 639 | - "brandId": 1200, | ||
| 640 | - "brandName": "wss", | ||
| 641 | - "buyNumbers": 100, | ||
| 642 | - "dateId": 20160523, | ||
| 643 | - "orderAmount": 100, | ||
| 644 | - "shopId": 431, | ||
| 645 | - "shopName": "wss" | ||
| 646 | - }, | ||
| 647 | - "md5": "1d143fd1d71504f9d7a82121202c4bfc", | ||
| 648 | - "message": "shop business overview." | ||
| 649 | -} | ||
| 650 | - | ||
| 651 | -``` | ||
| 652 | - | 1 | +## 1、查询销售统计报表## |
| 2 | + | ||
| 3 | +查询销售统计报表（method=app.shops.sales） | ||
| 4 | +#### 公共请求参数 | ||
| 5 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 6 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 7 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 8 | +|app_version|float|10|否|1||APP版本| | ||
| 9 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 10 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 11 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 12 | + | ||
| 13 | +#### 请求参数 | ||
| 14 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 15 | +|:-------| -----:|-----:|-----:|----:| | ||
| 16 | +|page|int|是|2|第几页| | ||
| 17 | +|size|int|是|10|每页条数| | ||
| 18 | +|type|int|否|1|1 日 2 周 3 月| | ||
| 19 | +|reqTime|int|是|20160521|日报 月报 日期| | ||
| 20 | +|beginTime|string|是|20160521|周报：开始日期| | ||
| 21 | +|endTime|string|是|20160527|周报：结束日期| | ||
| 22 | +|productSkn|long|是|1222|skn| | ||
| 23 | +|productSkc|long|是|1222|skc| | ||
| 24 | +|productSku|long|是|1222|sku| | ||
| 25 | +|factoryCode|string|是|234234|出厂编号| | ||
| 26 | +|sortId|int|是|12|是|产品分类 | | ||
| 27 | +|shopId|int|否|17|是|店铺ID | | ||
| 28 | +|brandId|int|否|17|是|品牌 | | ||
| 29 | + | ||
| 30 | +注意，通用的头部没有列出。 | ||
| 31 | +请求示例 | ||
| 32 | +http://192.168.102.217:8080/gateway?method=app.shops.sales | ||
| 33 | + | ||
| 34 | +## 请求样例数据 | ||
| 35 | +```json | ||
| 36 | +{ | ||
| 37 | + "page": 1, | ||
| 38 | + "size": 2 | ||
| 39 | +} | ||
| 40 | +``` | ||
| 41 | + | ||
| 42 | +### 响应 | ||
| 43 | +code为200即为成功，否则是失败。 | ||
| 44 | +响应JSON格式如下所示: | ||
| 45 | +```json | ||
| 46 | +{ | ||
| 47 | + "alg": "SALT_MD5", | ||
| 48 | + "code": 200, | ||
| 49 | + "data": { | ||
| 50 | + "additionInfo": { | ||
| 51 | + "allAmount": 2977123.6, | ||
| 52 | + "allAmountRate": 0, | ||
| 53 | + "allNumber": 14749, | ||
| 54 | + "allNumberRate": 0, | ||
| 55 | + "lastAllAmount": 2977323.78, | ||
| 56 | + "lastAllNumber": 14746 | ||
| 57 | + }, | ||
| 58 | + "list": [ | ||
| 59 | + { | ||
| 60 | + "allAmounts": 2970434.16, | ||
| 61 | + "allNums": 14731, | ||
| 62 | + "dateId": "20160518" | ||
| 63 | + }, | ||
| 64 | + { | ||
| 65 | + "allAmounts": 295.04, | ||
| 66 | + "allNums": 4, | ||
| 67 | + "dateId": "20160525" | ||
| 68 | + } | ||
| 69 | + ], | ||
| 70 | + "page": 1, | ||
| 71 | + "size": 1, | ||
| 72 | + "total": 1, | ||
| 73 | + "totalPage": 1 | ||
| 74 | + }, | ||
| 75 | + "md5": "6bed08aeaa2b44e6238f889d007c358d", | ||
| 76 | + "message": "getOrdersGoodsRptForApi result" | ||
| 77 | +} | ||
| 78 | +``` | ||
| 79 | + | ||
| 80 | +```json | ||
| 81 | +{ | ||
| 82 | + "code": 405, | ||
| 83 | + "data": [], | ||
| 84 | + "md5": "d751713988987e9331980363e24189ce", | ||
| 85 | + "message": "getOrdersGoodsRptList" | ||
| 86 | +} | ||
| 87 | +``` | ||
| 88 | + | ||
| 89 | + | ||
| 90 | +## 2、查询退货统计报表## | ||
| 91 | + | ||
| 92 | +查询退货统计报表（method=app.shops.refund） | ||
| 93 | +#### 公共请求参数 | ||
| 94 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 95 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 96 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 97 | +|app_version|float|10|否|1||APP版本| | ||
| 98 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 99 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 100 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 101 | + | ||
| 102 | +#### 请求参数 | ||
| 103 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 104 | +|:-------| -----:|-----:|-----:|----:| | ||
| 105 | +|page|int||是|2|第几页| | ||
| 106 | +|size|int|是|10|每页条数| | ||
| 107 | +|type|int|否|1|1 日 2 周 3 月| | ||
| 108 | +|reqTime|string|是|20150306|日报 月报 日期| | ||
| 109 | +|beginTime|string|是|20150306|周报：开始日期| | ||
| 110 | +|endTime|string|是|20150308|周报：结束日期| | ||
| 111 | +|productSkn|int|是|1222|skn| | ||
| 112 | +|productSkc|int|是|1222|skc| | ||
| 113 | +|productSku|int|是|1222|sku| | ||
| 114 | +|factoryCode|string|是|234234|出厂编号| | ||
| 115 | +|sortId|int|是|12|产品分类 | | ||
| 116 | +|shopId|int|否|17|是|店铺ID | | ||
| 117 | + | ||
| 118 | +注意，通用的头部没有列出。 | ||
| 119 | +请求示例 | ||
| 120 | +http://192.168.102.217:8080/gateway?method=app.shops.refund | ||
| 121 | + | ||
| 122 | +## 请求样例数据 | ||
| 123 | +```json | ||
| 124 | +{ | ||
| 125 | + "page": 1, | ||
| 126 | + "size": 2 | ||
| 127 | +} | ||
| 128 | +``` | ||
| 129 | + | ||
| 130 | +### 响应 | ||
| 131 | +code为200即为成功，否则是失败。 | ||
| 132 | +响应JSON格式如下所示: | ||
| 133 | +```json | ||
| 134 | +{ | ||
| 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 | ||
| 177 | + }, | ||
| 178 | + "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 179 | + "message": "getOrdersGoodsRptList result" | ||
| 180 | +} | ||
| 181 | +``` | ||
| 182 | + | ||
| 183 | +```json | ||
| 184 | +{ | ||
| 185 | + "code": 405, | ||
| 186 | + "data": [], | ||
| 187 | + "md5": "d751713988987e9331980363e24189ce", | ||
| 188 | + "message": "getOrdersGoodsRptList" | ||
| 189 | +} | ||
| 190 | +``` | ||
| 191 | + | ||
| 192 | +## 3、查询进库统计报表## | ||
| 193 | + | ||
| 194 | +查询进库统计报表（method=app.shops.storagein） | ||
| 195 | +#### 公共请求参数 | ||
| 196 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 197 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 198 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 199 | +|app_version|float|10|否|1||APP版本| | ||
| 200 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 201 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 202 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 203 | + | ||
| 204 | +#### 请求参数 | ||
| 205 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 206 | +|:-------| -----:|-----:|-----:|----:| | ||
| 207 | +|page|int||是|2|第几页| | ||
| 208 | +|size|int|是|10|每页条数| | ||
| 209 | +|type|int|是|1|1 日 2 周 3 月| | ||
| 210 | +|beginTime|string|是|20150306|周报：开始日期| | ||
| 211 | +|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 | | ||
| 218 | + | ||
| 219 | +注意，通用的头部没有列出。 | ||
| 220 | +请求示例 | ||
| 221 | +http://192.168.102.217:8080/gateway?method=app.shops.storagein | ||
| 222 | + | ||
| 223 | +## 请求样例数据 | ||
| 224 | +```json | ||
| 225 | +{ | ||
| 226 | + "page": 1, | ||
| 227 | + "size": 2 | ||
| 228 | +} | ||
| 229 | +``` | ||
| 230 | + | ||
| 231 | +### 响应 | ||
| 232 | +code为200即为成功，否则是失败。 | ||
| 233 | +响应JSON格式如下所示: | ||
| 234 | +```json | ||
| 235 | +{ | ||
| 236 | + "alg": "SALT_MD5", | ||
| 237 | + "code": 200, | ||
| 238 | + "data": { | ||
| 239 | + "additionInfo": { | ||
| 240 | + "allAmount": 2977818.56, | ||
| 241 | + "allAmountRate": 2977817.56, | ||
| 242 | + "allNumber": 14747, | ||
| 243 | + "allNumberRate": 14746 | ||
| 244 | + }, | ||
| 245 | + "list": [ | ||
| 246 | + { | ||
| 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": "休闲/运动鞋" | ||
| 272 | + } | ||
| 273 | + ], | ||
| 274 | + "page": 1, | ||
| 275 | + "size": 10, | ||
| 276 | + "total": 1, | ||
| 277 | + "totalPage": 1 | ||
| 278 | + }, | ||
| 279 | + "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 280 | + "message": "getOrdersGoodsRptList result" | ||
| 281 | +} | ||
| 282 | +``` | ||
| 283 | + | ||
| 284 | +```json | ||
| 285 | +{ | ||
| 286 | + "code": 405, | ||
| 287 | + "data": [], | ||
| 288 | + "md5": "d751713988987e9331980363e24189ce", | ||
| 289 | + "message": "getOrdersGoodsRptList" | ||
| 290 | +} | ||
| 291 | +``` | ||
| 292 | + | ||
| 293 | +## 4、查询销售出库统计报表## | ||
| 294 | + | ||
| 295 | +查询销售出库统计报表（method=app.shops.storageout） | ||
| 296 | +#### 公共请求参数 | ||
| 297 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 298 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 299 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 300 | +|app_version|float|10|否|1||APP版本| | ||
| 301 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 302 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 303 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 304 | + | ||
| 305 | +#### 请求参数 | ||
| 306 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 307 | +|:-------| -----:|-----:|-----:|----:| | ||
| 308 | +|page|int||是|2|第几页| | ||
| 309 | +|size|int|是|10|每页条数| | ||
| 310 | +|type|int|是|1|1 日 2 周 3 月| | ||
| 311 | +|beginTime|string|是|20150306|周报：开始日期| | ||
| 312 | +|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 | | ||
| 319 | + | ||
| 320 | +注意，通用的头部没有列出。 | ||
| 321 | +请求示例 | ||
| 322 | +http://192.168.102.217:8080/gateway?method=app.shops.storageout | ||
| 323 | + | ||
| 324 | +## 请求样例数据 | ||
| 325 | +```json | ||
| 326 | +{ | ||
| 327 | + "page": 1, | ||
| 328 | + "size": 2 | ||
| 329 | +} | ||
| 330 | +``` | ||
| 331 | + | ||
| 332 | +### 响应 | ||
| 333 | +code为200即为成功，否则是失败。 | ||
| 334 | +响应JSON格式如下所示: | ||
| 335 | +```json | ||
| 336 | +{ | ||
| 337 | + "alg": "SALT_MD5", | ||
| 338 | + "code": 200, | ||
| 339 | + "data": { | ||
| 340 | + "additionInfo": { | ||
| 341 | + "allAmount": 2977818.56, | ||
| 342 | + "allAmountRate": 2977817.56, | ||
| 343 | + "allNumber": 14747, | ||
| 344 | + "allNumberRate": 14746 | ||
| 345 | + }, | ||
| 346 | + "list": [ | ||
| 347 | + { | ||
| 348 | + "brandId": 144, | ||
| 349 | + "brandName": "VANS", | ||
| 350 | + "buyNumber": 1, | ||
| 351 | + "colorId": 2, | ||
| 352 | + "colorName": "黑色", | ||
| 353 | + "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": "休闲/运动鞋" | ||
| 373 | + } | ||
| 374 | + ], | ||
| 375 | + "page": 1, | ||
| 376 | + "size": 10, | ||
| 377 | + "total": 1, | ||
| 378 | + "totalPage": 1 | ||
| 379 | + }, | ||
| 380 | + "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 381 | + "message": "getOrdersGoodsRptList result" | ||
| 382 | +} | ||
| 383 | +``` | ||
| 384 | + | ||
| 385 | +```json | ||
| 386 | +{ | ||
| 387 | + "code": 405, | ||
| 388 | + "data": [], | ||
| 389 | + "md5": "d751713988987e9331980363e24189ce", | ||
| 390 | + "message": "getOrdersGoodsRptList" | ||
| 391 | +} | ||
| 392 | +``` | ||
| 393 | + | ||
| 394 | +## 5、获取店铺的品牌排名，当前等级、排名、上升名词## | ||
| 395 | + | ||
| 396 | +获取店铺的品牌排名，当前等级、排名、上升名词（method=app.shops.shopbrandrank） | ||
| 397 | +#### 公共请求参数 | ||
| 398 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 399 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 400 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 401 | +|app_version|float|10|否|1||APP版本| | ||
| 402 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 403 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 404 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 405 | + | ||
| 406 | +#### 请求参数 | ||
| 407 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 408 | +|:-------| -----:|-----:|-----:|----:| | ||
| 409 | +|brandId|int|否||品牌id| | ||
| 410 | +|dateId |int|否||日期| | ||
| 411 | + | ||
| 412 | + | ||
| 413 | +注意，通用的头部没有列出。 | ||
| 414 | +请求示例 | ||
| 415 | +http://192.168.102.217:8080/gateway?method=app.shops.shopbrandrank&brandId=1200&dateId=20160524 | ||
| 416 | + | ||
| 417 | + | ||
| 418 | +### 响应 | ||
| 419 | +code为200即为成功，否则是失败。 | ||
| 420 | +响应JSON格式如下所示: | ||
| 421 | +```json | ||
| 422 | +{ | ||
| 423 | + { | ||
| 424 | + "alg": "SALT_MD5", | ||
| 425 | + "code": 200, | ||
| 426 | + "data": { | ||
| 427 | + "brandId": 1200, | ||
| 428 | + "brandMainCategory": 2, | ||
| 429 | + "dateId": 20160524, | ||
| 430 | + "rankChange": 5, | ||
| 431 | + "rankLevel": 1, | ||
| 432 | + "rankNow": 15 | ||
| 433 | + }, | ||
| 434 | + "md5": "64cdf0d30ba9174ddce76ecf71a91ad8", | ||
| 435 | + "message": "shop business overview." | ||
| 436 | +} | ||
| 437 | +} | ||
| 438 | +``` | ||
| 439 | + | ||
| 440 | + | ||
| 441 | +## 6、查询库存列表## | ||
| 442 | + | ||
| 443 | +查询库存列表（method=app.shops.storagestatistics） | ||
| 444 | +#### 公共请求参数 | ||
| 445 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 446 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 447 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 448 | +|app_version|float|10|否|1||APP版本| | ||
| 449 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 450 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 451 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 452 | + | ||
| 453 | +#### 请求参数 | ||
| 454 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 455 | +|:-------| -----:|-----:|-----:|----:| | ||
| 456 | +|productSkn|int|是||商品skn| | ||
| 457 | +|factory_code|string|是||商品厂家编码| | ||
| 458 | +|productSku|int|是||商品sku| | ||
| 459 | +|shopId|int|是||店铺Id| | ||
| 460 | +|brandId|int|是||品牌Id| | ||
| 461 | +|maxSortId|int|是||一级分类Id| | ||
| 462 | +|middleSortId|int|是||二级分类Id| | ||
| 463 | +|smallSortId|int|是||三级分类Id| | ||
| 464 | + | ||
| 465 | +注意，通用的头部没有列出。 | ||
| 466 | +请求示例 | ||
| 467 | +http://192.168.102.217:8080/gateway?method=app.shops.storagestatistics&brandId=11 | ||
| 468 | + | ||
| 469 | + | ||
| 470 | +### 响应 | ||
| 471 | +code为200即为成功，否则是失败。 | ||
| 472 | +响应JSON格式如下所示: | ||
| 473 | +```json | ||
| 474 | +{ | ||
| 475 | + { | ||
| 476 | + "alg": "SALT_MD5", | ||
| 477 | + "code": 200, | ||
| 478 | + "data": { | ||
| 479 | + "additionInfo": { | ||
| 480 | + "onSaleTotalNum": 1, // 已上架商品数 | ||
| 481 | + "outSaleTotalNum": 1, // 已下架商品数 | ||
| 482 | + "preSaleTotalNum": 2, // 待上架商品数 | ||
| 483 | + "storageTotalMoney": 67.3, // 库存总金额（元） | ||
| 484 | + "storageTotalNum": 47 // 库存总数量 | ||
| 485 | + }, | ||
| 486 | + "list": [ | ||
| 487 | + { | ||
| 488 | + "brandId": 11, | ||
| 489 | + "brandName": "", | ||
| 490 | + "colorId": 0, | ||
| 491 | + "colorName": "", | ||
| 492 | + "dateId": 0, | ||
| 493 | + "goodsName": "", | ||
| 494 | + "imageUrl": "0", | ||
| 495 | + "maxSortId": 0, | ||
| 496 | + "maxSortName": "0", | ||
| 497 | + "middleSortId": 0, | ||
| 498 | + "middleSortName": "", | ||
| 499 | + "productSkc": 0, | ||
| 500 | + "productSkn": 0, | ||
| 501 | + "productSku": 0, | ||
| 502 | + "purchasePrice": 0, | ||
| 503 | + "salesPrice": 0, | ||
| 504 | + "shopId": 0, | ||
| 505 | + "shopName": "", | ||
| 506 | + "sizeId": 0, | ||
| 507 | + "sizeName": "", | ||
| 508 | + "smallSortId": 0, | ||
| 509 | + "smallSortName": "", | ||
| 510 | + "status": "1", | ||
| 511 | + "storageAmount": 33.3, | ||
| 512 | + "storeNums": 11 | ||
| 513 | + }, | ||
| 514 | + { | ||
| 515 | + "brandId": 11, | ||
| 516 | + "brandName": "", | ||
| 517 | + "colorId": 0, | ||
| 518 | + "colorName": "", | ||
| 519 | + "dateId": 0, | ||
| 520 | + "goodsName": "", | ||
| 521 | + "imageUrl": "0", | ||
| 522 | + "maxSortId": 0, | ||
| 523 | + "maxSortName": "0", | ||
| 524 | + "middleSortId": 0, | ||
| 525 | + "middleSortName": "", | ||
| 526 | + "productSkc": 0, | ||
| 527 | + "productSkn": 0, | ||
| 528 | + "productSku": 0, | ||
| 529 | + "purchasePrice": 0, | ||
| 530 | + "salesPrice": 0, | ||
| 531 | + "shopId": 0, | ||
| 532 | + "shopName": "", | ||
| 533 | + "sizeId": 0, | ||
| 534 | + "sizeName": "", | ||
| 535 | + "smallSortId": 0, | ||
| 536 | + "smallSortName": "", | ||
| 537 | + "status": "2", | ||
| 538 | + "storageAmount": 22, | ||
| 539 | + "storeNums": 22 | ||
| 540 | + }, | ||
| 541 | + { | ||
| 542 | + "brandId": 11, | ||
| 543 | + "brandName": "", | ||
| 544 | + "colorId": 0, | ||
| 545 | + "colorName": "", | ||
| 546 | + "dateId": 0, | ||
| 547 | + "goodsName": "", | ||
| 548 | + "imageUrl": "0", | ||
| 549 | + "maxSortId": 0, | ||
| 550 | + "maxSortName": "0", | ||
| 551 | + "middleSortId": 0, | ||
| 552 | + "middleSortName": "", | ||
| 553 | + "productSkc": 0, | ||
| 554 | + "productSkn": 0, | ||
| 555 | + "productSku": 0, | ||
| 556 | + "purchasePrice": 0, | ||
| 557 | + "salesPrice": 0, | ||
| 558 | + "shopId": 0, | ||
| 559 | + "shopName": "", | ||
| 560 | + "sizeId": 0, | ||
| 561 | + "sizeName": "", | ||
| 562 | + "smallSortId": 0, | ||
| 563 | + "smallSortName": "", | ||
| 564 | + "status": "3", | ||
| 565 | + "storageAmount": 11, | ||
| 566 | + "storeNums": 13 | ||
| 567 | + }, | ||
| 568 | + { | ||
| 569 | + "brandId": 11, | ||
| 570 | + "brandName": "", | ||
| 571 | + "colorId": 0, | ||
| 572 | + "colorName": "", | ||
| 573 | + "dateId": 0, | ||
| 574 | + "goodsName": "", | ||
| 575 | + "imageUrl": "0", | ||
| 576 | + "maxSortId": 0, | ||
| 577 | + "maxSortName": "0", | ||
| 578 | + "middleSortId": 0, | ||
| 579 | + "middleSortName": "", | ||
| 580 | + "productSkc": 0, | ||
| 581 | + "productSkn": 0, | ||
| 582 | + "productSku": 0, | ||
| 583 | + "purchasePrice": 0, | ||
| 584 | + "salesPrice": 0, | ||
| 585 | + "shopId": 0, | ||
| 586 | + "shopName": "", | ||
| 587 | + "sizeId": 0, | ||
| 588 | + "sizeName": "", | ||
| 589 | + "smallSortId": 0, | ||
| 590 | + "smallSortName": "", | ||
| 591 | + "status": "2", | ||
| 592 | + "storageAmount": 1, | ||
| 593 | + "storeNums": 1 | ||
| 594 | + } | ||
| 595 | + ], | ||
| 596 | + "page": 1, | ||
| 597 | + "size": 10, | ||
| 598 | + "total": 4, | ||
| 599 | + "totalPage": 1 | ||
| 600 | + }, | ||
| 601 | + "md5": "83ccbb2eb14e08c90558b7c00d6c0b8e", | ||
| 602 | + "message": "storage statistics list" | ||
| 603 | +} | ||
| 604 | +} | ||
| 605 | +``` | ||
| 606 | + | ||
| 607 | +## 7、获取店铺的经营指标：一个自然日内有效订单商品件数、有效订单商品 金额## | ||
| 608 | + | ||
| 609 | +获取店铺的经营指标：一个自然日内有效订单商品件数、有效订单商品 金额（method=app.shops.shopbusinessoverview） | ||
| 610 | +#### 公共请求参数 | ||
| 611 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 612 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 613 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 614 | +|app_version|float|10|否|1||APP版本| | ||
| 615 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 616 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 617 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 618 | + | ||
| 619 | +#### 请求参数 | ||
| 620 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 621 | +|:-------| -----:|-----:|-----:|----:| | ||
| 622 | +|brandId|int|否||品牌id| | ||
| 623 | +|dateId |int|否||日期| | ||
| 624 | + | ||
| 625 | + | ||
| 626 | +注意，通用的头部没有列出。 | ||
| 627 | +请求示例 | ||
| 628 | +http://192.168.102.217:8080/gateway?method=app.shops.shopbrandrank&brandId=1200&dateId=20160524 | ||
| 629 | + | ||
| 630 | + | ||
| 631 | +### 响应 | ||
| 632 | +code为200即为成功，否则是失败。 | ||
| 633 | +响应JSON格式如下所示: | ||
| 634 | +``` json | ||
| 635 | +{ | ||
| 636 | + "alg": "SALT_MD5", | ||
| 637 | + "code": 200, | ||
| 638 | + "data": { | ||
| 639 | + "brandId": 1200, | ||
| 640 | + "brandName": "wss", | ||
| 641 | + "buyNumbers": 100, | ||
| 642 | + "dateId": 20160523, | ||
| 643 | + "orderAmount": 100, | ||
| 644 | + "shopId": 431, | ||
| 645 | + "shopName": "wss" | ||
| 646 | + }, | ||
| 647 | + "md5": "1d143fd1d71504f9d7a82121202c4bfc", | ||
| 648 | + "message": "shop business overview." | ||
| 649 | +} | ||
| 650 | + | ||
| 651 | +``` | ||
| 652 | + | ||
| 653 | +## 8、对账结算## | ||
| 654 | + | ||
| 655 | +查询销售统计报表（method=app.shops.balance） | ||
| 656 | +#### 公共请求参数 | ||
| 657 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
| 658 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
| 659 | +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息| | ||
| 660 | +|app_version|float|10|否|1||APP版本| | ||
| 661 | +|os_version|string|20|否|Android4.4||系统版本+机器型号| | ||
| 662 | +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）| | ||
| 663 | +|screen_size|string|20|否|800x900||（手机尺寸）| | ||
| 664 | + | ||
| 665 | +#### 请求参数 | ||
| 666 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 | | ||
| 667 | +|:-------| -----:|-----:|-----:|----:| | ||
| 668 | +|page|int|是|2|第几页| | ||
| 669 | +|size|int|是|10|每页条数| | ||
| 670 | +|shopId|int|否|17|是|店铺ID | | ||
| 671 | +|brandId|int|否|17|是|品牌 | | ||
| 672 | + | ||
| 673 | +注意，通用的头部没有列出。 | ||
| 674 | +请求示例 | ||
| 675 | +http://192.168.102.217:8080/gateway?method=app.shops.balance | ||
| 676 | + | ||
| 677 | +## 请求样例数据 | ||
| 678 | +```json | ||
| 679 | +{ | ||
| 680 | + "page": 1, | ||
| 681 | + "size": 2 | ||
| 682 | +} | ||
| 683 | +``` | ||
| 684 | + | ||
| 685 | +### 响应 | ||
| 686 | +code为200即为成功，否则是失败。 | ||
| 687 | +响应JSON格式如下所示: | ||
| 688 | +```json | ||
| 689 | +{ | ||
| 690 | + "alg": "SALT_MD5", | ||
| 691 | + "code": 200, | ||
| 692 | + "data": { | ||
| 693 | + "additionInfo": { | ||
| 694 | + "allAmountRate": 2977817.56,//累计结算金额 | ||
| 695 | + }, | ||
| 696 | + "list": [ | ||
| 697 | + { | ||
| 698 | + "brandId": 144,//品牌ID | ||
| 699 | + "brandName": "VANS", //品牌 | ||
| 700 | + "dateId": 1,//生成日期 | ||
| 701 | + "stateId": 2,//状态 | ||
| 702 | + "orderAmount": 665,//金额 | ||
| 703 | + } | ||
| 704 | + ], | ||
| 705 | + "page": 1, | ||
| 706 | + "size": 10, | ||
| 707 | + "total": 14612, | ||
| 708 | + "totalPage": 1462 | ||
| 709 | + }, | ||
| 710 | + "md5": "ce4964c1e6defece5035c81b63c3c51d", | ||
| 711 | + "message": "getOrdersGoodsRptList result" | ||
| 712 | + } | ||
| 713 | +``` | ||
| 714 | + | ||
| 715 | +```json | ||
| 716 | + { | ||
| 717 | + "code": 405, | ||
| 718 | + "data": [], | ||
| 719 | + "md5": "d751713988987e9331980363e24189ce", | ||
| 720 | + "message": "getOrdersGoodsRptList" | ||
| 721 | + } | ||
| 722 | +``` |
-
Please register or login to post a comment