coupons.md 14.5 KB

Raw Blame History Permalink



优惠券列表

 请求路径  /coupon/queryCouponList
 POST 请求


编码
含义
必填
说明


couponId
券ID
否
Integer类型


couponName
券名称
否
String类型


department
部门
否
Integer（1:渠道二部, 2:渠道一部, 3:零售部 4:品牌资源部 5:店铺运营部  6:类目运营部  7:营销部  8:市场部 9:会员部 10:客服部  11:内容营销部)


status
状态
否
Integer(-1：已过期 0:待审核 1:已通过 2:驳回 3:已作废)


page
页
否
Integer类型


size
页大小
否
Integer类型


响应：

{
  "code": 200,
  "data": {
"list": [
  {
"activityLimit": 0,
"brandLimit": "",
"couponAmount": 123.01,
"couponCode": "",
"couponName": "3456",
"couponNum": 3,
"couponType": 1,
"couponUseNum": 0,
"createTime": 1464690537,
"department": 4,
"endTime": 1464321300,
"explains": "356",
"getLimit": 1,
"id": 13106,
"invalidReason": "",
"isAll": "N",
"isNew": 1,
"isProductLimit": "N",
"options": [
  3
],
"pid": 100169,
"productLimit": "",
"proposer": "wxtest1",
"rejectReason": "3452",
"sortLimit": "",
"startTime": 1464659100,
"status": 2,
"useLimit": 3456,
"useLimitType": 1,
"useNum": 3
  }
],
"page": 1,
"size": 1,
"total": 3,
"totalPage": 3
  },
  "md5": "830bca3b51e11cc153bff1c09d1e4269",
  "message": "操作成功"
}


说明：options 可进行的操作列表：1, "审核通过" ，0, "驳回" 2, "查看详情"  3, "修改"  4, "作废"
     status  0:待审核   1:通过     2:驳回   3:作废

 id:优惠券ID   startTime:开始时间  endTime:结束时间
 couponName:名称   couponType:类型 （1:A券 2:B券 3:公开券 4:生日券 5:免邮券）  couponAmount 优惠金额  couponNum：优惠券数量
 department：部门（1:渠道二部, 2:渠道一部, 3:零售部 4:品牌资源部 5:店铺运营部 6:类目运营部 7:营销部 8:市场部 9:会员部 10:客服部 11:内容营销部)  
 explains：说明  proposer:申请人  status:状态（0：待审核，1：有效  2：驳回 3：作废  ）
 rejectReason:驳回原因   invalidReason：作废原因


老部门对应关系


部门名称
部门ID


渠道二部
1


渠道一部
2


零售部
3


品牌资源部
4


店铺运营部
5


类目运营部
6


营销部
7


市场部
8


会员部
9


客服部
10


内容营销部
11


新部门对应关系 


部门名称
部门ID


资源发展部
20


广告部
21


招商部
22


男生媒体部
23


女生媒体部
24


流程运营部
25


发行设计部
26


设计部
27


商品一部（羊头+轻奢）
28


商品二部（男装）
29


商品三部（女装）
30


商品四部（户外运动）
31


商品五部（自主）
32


商品六部（明星/KOL）
33


商品七部（童装）
34


商品八部（创意生活+玩具）
35


商品九部（彩妆）
36


商品十部（全球购）
37


运营支持部
38


类目及活动运营部
39


内容运营部
40


营销策划部
41


设计部
42


售后服务部
43


客户关系部
44


运营部
45


泛渠道部
46


运营统筹部
47


南京艾尚店
48


仓储部
49


物流部
50


运营部
51


公关部
52


运营部
53


生产部
54


商品部
55


销售部
56


市场部
57


运营部
58


人事部
59


财务部
60


陈列部
61


会员数据部
62


会员营销部
63


会员运营部
64


品牌营销部
65


效果营销部
66


PR营销部
67


设计部
68


零售产品部
69


媒体产品部
70


设计部
71


前端系统部
72


核心系统部
73


后台系统部
74


测试部
75


研究发展部
76


大数据部
77


运维部
78


财务部
79


内审部
80


行政部
81


数据部
82


公共关系部
83


人力资源部
84


总裁办
85


火星项目部
86


优惠券详细信息接口

  请求路径 coupon/getCouponDetailById
  POST请求 JSON


请求参数


编码
含义
必填
说明


couponsId
券ID
是
Integer类型


请求示例：

{
"couponId":13054
}


响应：

