商户创建商品代金券

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/koubei/marketing/campaign/item/merchantactivity/create' \ --header 'Content-Type: application/json' \ --data-raw '{ "voucher_info": { "logo": "string", "sub_title": "string", "user_introductions": "string", "valid_days_range_from": 0, "valid_days_range_to": 0, "valid_time_range_from": "string", "valid_time_range_to": "string", "valid_time_type": "string" }, "count_limit": 99, "count_limit_per_day": 99, "count_limit_per_user": 99, "count_limit_per_user_per_day": 99, "crowd": "DEFAULT", "deduct_amount": "5.00", "external_callback_url": "xxxx", "external_unique_id": "4b203fe6c11548bcabd8da5bb087a83b", "memo": "备注", "min_cost": "5.00", "obtain_manually": true, "gmt_end": {}, "gmt_start": {}, "item_ids": "[\"2088xxxxx\",\"2088xxxx\"]" }'

请求参数

Body 参数application/json

voucher_info

object (MerchantActivityVoucherInfo)

可选

logo

string

可选

券logo 券logo最大字符数不能超过64

sub_title

string

可选

子标题券子标题最大字符数不能超过256 券子标题最小字符数不能低于2

user_introductions

string

可选

使用须知券使用须知最大字符数不能超过1000

valid_days_range_from

integer

可选

领取后, 第几天开始生效 valid_time_type=RELATIVE时有效且必填

valid_days_range_to

integer

可选

领取后, 第几天失效 valid_time_type=RELATIVE时有效且必填

valid_time_range_from

string

可选

有效期开始时间 valid_time_type=FIXED时有效且必填券有效开始时间格式必须为yyyy-MM-dd HH:mm:ss

valid_time_range_to

string

可选

有效期截止时间 valid_time_type=FIXED时有效且必填券有效结束时间格式必须为yyyy-MM-dd HH:mm:ss

valid_time_type

string

有效期类型

可选

count_limit

integer

可选

活动优惠次数限制，必须设置。说明：活动优惠总次数限制不能小于1，且不能大于99999999。

示例值:

count_limit_per_day

integer

可选

活动优惠单日次数限制。说明：活动优惠单日次数限制不能为负数，不能大于99999999；0表示不限制。

示例值:

count_limit_per_user

integer

可选

活动单用户限次。说明：活动单用户总限次不能为负数，不能大于999。0表示不限制。

示例值:

count_limit_per_user_per_day

integer

可选

活动单用户单日限次。说明：活动单用户单日限次不能为负数，不能大于999。0表示不限制。

示例值:

crowd

string

可选

群规则，枚举支持： * DEFAULT：全部用户； * ONLINE_NEWCOMER：在线购买新人； * MEMBER：会员。

示例值:

DEFAULT

deduct_amount

string

可选

代金券面额，单位为元。说明：代金券面额格式必须为#.##，代金券面额需小于49999。

示例值:

5.00

external_callback_url

string

可选

外部回调地址，最大字符数不能超过500。

示例值:

xxxx

external_unique_id

string

可选

外部id，需保证同一账户下唯一。说明：最小长度不能低于13，最大长度不能超过64。

示例值:

4b203fe6c11548bcabd8da5bb087a83b

memo

string

可选

备注。说明：备注最大字符数不能超过500。

示例值:

备注

min_cost

string

可选

使用门槛，即满 min_cost 元可用，使用门槛必须大于券面额，单位为元。说明：使用门槛格式必须为#.##。

示例值:

5.00

obtain_manually

boolean

可选

是否手动领取，本期只支持true

示例值:

true

gmt_end

string

可选

活动结束时间。活动结束时间需大于活动开始时间。格式为"yyyy-MM-dd HH:mm:ss"。

示例值:

{}

gmt_start

string

可选

活动开始时间。格式为"yyyy-MM-dd HH:mm:ss"。

示例值:

{}

item_ids

array[string]

可选

商品列表。说明：参加活动的商品列表不能为空，最大个数不能超过100。

示例值:

["2088xxxxx","2088xxxx"]

示例

商户创建商品代金券

请求参数

返回响应