创建优惠券模板-CreateCouponTemplate
功能概述
用于创建优惠券模板。
请求参数
名称 | 类型 | 必填 | 示例 | 说明 |
Name | string | 是 | 模板测试 | t_name 模板名称 |
UseScene | string | 是 | OPERATIONAL |
|
Reason | string | 是 | 测试使用 | 申请原因 |
UniversalType | string | 是 | UNIVERSAL |
|
CouponType | string | 是 | VOUCHER |
|
UsageCount | integer | 是 | 0 | 优惠券使用次数 , 0表示无限制 |
CouponAmount | number | 是 | 100 | yh_amount 生成券的面额(单位:元) |
DiscountRate | number | 是 | 0.8 | 折扣, 如: 0.75 取值范围(0, 1) |
ControlType | string | 是 | AMOUNT |
|
MaxRelease | number | 是 | 100 | 优惠券允许发放的数量 |
PerLimitNum | integer | 是 | 1 | 每人限领数量 |
ValidityType | string | 是 | RELATIVE |
|
CouponStartTime | string | 是 | 1577851200 | 优惠券开始时间 yhValidityType=ABSOLUTE 不能为空 需要将时间转换成Long类型的时间戳如:“2020-01-01 12:00:00">1577851200 |
CouponEndTime | string | 是 | 1577851200 | 有效期结束时间, yhValidityType=ABSOLUTE 不能为空 需要将时间转换成Long类型的时间戳如:“2020-01-01 12:00:00">1577851200 |
RelativeSecond | integer | 否 | 10 | 有效时间——相对(单位秒),如果starttime为空,优惠券的有效期从生成的当天开始计算, 如果starttime不为空,优惠关的有效期从start_time开始算 |
Description | string | 否 | 测试 | 优惠条件备注,显示用 |
StartTime | string | 否 | 1577851200 | 模板有效开始时间 需要将时间转换成Long类型的时间戳如:“2020-01-01 12:00:00"->1577851200 |
EndTime | string | 否 | 1577851200 | 模板有效结束时间 需要将时间转换成Long类型的时间戳如:“2020-01-01 12:00:00"->1577851200 |
CertainMoney | number | 否 | 200 | 满减条件金额(单位:元), 如满200 |
Operator | string | 是 | 操作人, 系统操作为应用名, 员工操作设置为工号 | |
SellerId | integer | 是 | 123123563464 | 优惠券发放人 : 伙伴自身UID |
ItemCodeSet | array | 否 | 商品规格CODE。 限定商品类型时, 适用的商品集合, 通用券(yhUniversalType=NONUNIVERSAL)不能为空 | |
string | 否 | ecs | 商品规格code | |
OrderTypeSet | array | 否 | 优惠券支持的订单类型
| |
string | 否 | 1 | 订单类型 | |
ExtendsMap | map | 否 | 扩展字段 | |
Type | string | 是 | APPLY | 模板申请类型: APPLY 模板转正自动发放券 |
Site | string | 是 | CHINA | 适用站点:
|
UserPkAmount | string | 是 | 12341234,100 | 申请人UID和金额, 用逗号(半角)分隔, 不同用户用|分隔, 如:uid1,100|uid2,900 |
Market | string | 是 | CHINA | 市场:
|
CommodityType | string | 是 | FULLSITE_SELF | 商品类型
|
MarketType | integer | 是 | 10 | 市场类型:
|
ClientType | string | 是 | UNIVERSAL | 客户端类型
|
Currency | object | 是 | USD | 金额货币 |
CouponFixedType | string | 否 | FIXED | 面额类型
|
UpperLimit | number | 否 | 100 | 单优惠券优惠金额上限 |
RequestId | string | 是 | vsdvnjwegiq | 用于全程跟踪 |
FromApp | string | 是 | test | 请求来源APP |
请求示例
http(s)://resellertrade.aliyuncs.com?Action=CreateCouponTemplate
&SellerId=153******4157
&Name=测试模版
&<公共请求参数>
[
{
"fromApp": "budget-aliyun-inc-com",
"param": {
"sellerId":1938******65,
"clientType": "PC",
"commodityType": "OFFICIAL_SELF",
"controlType": "NUMBER",
"couponEndTime": 1652889599000,
"couponStartTime": 1650267067000,
"couponType": "DISCOUNT",
"currency": "CNY",
"description": "优惠券测试",
"discountRate": 0.8,
"endTime": 1652889599000,
"itemCodeSet": [
"vm"
],
"market": "CHINA",
"marketType": 3003,
"maxRelease": 10,
"name": "优惠券测试",
"operator": "123456",
"orderTypeSet": [
"DOWNGRADE",
"BUY",
"UPGRADE",
"RENEW"
],
"perLimitNum": 1,
"site": "CHINA",
"spId": 25773208367,
"startTime": 1650267053000,
"type": "NORMAL",
"universalType": "NONUNIVERSAL",
"usageCount": 1,
"useScene": "304",
"validityType": "ABSOLUTE"
},
"requestId": "request-212c253e16502671028073268e03a6"
}
]
返回参数
参数名 | 参数类型 | 说明 |
success | boolean | 是否成功 |
requestId | String | 请求编号 |
data | Long | 模板编号 |
code | String | 错误码 |
message | String | 错误原因 |
返回示例
[
{
"RequestId":"E40EC2C2-8AD5-4D01-B54C-F6F8EC176ED3",
"Data":293987****7654,
"Code":"success",
"Success":true
}
]