文档

创建优惠券模板-CreateCouponTemplate

更新时间:
一键部署

功能概述

用于创建优惠券模板。

请求参数

名称

类型

必填

示例

说明

Name

string

模板测试

t_name 模板名称

UseScene

string

OPERATIONAL

  • 活动用券:ACTIVITIES_STAMPS

  • 运营活动:OPERATIONAL

Reason

string

测试使用

申请原因

UniversalType

string

UNIVERSAL

  • 通用券:UNIVERSAL

  • 非通用券:NONUNIVERSAL

CouponType

string

VOUCHER

  • 满减券:CERTAIN

  • 折扣券:DISCOUNT

UsageCount

integer

0

优惠券使用次数 , 0表示无限制

CouponAmount

number

100

yh_amount 生成券的面额(单位:元)

DiscountRate

number

0.8

折扣, 如: 0.75 取值范围(0, 1)

ControlType

string

AMOUNT

  • 总金额控制:AMOUNT

  • 总数量控制:NUMBER

MaxRelease

number

100

优惠券允许发放的数量

PerLimitNum

integer

1

每人限领数量

ValidityType

string

RELATIVE

  • 相对时间:RELATIVE

  • 绝对时间:ABSOLUTE

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

xxx

操作人, 系统操作为应用名, 员工操作设置为工号

SellerId

integer

123123563464

优惠券发放人 : 伙伴自身UID

ItemCodeSet

array

商品规格CODE。 限定商品类型时, 适用的商品集合, 通用券(yhUniversalType=NONUNIVERSAL)不能为空

string

ecs

商品规格code

OrderTypeSet

array

优惠券支持的订单类型

  • 订购:"BUY"

  • 续费:"RENEW"

  • 升级:"UPGRADE"

  • 降配:"DOWNGRADE"

string

1

订单类型

ExtendsMap

map

扩展字段

Type

string

APPLY

模板申请类型:

APPLY 模板转正自动发放券

Site

string

CHINA

适用站点:

  • 中国:CHINA

UserPkAmount

string

12341234,100

申请人UID和金额, 用逗号(半角)分隔, 不同用户用|分隔, 如:uid1,100|uid2,900

Market

string

CHINA

市场:

  • 中国市场:CHINA

CommodityType

string

FULLSITE_SELF

商品类型

  • 全网自营:FULLSITE_SELF

MarketType

integer

10

市场类型:

  • 阿里云官网集市:10

ClientType

string

UNIVERSAL

客户端类型

  • 通用:UNIVERSAL

Currency

object

USD

金额货币

CouponFixedType

string

FIXED

面额类型

  • 固定面额:FIXED

  • 非固定面额:NONFIXED

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
 }
]

  • 本页导读 (0)