进阶指南
营销活动信息详细介绍
营销活动信息
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| out_biz_no | String(32) | 是 | 外部业务流水号。 |
| operator_id | String(32) | 否 | 操作人 ID，服务商代商家创建活动时需传入。 |
| operator_type | String(32) | 否 | 操作人类型，目前支持以下类型：PROVIDER：服务商 PROVIDER_STAFF：服务商员工 |
| name | String(32) | 是 | 活动名称。 |
| start_time | String(20) | 是 | 活动开始时间。格式yyyy-MM-dd HH:mm:ss。示例值：2016-05-01 00:00:00 |
| end_timte | String(20) | 是 | 活动结束时间。格式yyyy-MM-dd HH:mm:ss。示例值：2016-05-01 23:59:59 |
| type | String(20) | 是 | 活动类型。目前支持以下类型：CONSUME_SEND：消费送活动 DIRECT_SEND：直发奖活动 REAL_TIME_SEND：立减类活动 GUESS_SEND：口令送活动 |
| desc | String(32) | 否 | 活动详细说明。如，用于挽回流失用户。 |
| budget_info | BudgetInfo | 否 | 活动预算信息，如果不设置则无预算上限。 |
| constraint_info | ConstraintInfo | 是 | 活动的约束信息。 |
| promo_tools | PromoTool[] | 是 | 营销工具集合。最少配置 1 个营销工具。 最多配置 5 个营销工具 |
| publish_channels | PublishChannel[] | 否 | 活动投放渠道配置。直发奖类活动必须配置投放渠道。 |
| recruit_tool | RecruitTool | 否 | 招商工具配置。 |
预算信息(budget_info)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| budget_type | String(16) | 是 | 预算类型，目前支持以下类型：QUANTITY：数量类型 |
| budget_total | String(64) | 是 | 预算数量。必须为合法整数类型字符串，如 10258，表示活动可发券数量为 10258。 |
活动约束信息(constraint_info)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| user_win_count | String(20) | 否 | 活动期间用户能够参与的次数限制。如果不设置则不限制参与次数。 |
| user_win_frequency | String(32) | 否 | 活动期间用户能够参与的频率限制。如果不设置则不限制参与频率。每日中奖1次：D||1 每周中奖2次：W||2 每月中奖3次：M||3 |
| crowd_group_id | String(32) | 否 | 人群规则组 ID。仅直发奖类型活动设置有效。 |
| suit_shops | String[] | 否 | 活动适用的门店列表。仅品牌商发起的招商活动可为空，最多支持 10w 家门店。 |
| min_cost | String(32) | 否 | 最低消费金额，单位元。仅在创建消费送礼包活动时设置。 |
| item_ids | String[500] | 否 | 单品码列表。仅在创建消费单品送活动时设置，最多设置 500 个单品码。 |
营销工具集合(promo_tools)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| voucher_no | String(32) | 否 | 优惠券 ID。创建营销活动时无需设置。 |
| voucher | Voucher | 是 | 优惠券。 |
| send_rule | SendRule | 是 | 发奖规则。 |
| point_card | PointCard | 否 | 集点卡工具。 |
优惠券(voucher)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | Sting(10) | 是 | 券类型。目前支持以下类型：EXCHANGE：兑换券 MONEY：代金券 REDUCETO：换购券 RATE：折扣券 说明：如活动类型为口令送券，优惠券仅支持代金券类型。 |
| name | String(40) | 是 | 券名称/商品名称。说明：口碑卡包内展示的券名称将由口碑进行拼接。 卡券包内券名称规则为： 全场代金券：#券面额#元代金券，如 5 元代金券。 全场折扣券：#折扣率#折，如 8.8 折。 单品代金券：#本字段##券面额#元代金券，如牛奶 5 元代金券。 单品折扣券：#本字段##折扣率#折券，如牛奶8.8折券。 单品换购券：#换购现价#元#本字段#换购券，如 5 元牛奶换购券。 兑换券：#本字段#，如剁椒鱼头兑换券。 对于全场券本字段仅作为商家管理使用。 对于单品券本字段作为单品券对应的商品名称传入。 |
| desc | String(500) | 否 | 券详细说明。最多包含 500 个字符。 |
| brand_name | String(20) | 否 | 商家品牌名称。 |
| use_instructions | String[6] | 否 | 券的使用说明。使用须知最多 6 条，且每条最多 100 字。 |
| logo | String(32) | 是 | 券 LOGO 文件 ID。 |
| voucher_img | String(32) | 否 | 券图片资源 ID。 |
| rate | String(10) | 否 | 折扣率。仅当券类型为折扣券时有效有效折扣率取值范围 0.11-0.99仅允许保留小数点后两位 |
| max_amount | String(10) | 否 | 最高优惠金额，单位元。必须为合法金额类型字符串。 |
| worth_value | String(10) | 否 | 券面额，单位元。必须为合法金额类型字符串。券类型为代金券。 换购券时，券面额必须设置。 单品换购券的券面额必须低于单品原价。 |
| donate_flag | String(10) | 否 | 券是否可转赠，默认为可转赠。 |
| validate_type | String(10) | 是 | 券有效期类型，目前支持以下类型：RELATIVE：相对有效期 FIXED：绝对有效期 |
| start_time | String(32) | 否 | 券有效期的开始时间。仅在券有效期类型为绝对有效期时生效。 |
| end_time | String(32) | 否 | 券有效期的结束时间。仅在券有效期类型为绝对有效期时生效。 |
| relative_time | String(10) | 否 | 券相对有效期，单位天。仅在券有效期类型为相对有效期时生效，如，设 5 表示领券领取后 5 日内有效。 |
| ext_info | String(1024) | 否 | 扩展信息，无需设置。 |
| item_info | ItemInfo | 否 | 单品信息。兑换券不允许设置单品信息 换购券必须设置单品信息 其他类型券可按需设置 |
| use_rule | UseRule | 是 | 券的使用限制。 |
| effective_type | String(10) | 是 | 券生效的方式，目前支持以下方式。仅在券有效期类型为相对有效期时生效。立即生效：IMMEDIATELY 延迟生效：DELAY |
| delay_info | DelayInfo | 否 | 延迟生效配置。仅在券生效的方式为延迟生效时有效。 |
| display_config | DisplayConfig | 否 | 专属优惠券展示配置。 |
| clause_terms | ClauseTerm | 否 | 券的说明条款。 |
集 点卡工具(point_card)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | String | 是 | 工具类型，目前支持： 集点卡：POINT_CARD。 |
| name | String | 是 | 集点卡。 |
| desc | String | 否 | 集点卡的功能描述。 |
| start_time | Date | 是 | 开始时间。2016-05-01 00:00:00 |
| end_time | Date | 是 | 开始时间。2016-10-01 00:00:00 |
| logo | String | 否 | 工具的 LOGO 文件 ID。 |
单品信息 (item_info)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| item_text | String(500) | 是 | 单品券说明。 |
| item_name | String(40) | 是 | 单品名称。 |
| item_imgs | String[3] | 否 | 单品图片列表。单品图片不能超过 3 张。 |
| item_link | String(1024) | 否 | 单品券详细介绍跳转链接，必须以 http://、https://、alipays:// 开头。 |
| original_price | String(64) | 否 | 单品的原价，单位元。换购券必须包含单品原价。 必须为合法金额类型字符串，如9.99。 |
| max_discount_num | String(32) | 否 | 最高优惠商品件数。必须为合法整数类型字符串。 在券类型为折扣券，换购券时设置有效。 |
| min_consume_num | String(32) | 否 | 最低购买商品件数。必须为合法整数类型字符串。 在券类型为折扣券，换购券时设置有效。 |
| item_ids | String[500] | 是 | 券适用的单品码列表。最少配置 1 个单品码。 最多配置 500 个单品码。 |
优惠券使用限制 (use_rule)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| use_time | Object[] | 否 | 券可用时间区间。 |
| dimension | String(32) | 是 | 券可用时段时间维度，目前支持周(W)。 |
| values | String(64) | 是 | 券可用时间维度值。周维度的取值范围。1-7(周一至周日)，多个可用时段用逗号分隔。如"1,3,5"，对应周一、周三、周五可用。 |
| times | String(1024) | 是 | 券可用时间段。可用时间段起止时间用逗号分隔，多个时间段之间用 ^ 分隔，时间段不可重叠。如 16:00:00,20:00:00^21:00:00,22:00:00 表示 16 点至 20 点，21 点至 22 点可用。 |
| forbidden_time | Object | 否 | 券的不可用时间。 |
| days | String(1024) | 是 | 不可用日期区间，仅支持到天。不可用区间起止日期用逗号分隔，多个区间之间用^分隔。如 2016-05-01,2016-05-03^2016-10-01,2016-10-07 表示 2016 年 5 月 1 日至 5 月 3 日，10 月 1 日至 10 月 7 日券不可用。 |
| suit_shops | String[] | 否 | 券适用门店列表。仅品牌商发起的招商活动可为空。 直发奖类型活动必须与活动适用门店一致。 最多支持 10w 家门店。 |
| min_consume | String(20) | 否 | 券核销的最低消费门槛，单位元。 |
| ext_info | String(1024) | 否 | 扩展属性，无需设置。 |
延迟生效配置（delay_info）
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | String(32) | 是 | 延迟类型，目前支持以下类型。ABSOLUTELY：按绝对值延迟 BYDAY：按天延迟 |
| value | String(32) | 是 | 延迟值，单位分钟。按绝对值延迟延迟 2460 (1天)表示，当日 08:00:00 领到的券要到隔日的 08:00:00 才能使用，按天延迟 2460(1天)表示，当日 08:00:00 领到的券，隔日 00:00:00 点就可以用。 |
专属优惠券展示配置（display_config）
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| slogan | String(20) | 否 | 券的宣传语。含圈人的直领活动，且投放渠道选择了支付成功页或店铺的情况下必填。 |
| slogan_img | String(32) | 否 | 券的宣传图片文件 ID。含圈人的直领活动，且投放渠道选择了店铺的情况下必填。 |
券的说明条款（clause_terms）
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| title | String(32) | 是 | 券说明标题。 |
| descriptions | String(64) | 是 | 券说明描述。 |
投放渠道集合(publish_channel)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | String(32) | 是 | 渠道类型，目前支持以下类型。QR_CODE：二维码投放 SHORT_LINK：短连接投放 SHOP_DETAIL：店铺页投放 AYMENT_RESULT：支付成功页 ERCHANT_CROWD：口令。口令渠道与其他渠道互斥。 |
| name | String(32) | 是 | 渠道名称。 |
| config | String(1024) | 否 | 若渠道为口令渠道，需要配置口令与背景图两个字段。口令内容：即用户领券时需要输入的口令内容，最多 10 个字符。 示例："PASSWORD":"12345"。 背景图片：即用户输入口令后领券页面的背景图片，建议尺寸 1136*640；此处传入的是图片资源ID。 示例："BACKGROUND_LOGO":"1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC" |
| ext_info | Strng(1024) | 否 | 扩展信息，无需配置。 |
招商工具(recruit_tool)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| start_time | String(32) | 是 | 招商开始时间。如，2016-06-06 12:00:00。 |
| end_time | String(32) | 是 | 招商结束时间。如，2016-07-06 12:00:00。 |
| pid_shops | PidShop[] | 否 | 招商邀约信息列表。 |
招商邀约信息列表（pid_shops）
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| pid | String(32) | 是 | 邀约商家 PID。 |
| shop_ids | String[] | 是 | 邀约商家门店列表。 |
通知参数说明
| 字段 | 是否可用 | 描述 |
|---|---|---|
| event_code | 是 | 事件类型。EC-CAMPAIGN_PROCESS-CAMPAIGN_SYNCH：活动同步。 |
| id | 是 | 活动 ID。 |
| type | 是 | 活动类型。DIRECT_SEND：直领 CONSUME_SEND：消费送 |
| status | 是 | 活动状态。ENABLED：生效 DISABLED：无效 STARTED：启动 CLOSED：停止 |
| audit_status | 是 | 审核状态。AUDITING：审核中 REJECT：审核驳回 PASS：审核通过 CANCEL：审核撤销 |
| order_id | 是 | 订单 ID。 |
| order_status | 是 | 订单状态。INIT：初始 DOING：处理中 SUCCESS：成功 FAIL：失败 |
| order_process_time | 是 | 订单处理时间。格式 yyyy-MM-dd HH:mm:ss。 |
| order_audit_status | 是 | 订单审批状态。 |
| order_type | 是 | 订单类型。CREATE：创建 ENABLE：生效 START：启动 CLOSE：关闭 |
| business_order | 是 | mnotify 业务单号，可以填入任何格式的内容，只要执行回查的业务系统认识即。 |
| trade_no | 是 | 支付宝交易流水号。 |
| out_trade_no | 是 | 外部交易号。 |
| merchant_uid | 是 | 发生交易商户 ID。 |
| buyer_id | 是 | 买家用户 ID。 |
| alipay_shop_id | 是 | 交易门店 ID。 |
| total_amount | 是 | 交易总金额。 |
| buyer_pay_amount | 是 | 买家实付金额。 |
| receipt_amount | 是 | 卖家实收金额。 |
| gmt_payment | 是 | 支付完成时间。 |
| goods_info_list | 是 | 交易的商品信息。 |
| isv_out_biz_id | 是 | 服务商用于幂等控制的外部业务号。 |
| voucher_id | 是 | 券 ID。 |
线上通知实例
http://[ISV_NOTIFY_URL]?name=消费送&id=20161118000000000256856000151249&order_type=CREATE&sign=IuOu2dS5OfHomv1DBY4t1r//8yzGU/nJchdKJXQr8/AzMW6MmMg20jcudW6Q3eo9G/Urt7bii3Dmo4AJvMug0Uvge12WPwE9rWxkN473wn6vCa8bNLXcXJnui46LvwqPKYTghVt+43cL6y5VBWd9r1FjPhh/mcO0vaT7fyGlU6c=&order_process_time=2016-11-18 11:18:43&status=STARTED&event_code=EC-CAMPAIGN_PROCESS-CAMPAIGN_SYNCH&order_status=SUCCESS&order_id=20161118000000000932714000155246优惠券和营销场景示例
券有效期与生效方式
{
"start_time":"2016-04-25",
"end_time":"2016-05-03",
"voucher":{
"validate_type":"RELATIVE",
"relative_time":"7",
"effect_type":" IMMEDIATELY ",
...
}
}{
"start_time":"2016-04-25",
"end_time":"2016-05-03",
"voucher":{
"validate_type":"RELATIVE",
"relative_time":"7",
"effect_type":" DELAY",
"delay_info":{
"type":$type,
"value":"1440"
},
...
}
}各类型的券示例
兑换券
{
"voucher": {
"type": "EXCHANGE",
"name": "摩卡咖啡兑换券",
"brand_name": "口碑",
"logo": "fVMQYs-pSAqgu5b3VveEHQAAACMAAQED",
"voucher_img": "qRsTxYZARh-8gJdwCJzHBwAAACMAAQED",
"donate_flag": "true",
"validate_type": "RELATIVE",
"relative_time": "5",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,2,3,4,5",
"times": "00:00:00,20:00:00"
},
{
"dimension": "W",
"values": "6,7",
"times": "16:00:00,21:59:59"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2016052300077000000015602594"
],
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"use_instructions": [
"使用须知1",
"使用须知2"
],
"display_config": {
"slogan": "摩卡咖啡1",
"slogan_img": "OlGZU2H-QIyEop4xLFYCOwAAACMAAQED"
},
"ext_info": ""
}
}字段示意
全场代金券
{
"voucher": {
"type": "MONEY",
"name": "5元代金券",
"brand_name": "口碑",
"logo": "fVMQYs-pSAqgu5b3VveEHQAAACMAAQED",
"voucher_img": "qRsTxYZARh-8gJdwCJzHBwAAACMAAQED",
"worth_value": "5",
"donate_flag": "true",
"validate_type": "RELATIVE",
"relative_time": "30",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,2,3,4,5",
"times": "10:00:00,14:00:00"
}
],
"min_consume": "20",
"forbidden_time": {
"days": "2016-06-28,2016-06-30"
},
"suit_shops": [
"2016052300077000000015602594"
],
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"use_instructions": [
"使用须知1",
"使用须知2"
],
"ext_info": ""
}
}字段示意
全场折扣券
{
"voucher": {
"type": "RATE",
"name": "全场折扣展示",
"brand_name": "口碑",
"logo": "fVMQYs-pSAqgu5b3VveEHQAAACMAAQED",
"voucher_img": "qRsTxYZARh-8gJdwCJzHBwAAACMAAQED",
"rate": "0.78",
"donate_flag": "true",
"validate_type": "RELATIVE",
"relative_time": "7",
"max_amount": "10",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,2,3,4,5",
"times": "00:00:00,23:59:59"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2016052300077000000015602594"
],
"min_consume": "20",
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"use_instructions": [
"使用须知1",
"使用须知2"
],
"display_config": {
"slogan": "摩卡咖啡券1",
"slogan_img": "OlGZU2H-QIyEop4xLFYCOwAAACMAAQED"
},
"ext_info": ""
}
}字段示意
单品折扣券
{
"voucher": {
"type": "RATE",
"name": "摩卡咖啡",
"brand_name": "口碑",
"logo": "fVMQYs-pSAqgu5b3VveEHQAAACMAAQED",
"voucher_img": "qRsTxYZARh-8gJdwCJzHBwAAACMAAQED",
"rate": "0.7",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-10-01 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,2,3,4,5",
"times": "00:00:00,22:00:00"
},
{
"dimension": "W",
"values": "6,7",
"times": "20:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2016052300077000000015602594"
],
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"delay_info": {
"type": "ABSOLUTELY",
"value": "10000"
},
"desc": "商品描述，商品描述",
"use_instructions": [
"使用须知1",
"使用须知2"
],
"display_config": {
"slogan": "摩卡咖啡1",
"slogan_img": "OlGZU2H-QIyEop4xLFYCOwAAACMAAQED"
},
"ext_info": "",
"item_info": {
"item_text": "券使用商品描述",
"item_name": "",
"max_discount_num": "1",
"min_consume_num": "2",
"item_ids": [
"123",
"342"
]
}
}
}字段示意
单品代金券
{
"voucher": {
"type": "MONEY",
"name": "摩卡咖啡",
"brand_name": "口碑",
"logo": "fVMQYs-pSAqgu5b3VveEHQAAACMAAQED",
"voucher_img": "qRsTxYZARh-8gJdwCJzHBwAAACMAAQED",
"worth_value": "3",
"min_consume": "10",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-10-01 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,2,3,4,5",
"times": "00:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-07"
},
"suit_shops": [
"2016052300077000000015602594"
],
"min_consume": "10",
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"delay_info": {
"type": "ABSOLUTELY",
"value": "10000"
},
"desc": "适用商品描述",
"use_instructions": [
"使用须知1",
"使用须知2"
],
"ext_info": "",
"item_info": {
"item_text": "适用商品描述",
"item_name": "",
"item_ids": [
"123",
"342"
]
}
}
}字段示意
单品换购券
{
"voucher": {
"type": "REDUCETO",
"name": "摩卡咖啡",
"brand_name": "口碑",
"logo": "fVMQYs-pSAqgu5b3VveEHQAAACMAAQED",
"voucher_img": "qRsTxYZARh-8gJdwCJzHBwAAACMAAQED",
"worth_value": "3",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-10-01 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,2,3,4,5",
"times": "00:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-07"
},
"suit_shops": [
"2016052300077000000015602594"
],
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"delay_info": {
"type": "ABSOLUTELY",
"value": "10000"
},
"desc": "适用商品描述",
"use_instructions": [
"使用须知1",
"使用须知2"
],
"ext_info": "",
"item_info": {
"item_text": "适用商品描述",
"item_name": "",
"original_price": "5",
"max_discount_num": "1",
"min_consume_num": "2",
"item_ids": [
"123",
"342"
]
}
}
}字段示意
消费送券活动设置示例
消费阶梯送活动
{
"biz_content": {
"out_biz_no": " jieti-0000000000001",
"name": "代金券",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-08-12 00:00:00",
"type": "CONSUME_SEND",
"desc": "该活动是消费阶梯送活动",
"budget_info": {
"budget_type": "QUANTITY",
"budget_total": "10258"
},
"constraint_info": {
"user_win_count": "100",
"user_win_frequency": "D||3",
"crowd_group_id": "",
"suit_shops": [
"2015122900077000000002409504"
]
},
"promo_tools": [
{
"voucher": {
"type": "MONEY",
"name": "10元代金券",
"brand_name": "口碑",
"logo": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"voucher_img": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"worth_value": "10.0",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-09-11 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,3,5",
"times": "16:00:00,18:00:00^19:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2015122900077000000002409504"
],
"min_consume": "100",
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"ext_info": ""
},
"send_rule": {
"min_cost": "100",
"send_num": "2"
}
},
{
"voucher": {
"type": "MONEY",
"name": "20元代金券",
"brand_name": "口碑",
"logo": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"voucher_img": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"worth_value": "20.0",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-09-11 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,3,5",
"times": "16:00:00,18:00:00^19:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2015122900077000000002409504"
],
"min_consume": "100",
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"ext_info": ""
},
"send_rule": {
"min_cost": "200",
"send_num": "4"
}
}
],
"ext_info": ""
}
}消费送礼包活动
{
"biz_content": {
"out_biz_no": "gift-package-00001",
"name": "代金券",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-08-12 00:00:00",
"type": "CONSUME_SEND",
"desc": "该活动是消费送券礼包",
"budget_info": {
"budget_type": "QUANTITY",
"budget_total": "10258"
},
"constraint_info": {
"min_cost": "100",
"user_win_count": "100",
"user_win_frequency": "D||3",
"crowd_group_id": "",
"suit_shops": [
"2015122900077000000002409504"
]
},
"promo_tools": [
{
"voucher": {
"type": "MONEY",
"name": "20元代金券",
"brand_name": "口碑",
"logo": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"voucher_img": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"worth_value": "20.0",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-09-11 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,3,5",
"times": "16:00:00,18:00:00^19:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2015122900077000000002409504"
],
"min_consume": "100",
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"ext_info": ""
},
"send_rule": {
"send_num": "4"
}
},
{
"voucher": {
"type": "EXCHANGE",
"name": "全场兑换元券-hhe001",
"brand_name": "口碑",
"max_amount": "1",
"logo": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"voucher_img": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
"donate_flag": "true",
"validate_type": "FIXED",
"start_time": "2016-05-01 00:00:00",
"end_time": "2016-10-01 00:00:00",
"relative_time": "",
"use_rule": {
"use_time": [
{
"dimension": "W",
"values": "1,3,5",
"times": "16:00:00,17:00:00^19:00:00,22:00:00"
}
],
"forbidden_time": {
"days": "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops": [
"2015122900077000000002409504"
],
"min_consume": "100",
"ext_info": ""
},
"effect_type": "IMMEDIATELY",
"desc": "券的详细说明",
"ext_info": ""
},
"send_rule": {
"send_num": "2"
}
}
]
}
}口令送券活动
{
"biz_content" : {
"out_biz_no" : "jinfan_sit_create_33321054000022" ,
"name" : "口令送券活动" ,
"start_time" : "2016-09-01 00:00:00" ,
"end_time" : "2016-09-21 00:00:00" ,
"type" : "GUESS_SEND" ,
"desc" : " 这是口令送券活动示意 " ,
"budget_info" : {
"budget_type" : "QUANTITY" ,
"budget_total" : "10258"
},
"constraint_info" : {
"user_win_count" : "999999" ,
"user_win_frequency" : "D||100" ,
"suit_shops" : [
"2015122900077000000002409504"
]
},
"promo_tools" : [
{
"voucher" : {
"type" : "MONEY" ,
"name" : "专属5元代金券" ,
"brand_name" : "这是品牌名称" ,
"logo" : "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC" ,
"voucher_img" : "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC" ,
"max_amount" : "200" ,
"worth_value" : "20" ,
"donate_flag" : "true" ,
"validate_type" : "FIXED" ,
"start_time" : "2016-09-01 00:00:00" ,
"end_time" : "2016-11-02 00:00:00" ,
"display_config" : {
"slogan" : "券标语slogan" ,
"slogan_img" : "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC"
},
"use_rule" : {
"use_time" : [
{
"dimension" : "W" ,
"values" : "1,3,5" ,
"times" : "16:00:00,20:00:00^21:00:00,22:00:00"
}
],
"forbidden_time" : {
"days" : "2016-03-03,2016-03-08^2016-10-01,2016-10-01"
},
"suit_shops" : [
"2015122900077000000002409504"
],
"min_consume" : "10" ,
"ext_info" : ""
},
"effect_type" : "IMMEDIATELY" ,
"desc" : " 券的详细说明 " ,
"clause_terms" : [
{
"descriptions" : [
"xx1" ,
"xx2"
],
"title" : "XXX1"
},
{
"descriptions" : [
"xx3" ,
"xx4"
],
"title" : "XXX2"
}
],
"ext_info" : "" ,
"item_info" : {
"item_text" : "item_yuchi" ,
"item_name" : "item_name_yuchi" ,
"original_price" : "20" ,
"max_discount_num" : "2" ,
"min_consume_num" : "1" ,
"item_ids" : [
"2015101000076000000002236213" ,
"2015101000076000000002252927"
]
}
},
}
],
"publish_channels" : [
{
"name" : "channel1" ,
"type" : "MERCHANT_CROWD" ,
"config" : "{\"PASSWORD\":\"rrrr121010\",\"BACKGROUND_LOGO\":\"1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC\"}"
}
],
"ext_info" : "" ,
}
}优惠券核销规则说明
1.
说明：当面付中传入的是外部门店号，券接口中传入的是内部门店号，两者需要匹配。
2.
3.