口碑能力
营销活动信息详细介绍
营销活动创建请求报文主要包含活动基础信息（如活动名称，开始／结束时间等），活动预算，活动约束信息，营销工具集合，投放渠道集合和招商工具这几个部分。如下图：
营销活动信息：
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| 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) - 列表型，最多定义5个营销券
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| voucher_no |
String(32) |
否 |
优惠券ID 创建营销活动时无需设置 |
| voucher |
Voucher |
是 |
优惠券 |
| send_rule |
SendRule |
是 |
发奖规则 |
| point_card |
PointCard |
否 |
集点卡工具 |
优惠券(voucher)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type |
Sting(10) |
是 |
券类型，目前支持以下类型： EXCHANGE：兑换券 MONEY：代金券 REDUCETO：换购券 RATE：折扣券 注：如活动类型为口令送券，优惠券仅支持代金券类型 |
| name |
String(40) |
是 |
券名称/商品名称 注：口碑卡包内展示的券名称将由口碑进行拼接。 卡券包内券名称规则为： |
| 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) |
是 |
延迟值，单位分钟 |
专属优惠券展示配置（display_config）
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| slogan |
String(20) |
否 |
券的宣传语 含圈人的直领活动，且投放渠道选择了支付成功页或店铺的情况下必填 |
| slogan_img |
String(32) |
否 |
券的宣传图片文件ID 含圈人的直领活动，且投放渠道选择了店铺的情况下必填 |
券的说明条款（clause_terms）
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| title |
String(32) |
是 |
券说明标题 |
| descriptions |
String(64) |
是 |
券说明描述 |
投放渠道集合(publish_channel)
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type |
String(32) |
是 |
渠道类型，目前支持以下类型 口令渠道与其他渠道互斥 |
| 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 |
是 |
isv用于幂等控制的外部业务号 |
| 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
优惠券和营销场景示例
券有效期与生效方式：
1 2 3 4 5 6 7 8 9 10 | { "start_time":"2016-04-25", "end_time":"2016-05-03", "voucher":{ "validate_type":"RELATIVE", "relative_time":"7", "effect_type":" IMMEDIATELY ", ... }} |
说明：2016-04-25至2016-05-03活动期间获得的券，获取后即刻可用，自获取之刻起7日内有效
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | { "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" }, ... }} |
说明：
2016-04-25至2016-05-03活动期间获得的券：
当$type=ABSOLUTELY时，
表示2016-05-02 08:00:00 获得到的券，在2016-05-03 08:00:00-2016-05-09 23:59:59 期间可用
当$type=BYDAY时，
表示2016-05-02 08:00:00 获得到的券，在2016-05-03 00:00:00-2016-05-09 23:59:59 期间可用
各类型的券示例：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | { "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": "" }} |
字段示意：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | { "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": "" }} |
字段示意：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | { "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": "" }} |
字段示意：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 | { "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" ] } }} |
字段示意：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 | { "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" ] } }} |
字段示意：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 | { "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" ] } }} |
字段示意：
消费送券活动设置示例：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | { "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": "" }} |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 | { "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" } } ] }} |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 | { "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": "", }} |
优惠券核销规则说明
通过营销活动发放的优惠券，如何跟当面付接口结合将优惠券核销掉可以参考下面的说明：
- 当券指定门店时，当面付接口中STORE_ID传入字段，必须和券适用门店的门店ID匹配。注：当面付中传入的是外部门店号，券接口中传入的是内部门店号，两者需要匹配。
- 若创建的是单品券，则券接口item_id中传入的商品ID列表的值，要跟当面付接口中商品明细列表（goods_detail）中的商品标号（goods_id）的值对应，都填写商家内部商品唯一id号
- 优惠券通用核销流程：一笔交易通过当面付传递给支付宝时，蚂蚁金服会先查询请求参数中的门店（store_id）下是否有匹配的全场优惠券，然后查询goods_id是否有对应的单品优惠券，根据核销规则进行核销。
核销规则：
- 单品优惠—— 单品代金券，单品折扣券，单品换购券；
对同一个SKU取优惠力度最大的核销，对不同的SKU可以取不同的券核销。
当多张券优惠力度相同时，优先核销有效期短的券。
- 全场优惠 —— 全场折扣，全场代金券
取优惠力度最大的全场优惠核销；
当多张券优惠力度相同时，优先核销有效期短的券。
- 订单核销规则：对比一笔订单中单品优惠和全场优惠的优惠金额，取优惠金额大的优惠类型核销。
举例：
A商品单价100，B商品单价200，C商品单价300；
用户拥有以下五张券：
券1：适用商品为A的20元单品代金券；
券2：适用商品为A、B的9折单品折扣券
券3：适用商品为C的280元单品换购券
券4：全场9.5折券
券5：全场50元代金券
该用户购买了1个A商品，1个B商品，1个C商品共计600元。
先计算单品优惠：
对A商品： 用券1优惠20元，用券2优惠10元，因此用券1核销；
对B商品： 用券2优惠20元
对C商品： 用券3优惠20元
因此单品优惠最高优惠金额为60元
再计算全场优惠：
使用券4，全场优惠600 * （1-0.95） = 30元
使用券5，优惠50元
因此全场优惠最高优惠50元；
单品优惠总计优惠力度更大，因此核销券1，券2，券3，用户最终支付540元。