{
  "code": 200,
  "data": {
"activityLimit": 0,
"brandLimit": "571,1209",
"brandsIdName": [
  {
"id": "1209",
"text": "AAVA Lifestyle"
  },
  {
"id": "571",
"text": "A QUESTION OF"
  }
],
"couponAmount": 12,
"couponCode": "",
"couponName": "JMtest222",
"couponNum": 12,
"couponType": 5,
"couponUseNum": 0,
"createTime": 1464244165,
"customType": "1,2,3,4",
"department": 11,
"endTime": 1464659100,
"explains": "12",
"getLimit": 1,
"id": 13054,
"invalidReason": "",
"isAll": "N",
"isNew": 1,
"isProductLimit": "N",
"options": [
  1,
  0,
  2
],
"pid": 0,
"productLimit": "",
"proposer": "",
"rejectReason": "qawer",
"sortLimit": "1,11,13,3,28",
"sortList": [
  [
{
  "id": 1,
  "sortName": "上衣"
},
{
  "id": 11,
  "sortName": "T恤"
}
  ],
  [
{
  "id": 1,
  "sortName": "上衣"
},
{
  "id": 13,
  "sortName": "POLO"
}
  ],
  [
{
  "id": 3,
  "sortName": "裤装"
},
{
  "id": 28,
  "sortName": "短裤"
}
  ]
],
"startTime": 1464659100,
"status": 0,
"useLimit": 121,
"useLimitType": 2,
"useNum": 12
  },
  "md5": "faab0af1c130fb181c68263bd904be8d",
  "message": "操作成功"
}

说明： sortList 物理类目    brandsIdName:品牌ID及名称列表


驳回

请求路径  coupon/reject

POST请求 Json


请求参数：


编码
含义
必填
说明


couponId
券ID
是
Integer类型


rejectReason
驳回理由
是
String类型


请求示例：

{
"couponId":13020,
"rejectReason":"今天心情好"
}


响应:

 {
  "code": 200,
  "data": [],
  "md5": "d751713988987e9331980363e24189ce",
  "message": "success"
}


通过

请求路径  coupon/approve

POST请求 Json


请求参数：


编码
含义
必填
说明


couponId
券ID
是
Integer类型


请求示例：

{
"couponId":13020
}


响应Json:

 {
  "code": 200,
  "data": [],
  "md5": "d751713988987e9331980363e24189ce",
  "message": "success"
}


作废

 请求路径 coupon/invalid

POST请求 Json


请求参数：


编码
含义
必填
说明


couponId
券ID
是
Integer类型


invalidReason
作废理由
是
String类型


请求示例：

{
"couponId":13020
}


响应Json:

 {
  "code": 200,
  "data": [],
  "md5": "d751713988987e9331980363e24189ce",
  "message": "success"
}


新建/编辑

 请求路径 coupon/addOrUpdate
 POST请求  JSON


请求参数


编码
含义
必填
说明


id
券ID
修改必填，新建可不填
Integer类型


couponType
券类型
新建必填，修改可不填
Integer类型，1:A券 2:B券 3:公开券 4:生日券 5:免邮券


couponName
券名称
新建必填，修改可不填
String


couponNum
数量
新建必填，修改可不填
Integer类型


useNum
使用次数
新建必填，修改可不填（只有公开券有意义,其他券没意义）
Integer类型


department
申请部门
新建必填，修改可不填
1:渠道二部, 2:渠道一部, 3:零售部 4:品牌资源部 5:店铺运营部 6:类目运营部  7:营销部  8:市场部 9:会员部 10:客服部  11:内容营销部


startTime
开始时间
新建必填，修改可不填
String,"yyyy-MM-dd HHss"


endTime
结束时间
新建必填，修改可不填
String,"yyyy-MM-dd HHss"


explains
说明
新建必填，修改可不填
String


useLimitType
限制条件
新建必填，修改可不填
Integer 0:无限制  1:货物件数限制 2:订单金额限制


useLimit
限制值
新建必填，修改可不填
Integer


couponAmount
面额
新建必填，修改可不填
Decimal(10,2)


brandLimit
限定品牌
非必填，以“,”分割
String


sortLimit
限定分类
非必填，以”,“分割
String


customType
会员身份
非必填,以","分割
String 1:新客户 2:银卡会员 3:金卡会员 4:白金卡会员 5:普通用户(不含新客) 9:学生用户


请求示例：

 {
    "couponName":"new_test1",
    "couponNum":100,
    "useLimitType":0,
    "useLimit":1,
    "department":1,
    "startTime":"2016-05-19 00:00:00",
    "endTime":"2016-05-29 23:59:59",
    "couponAmount":10,
    "couponType":1
}


响应：

{
  "code": 200,
  "data": [],
  "md5": "d751713988987e9331980363e24189ce",
  "message": "操作成功"
}


