添加一个商品折扣

接口描述：

  • 添加一个商品折扣。

请求 URL：

  • http|https://host/api/v1/discount/method/add.discount.item/

请求方式：

  • GET
  • POST

是否授权：

  • 需要授权

业务参数：

参数名 类型 是否必须 范围值 默认值 示例值 描述
name string 是 max:100 端午促销 折扣名称
type integer 是 in:0,1,2,3 0 折扣方式，详见附属 A
begin_time datetime 是 date 2018-05-24 23:00:00 折扣开始时间
end_time datetime 是 date 2018-06-24 23:00:00 折扣结束时间
status integer 否 in:0,1 1 1 折扣状态 0=禁用 1=启用
discount_goods array 是 min[]:1 见附属 B 折扣商品

附属 A： 0=打折 1=减价 2=固定价格 3=送优惠劵

附属 B 类型 是否必须 范围值 默认值 示例值 描述
goods_id integer 是 gt:0 13 折扣商品编号
discount number 是 gt:0 50 折扣商品折扣额

示例 B:

  1. [
  2.     {
  3.         "goods_id": 13,
  4.         "discount": 50
  5.     },
  6.     {
  7.         "goods_id": 4,
  8.         "discount": 65
  9.     }
  10. ]

响应参数：

参数名 类型 是否返回 示例值 描述
status integer 是 200 状态码
message string 是 success 消息信息
data object 是 [] 返回对象
data 类型 是否返回 示例值 描述
name string 是 端午促销 折扣名称
type integer 是 0 折扣方式，详见附属 A
begin_time datetime 是 2018-05-24 23:00:00 折扣开始时间
end_time datetime 是 2018-06-24 23:00:00 折扣结束时间
status integer 否 1 折扣状态 0=禁用 1=启用
discount_goods array 是 [] 折扣商品数组
discount_id integer 是 38 折扣编号
discount_goods 类型 是否返回 示例值 描述
goods_id integer 是 4 折扣商品编号
discount number 是 65 折扣商品折扣额

响应示例：

  1. {
  2.   "status": 200,
  3.   "message": "success",
  4.   "data": {
  5.     "name": "端午促销",
  6.     "type": 0,
  7.     "begin_time": "2018-05-24 23:00:00",
  8.     "end_time": "2018-06-24 23:00:00",
  9.     "status": 1,
  10.     "discount_goods": [
  11.       {
  12.         "goods_id": 13,
  13.         "discount": 50
  14.       },
  15.       {
  16.         "goods_id": 4,
  17.         "discount": 65
  18.       }
  19.     ],
  20.     "discount_id": 38
  21.   }
  22. }

备注:

  1. 每一个商品都可以有单独的折扣额。

  2. 参数type对应不同的值时，其discount_goods下的discount字段实际作用会有很大不同。

    • 当type=0时表示discount的作用是打折额度，比如65表示按6.5折结算。
    • 当type=1时表示discount的作用是减多少额度，比如65表示在原价的基础上减去65。
    • 当type=2时表示discount的作用是固定价格，比如65则按65的价格结算。
    • 当type=3时表示discount的作用是赠送的优惠劵编号，订单完成后送coupon_id=65的优惠劵给顾客。