参数

参数名

类型

必填

描述

appid

应用id

String[10]

是

基础营销平台分配

buttid

对接方id

String[10]

否

基础营销平台分配

opeid

活动发起方id

String[10]

是

由基础营销平台导入

outactid

商户平台活动id

String[10]

是

act_name

活动名称

String[64]

是

活动名称

act_desc

活动描述

String[100]

是

branchid

活动发起方所属分公司

String[10]

否

branchid可以取值为活动发起方所属分公司或下属分支公司，不为空会以当前值为发起方所属分公司

act_begin

活动开始时间

String[14]

是

yyyyMMddHHmmss

act_end

活动结束时间

String[14]

是

yyyyMMddHHmmss

rule_type

优惠类型

int

是

0-固定值，1-折扣比例（百分比），9-随机立减

remote_type

核销模式

Integer

是

0：本地，1：远端

远端模式不支持核销产品类型为【收银宝】、【外卡收银】的权益

auth_type

活动授权类型

String

是

OPERATION：运营授权，SELF：自助授权；默认运营授权

rule_range_low

消费金额

Long

是

remote_type=0本地模式下生效，单位为分，优惠规则：满x元

rule_dc_value

优惠金额

Long

否

remote_type=0本地模式下生效，rule_type=0必填，单位为分，优惠规则：立减x元

rule_dc_percent

折扣比例

Long

否

remote_type=0本地模式下生效，rule_type=1必填，百分比1-99

rule_dc_high

最大优惠金额

Long

否

remote_type=0本地模式下生效，rule_type=1和rule_type=9必填，单位为分，不能大于1000元

div_rule_list

减价区间

Array[Dcactamtrulerditv]

否

remote_type=0本地模式下生效，rule_type=9必填且该类型下生效，总数不能超过5个

limit_acct_pattern

指定卡BIN(非标)

String[200]

否

remote_type=0本地模式下且选择了快捷支付时有效，正则表达式：\b((卡bin)\d{总长度-卡bin位数})\b。多个卡bin时以| 隔开。

示例:卡BIN为625202，卡号位数16位，正则表达式:\b((625202)\d{10})\b，

多个示例：\b((625202)\d{10})\b|\b((621101)\d{10})\b

limit_acct_cardbin

指定卡BIN(标准卡BIN)

String[1024]

否

remote_type=0本地模式下且选择了快捷支付时有效，格式：卡BIN + “-” + 卡号长度，多个以逗号分隔

示例：622425-19

多个示例：622425-19,622422-19

limit_woer_type

可用商户类型

int

是

1:商户

2:代理商

3:门店

limit_pid

产品类型

string

否

P0002：当面付

P0003：网上收银

默认P0002：当面付

limit_trxcode

交易方式

String

是

VSP501：微信支付

VSP511: 支付宝支付

VSP301：快捷支付

多个用英文逗号分隔

cus_limit_sumcnt

单商户总笔数限制

Integer

否

例如单商户总限制X笔，为0或空不限制，不能小于单商户周期内限制笔数

cus_limit_pertype

单商户限制周期类型

String[1]

否

1:每日

2:每周

3:每月

为空不限制，填入cus_limit_cnt时该字段必填，否则不生效

cus_limit_cnt

单商户周期内笔数限制

Integer

否

例如单商户每周限制x笔，为0或空不限制，填入cus_limit_pertype后必填

limit_type

限制类型

String[8]

否

USER:单用户

ACCT:单卡号

为空不限制，传入limit_pertype、limit_cnt、limit_sumcnt时该字段必填，否则不生效

limit_sumcnt

单用户标识总笔数限制

Integer

否

例如单卡号（ACCT）总限制X笔，为0或空不限制

limit_pertype

单用户标识限制周期类型

String[1]

否

1:每日

2:每周

3:每月

为空不限制，填入limit_cnt时该字段必填，否则不生效

limit_cnt

单用户标识周期内笔数限制

Integer

否

例如单卡号（ACCT）每周限制x笔，为0或空不限制，传入limit_pertype后必填

use_conflict

是否和其他同类型权益互斥

integer

否

0-不互斥，1-互斥，默认1互斥说明：立减与立减之间的互斥，优惠券/立减/礼品卡不互斥

actamt_plan

预算金额

Long

是

单位为分

funder_list

出资方列表

Array[ActFunder]

否

传入出资方列表，具体字段如下

要求总数不超过3个，出资方总比例必须为100%，只允许一个预充值出资方

send_auth_sms

免充值自助授权是否发送短信

Integer

否

1-发送短信，0-不发送短信；默认发送

参数

参数名

类型

必填

描述

funder_id

出资方id

String

否

预充值必填，免充值为空则默认为商户出资

funder_partner_id

出资合作机构

String

否

预充值且非垫资时生效

fund_type

出资类型

String

是

CASH：预充值

NOCASH：免充值

is_advance_fund

是否垫资

Integer

否

0：否，1：是；当fund_type=CASH必填

fund_amt_rate

出资比例

Integer

是

值为0~100，若出资方多个，出资比例总额必须为100%

参数

参数名

类型

必填

描述

weight

权重

Integer

是

不能超过100，所有区间总权重必须为100

dcvalue_low

随机金额下限

Long

是

单位分，不能超过券最大优惠金额，不能超过上限

dcvalue_high

随机金额上限

Long

否

单位分，不能超过券最大优惠金额，不能小于下限

参数

参数名

类型

必填

描述

ret_code

接口状态码

String(4)

是

200-处理成功

详见附录

ret_msg

接口错误信息

String

是

result_code

错误码

String(32)

否

SUCCESS-调用成功

详见附录

result_msg

错误信息

String

否

actid

活动id

String[10]

是

营销平台活动id