匡佳华 / API-Interfaces · Commits

Go to a project

Authored by 马力
Commit 88824f9509c62815dc479bcf9ed1dec71bd6a222 1 parent 4599e0e1

商家端报表接口

Inline Side-by-side
Showing 2 changed files with 312 additions and 0 deletions
  1 +## 1、查询销售统计报表##
  2 +
  3 +查询销售统计报表（/seller/getOrdersGoodsRptList）
  4 +
  5 +#### 请求参数
  6 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 |
  7 +|:-------| -----:|-----:|-----:|----:|
  8 +|page|int|是|2|第几页|
  9 +|size|int|是|10|每页条数|
  10 +|type|int|否|1|1 日 2 周 3 月|
  11 +|reqTime|int|type为1或者3必填|日报示例20160521 月报示例 201605|日报或者月报日期, 周报则通过以下两个字段传入|
  12 +|beginTime|string|type为2必传|20160521|周报：开始日期|
  13 +|endTime|string|type为2必传|20160527|周报：结束日期|
  14 +|productSkn|long|是|1222|skn|
  15 +|productSkc|long|是|1222|skc|
  16 +|productSku|long|是|1222|sku|
  17 +|factoryCode|string|是|234234|厂家编号|
  18 +|sortId|int|是|12|产品分类 最小的分类ID 如果用户只筛选一级品类传一级品类ID 如果用户筛选到二级品类传入二级品类ID，以此类推 |
  19 +|shopsId|int|否|17|店铺ID |
  20 +
  21 +注意，通用的头部没有列出。
  22 +请求示例
  23 +http://192.168.102.210:8088/platform/seller/getOrdersGoodsRptList
  24 +
  25 +``` json
  26 +请求样例：
  27 +{
  28 +"beginTime": "20160516",
  29 +"endTime": "20160528",
  30 +"type":2
  31 +}
  32 +正常返回：
  33 +{
  34 + "alg": "SALT_MD5",
  35 + "code": 200,
  36 + "data": {
  37 + "additionInfo": {
  38 + "allAmount": 2977818.56,//订单商品金额
  39 + "allAmountRate": 29.56,//环比 乘100后的数据 页面直接用此数字后面加上%
  40 + "allAmountRateFlag":true //是否有环比值 true 是 false 否
  41 + "allNumber": 14747,//订单商品总数
  42 + "allNumberRate": 14//环比 乘100后的数据 页面直接用此数字后面加上%
  43 + "allNumberRateFlag":true //是否有环比值 true 是 false 否
  44 + "lastAllAmount": 2977323.78,//上期金额总数
  45 + "lastAllNumber": 14746//上期商品总数
  46 + },
  47 + "list": [
  48 + {
  49 + "allAmounts": 2970434.16,//汇总金额
  50 + "allNums": 14731,//汇总商品数
  51 + "dateId": "20160518"//日期
  52 + },
  53 + {
  54 + "allAmounts": 295.04,
  55 + "allNums": 4,
  56 + "dateId": "20160525"
  57 + }
  58 + ],
  59 + "page": 0,
  60 + "size": 0,
  61 + "total": 0,
  62 + "totalPage": 0
  63 + },
  64 + "md5": "6bed08aeaa2b44e6238f889d007c358d",
  65 + "message": "getOrdersGoodsRptForApi result"
  66 +}
  67 +
  68 +{
  69 + "alg": "SALT_MD5",
  70 + "code": 200,
  71 + "data": {
  72 + "additionInfo": {
  73 + "allAmount": 2977818.56,//订单商品金额
  74 + "allAmountRate": 29.56,//环比 乘100后的数据 页面直接用此数字后面加上%
  75 + "allAmountRateFlag":true //是否有环比值 true 是 false 否
  76 + "allNumber": 14747,//订单商品总数
  77 + "allNumberRate": 14//环比 乘100后的数据 页面直接用此数字后面加上%
  78 + "allNumberRateFlag":true //是否有环比值 true 是 false 否
  79 + "lastAllAmount": 2977323.78,//上期金额总数
  80 + "lastAllNumber": 14746//上期商品总数
  81 + },
  82 + "list": [
  83 + {
  84 + "factoryCode": "厂家编号",
  85 + "colorName": "红色",
  86 + "sizeId": 12,
  87 + "smallSortId": 114,
  88 + "buyNumber": 12, // 数量
  89 + "colorId": 1,
  90 + "salesPrice": 22.33,
  91 + "maxSortId": 1,
  92 + "productSku": 2027406,
  93 + "orderAmount": 121.33, // 金额
  94 + "hour": 8,
  95 + "sizeName": "XL",
  96 + "smallSortName": "小分类",
  97 + "imageUrl": "http://img10.static.yhbimg.com/goodsimg/2017/05/03/18/011ccd8e9165f042754a34ffd937cd7659.jpg", // 图片的绝对路径
  98 + "dateId": 20170504,
  99 + "productSkn": 512588002,
  100 + "shopId": 792,
  101 + "goodsName": "商品名称",
  102 + "maxSortName": "大分类",
  103 + "productSkc": 680588,
  104 + "brandName": "Nike",
  105 + "middleSortId": 14,
  106 + "brandId": 748,
  107 + "middleSortName": "中分类",
  108 + "retailPrice": 22.22
  109 + },
  110 + {
  111 + "factoryCode": "厂家编号",
  112 + "colorName": "红色",
  113 + "sizeId": 12,
  114 + "smallSortId": 114,
  115 + "buyNumber": 12,
  116 + "colorId": 1,
  117 + "salesPrice": 22.33,
  118 + "maxSortId": 1,
  119 + "productSku": 2027406,
  120 + "orderAmount": 121.33,
  121 + "hour": 8,
  122 + "sizeName": "XL",
  123 + "smallSortName": "小分类",
  124 + "imageUrl": "",
  125 + "dateId": 20170504,
  126 + "productSkn": 512588002,
  127 + "shopId": 792,
  128 + "goodsName": "商品名称",
  129 + "maxSortName": "大分类",
  130 + "productSkc": 680588,
  131 + "brandName": "Nike",
  132 + "middleSortId": 14,
  133 + "brandId": 748,
  134 + "middleSortName": "中分类",
  135 + "retailPrice": 22.22
  136 + }
  137 + ],
  138 + "page": 1,
  139 + "size": 10,
  140 + "total": 1,
  141 + "totalPage": 1
  142 + },
  143 + "md5": "cba04123ab80e44c69c53f7dd41c1756",
  144 + "message": "getOrdersGoodsRptList result"
  145 +}
  146 +
  147 +
  148 +异常返回：
  149 +{
  150 + "code": 405,
  151 + "data": [],
  152 + "md5": "d751713988987e9331980363e24189ce",
  153 + "message": "getOrdersGoodsRptForApi"
  154 +}
  155 +
  156 +```
  1 +## 1、查询销售统计报表##
  2 +
  3 +查询销售统计报表（/seller/getOrdersGoodsRptList）
  4 +
  5 +#### 请求参数
  6 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 |
  7 +|:-------| -----:|-----:|-----:|----:|
  8 +|page|int|是|2|第几页|
  9 +|size|int|是|10|每页条数|
  10 +|type|int|否|1|1 日 2 周 3 月|
  11 +|reqTime|int|type为1或者3必填|日报示例20160521 月报示例 201605|日报或者月报日期, 周报则通过以下两个字段传入|
  12 +|beginTime|string|type为2必传|20160521|周报：开始日期|
  13 +|endTime|string|type为2必传|20160527|周报：结束日期|
  14 +|productSkn|long|是|1222|skn|
  15 +|productSkc|long|是|1222|skc|
  16 +|productSku|long|是|1222|sku|
  17 +|factoryCode|string|是|234234|厂家编号|
  18 +|sortId|int|是|12|产品分类 最小的分类ID 如果用户只筛选一级品类传一级品类ID 如果用户筛选到二级品类传入二级品类ID，以此类推 |
  19 +|shopsId|int|否|17|店铺ID |
  20 +
  21 +注意，通用的头部没有列出。
  22 +请求示例
  23 +http://192.168.102.210:8088/platform/seller/getOrdersGoodsRptList
  24 +
  25 +``` json
  26 +请求样例：
  27 +{
  28 +"beginTime": "20160516",
  29 +"endTime": "20160528",
  30 +"type":2
  31 +}
  32 +正常返回：
  33 +{
  34 + "alg": "SALT_MD5",
  35 + "code": 200,
  36 + "data": {
  37 + "additionInfo": {
  38 + "allAmount": 2977818.56,//订单商品金额
  39 + "allAmountRate": 29.56,//环比 乘100后的数据 页面直接用此数字后面加上%
  40 + "allAmountRateFlag":true //是否有环比值 true 是 false 否
  41 + "allNumber": 14747,//订单商品总数
  42 + "allNumberRate": 14//环比 乘100后的数据 页面直接用此数字后面加上%
  43 + "allNumberRateFlag":true //是否有环比值 true 是 false 否
  44 + "lastAllAmount": 2977323.78,//上期金额总数
  45 + "lastAllNumber": 14746//上期商品总数
  46 + },
  47 + "list": [
  48 + {
  49 + "allAmounts": 2970434.16,//汇总金额
  50 + "allNums": 14731,//汇总商品数
  51 + "dateId": "20160518"//日期
  52 + },
  53 + {
  54 + "allAmounts": 295.04,
  55 + "allNums": 4,
  56 + "dateId": "20160525"
  57 + }
  58 + ],
  59 + "page": 0,
  60 + "size": 0,
  61 + "total": 0,
  62 + "totalPage": 0
  63 + },
  64 + "md5": "6bed08aeaa2b44e6238f889d007c358d",
  65 + "message": "getOrdersGoodsRptForApi result"
  66 +}
  67 +
  68 +{
  69 + "alg": "SALT_MD5",
  70 + "code": 200,
  71 + "data": {
  72 + "additionInfo": {
  73 + "allAmount": 2977818.56,//订单商品金额
  74 + "allAmountRate": 29.56,//环比 乘100后的数据 页面直接用此数字后面加上%
  75 + "allAmountRateFlag":true //是否有环比值 true 是 false 否
  76 + "allNumber": 14747,//订单商品总数
  77 + "allNumberRate": 14//环比 乘100后的数据 页面直接用此数字后面加上%
  78 + "allNumberRateFlag":true //是否有环比值 true 是 false 否
  79 + "lastAllAmount": 2977323.78,//上期金额总数
  80 + "lastAllNumber": 14746//上期商品总数
  81 + },
  82 + "list": [
  83 + {
  84 + "factoryCode": "厂家编号",
  85 + "colorName": "红色",
  86 + "sizeId": 12,
  87 + "smallSortId": 114,
  88 + "buyNumber": 12, // 数量
  89 + "colorId": 1,
  90 + "salesPrice": 22.33,
  91 + "maxSortId": 1,
  92 + "productSku": 2027406,
  93 + "orderAmount": 121.33, // 金额
  94 + "hour": 8,
  95 + "sizeName": "XL",
  96 + "smallSortName": "小分类",
  97 + "imageUrl": "http://img10.static.yhbimg.com/goodsimg/2017/05/03/18/011ccd8e9165f042754a34ffd937cd7659.jpg", // 图片的绝对路径
  98 + "dateId": 20170504,
  99 + "productSkn": 512588002,
  100 + "shopId": 792,
  101 + "goodsName": "商品名称",
  102 + "maxSortName": "大分类",
  103 + "productSkc": 680588,
  104 + "brandName": "Nike",
  105 + "middleSortId": 14,
  106 + "brandId": 748,
  107 + "middleSortName": "中分类",
  108 + "retailPrice": 22.22
  109 + },
  110 + {
  111 + "factoryCode": "厂家编号",
  112 + "colorName": "红色",
  113 + "sizeId": 12,
  114 + "smallSortId": 114,
  115 + "buyNumber": 12,
  116 + "colorId": 1,
  117 + "salesPrice": 22.33,
  118 + "maxSortId": 1,
  119 + "productSku": 2027406,
  120 + "orderAmount": 121.33,
  121 + "hour": 8,
  122 + "sizeName": "XL",
  123 + "smallSortName": "小分类",
  124 + "imageUrl": "",
  125 + "dateId": 20170504,
  126 + "productSkn": 512588002,
  127 + "shopId": 792,
  128 + "goodsName": "商品名称",
  129 + "maxSortName": "大分类",
  130 + "productSkc": 680588,
  131 + "brandName": "Nike",
  132 + "middleSortId": 14,
  133 + "brandId": 748,
  134 + "middleSortName": "中分类",
  135 + "retailPrice": 22.22
  136 + }
  137 + ],
  138 + "page": 1,
  139 + "size": 10,
  140 + "total": 1,
  141 + "totalPage": 1
  142 + },
  143 + "md5": "cba04123ab80e44c69c53f7dd41c1756",
  144 + "message": "getOrdersGoodsRptList result"
  145 +}
  146 +
  147 +
  148 +异常返回：
  149 +{
  150 + "code": 405,
  151 + "data": [],
  152 + "md5": "d751713988987e9331980363e24189ce",
  153 + "message": "getOrdersGoodsRptForApi"
  154 +}
  155 +
  156 +```