查询品牌列表

 请求路径  erpproduct/brands/getBrandNames
 请求类型  POST JSON


请求参数


编码
含义
必填
说明


idName
品牌名称
否
String


status
状态
否
1:有效 0:无效


请求示例：

{"idName":"新品牌"}


响应：

{
  "code": 200,
  "data": [
{
  "id": "1676",
  "text": "新品牌"
}
  ],
  "message": "操作成功"
}*


发券管理列表查询

 请求路径  coupon/querySendCouponList
 请求类型 POST JSON


请求参数：


编码
含义
必填
说明


couponType
券类型
否
Integer 1:A券 2:B券 3:公开券 4:生日券 5:免邮券


couponId
券ID
否
Integer类型


couponName
券名称
否
String类型


department
部门
否
Integer（1:渠道二部, 2:渠道一部, 3:零售部 4:品牌资源部 5:店铺运营部  6:类目运营部  7:营销部  8:市场部 9:会员部 10:客服部  11:内容营销部)


page
页
否
Integer类型


size
页大小
否
Integer类型


startTimeStr
开始时间
否
String "yyyy-MM-dd HHss"


endTimeStr
结束时间
否
String "yyyy-MM-dd HHss"


请求示例：

  {"page":1,"size":1}


响应:

{
  "code": 200,
  "data": {
"list": [
  {
"brandLimit": "",
"couponAmount": 100,
"couponName": "新客品类券",
"couponNum": 1000,
"couponType": 1,
"createTime": 1463480682,
"customType": "",
"department": 1,
"endTime": 1464690480,
"getLimit": 1,
"id": 13006,
"isNew": 0,
"options": [
  1,
  2,
  3
],
"proposer": "",
"sortLimit": "",
"startTime": 1463480880,
"status": 1,
"useLimit": 0,
"useLimitType": 0
  }
],
"page": 1,
"size": 1,
"total": 7928,
"totalPage": 7928
  },
  "md5": "1cc356fcf01c6b5108082ac5c5d526da",
  "message": "操作成功"
}


 说明：options 1：发券  2：发放记录  3：使用记录  4：查看券号


手工发券

 请求路径  /coupon/sendCoupon
 类型  POST JSON


请求参数：


编码
含义
必填
说明


couponId
券ID
是
优惠券ID


uids
用户ID列表
是
用户ID列表，以","分割


请求示例：

 {"uids":"1111,222","couponId":12991}


响应：

   {
  "code": 200,
  "data": [
{
  "couponId": 12991,
  "errMsg": "优惠券已经领取",
  "flag": false,
  "uid": 1111
},
{
  "couponId": 12991,
  "errMsg": "优惠券已经领取",
  "flag": false,
  "uid": 222
}
  ],
  "md5": "c3231d288aa94f74574f1cd2734a35ee",
  "message": "操作成功"
}

说明：因为可能会部分失败，部分成功（返回的具体信息在data中，flag:false标示失败）。


文件上传发券

 请求地址：couponSendFile/upload
 请求类型 POST  multipart/form-data


请求参数


编码
含义
必填
说明


file
文件
是
二进制文件.txt类型


couponId
券ID
是
Integer类型


响应：

{
  "code": 200,
  "data": [],
  "md5": "d751713988987e9331980363e24189ce",
  "message": "upload success"
}


查询文件发券列表

 请求路径 /couponSendInfo/getListByCouponId

  GET 请求


请求参数：


编码
含义
必填
说明


couponId
券ID
是
Integer类型


 响应:

{
  "code": 200,
  "data": [
{
  "couponId": 11319,
  "createTime": 1430106096,
  "fileUrl": "http://img01.static.yohobuy.com/yohobuyzip/2015/04/27/11/010f5ad08b5bbeb9726e3a16a6feacd4a8.txt",
  "id": 5007,
  "pid": 34,
  "status": 2
},
{
  "couponId": 11319,
  "createTime": 1430106116,
  "fileUrl": "http://img01.static.yohobuy.com/yohobuyzip/2015/04/27/11/01c6149c5933fabca7a8780543ace17a42.txt",
  "id": 5009,
  "pid": 34,
  "status": 2
}
  ],
  "md5": "abe738f0055dd3acd579d99cab9e7742",
  "message": "操作成功"
}

说明:status:0 未开始发放  status:1  正在发放  status:2 已发放


文件上传重发

 请求路径 /couponSendInfo/sendAgainById

 POST 请求 


请求参数：


编码
含义
必填
说明


id
id
是
Integer类型


响应
{
  "code": 200,
  "md5": "abe738f0055dd3acd579d99cab9e7742",
  "message": "操作成功"
}