开发文档
单品特价活动
1.5.1.1 场景介绍
ReX平台目前支持买赠、商品池及特价活动，需要erp打通接口来上传活动，即在erp中创建活动后能自动同步到ReX平台，线上交易也可享受特价活动；
1.5.1.2 业务流程
1.5.1.3 业务说明
| 业务 |
接口名称 |
API |
| 特价/一口价活动 |
查询特价活动 |
|
| 创建特价活动 |
||
| 删除特价活动 |
||
| 活动商品
|
特价活动增加商品 |
|
| 查询参加特价活动的商品优惠详情 |
||
| 将参加活动的商品从特价活动中删除 |
创建特价活动接口必要字段，其他未列出的字段可不使用，有需要时可与项目PM沟通后明确是否使用：
| 字段 |
字段名称 |
字段描述 |
必填 |
备注 |
| terminals |
优惠适用场景 |
分为：仅APP下单可用|仅门店POS结算可用|APP和POS同时可用，对应值为[1|2|1,2] |
是 |
|
| out_act_id |
商家自己ERP中的活动id |
接口返回ReX平台活动ID后，ERP可做关联 |
是 |
|
| shop_ids |
参加活动的渠道店id |
分配的storeId，多个用英文逗号分割 |
是 |
|
| discount_type |
商品特价优惠方式 |
itemDecreaseMoney:商品特价减价; itemFixPrice:商品特价一口价; itemDiscount:商品特价打折 |
是 |
|
| description |
活动描述 |
|
是 |
|
| activity_name |
活动名称 |
|
是 |
|
| member_limit |
商家维度会员参与限制 |
废弃，不再使用 |
否 |
|
| start_time |
活动开始时间 |
时间戳 |
是 |
|
| end_time |
活动结束时间 |
时间戳 |
是 |
|
| merchant_crowd_code |
商家人群编码 |
ReX平台分配，如SKYLMem（商家会员），~SKYLMem（非商家会员） |
否 |
不限制人群：merchant_crowd_code和txd_crowd_code都不传 限制商家人群：要填merchant_crowd_code 限制淘鲜达人群：要填txd_crowd_code
|
| txd_crowd_code |
淘鲜达人群编码 |
淘鲜达APP新用户，~TXDOldAPP 淘鲜达APP老用户， TXDOldAPP 淘鲜达POS新用户， ~TXDOldPOS 淘鲜达POS老用户， TXDOldPOS 淘鲜达新用户， ~TXDOldUser 淘鲜达老用户， TXDOldUser |
否 |
|
| priority_value |
活动优先级 |
否 |
数值越大，优先级越高 |
|
| cover_before |
是否参与后单压前单 |
true：是，false：否 |
否 |
支持按商品活动时间段压前单 |
关于后单压前单的补充说明：压单只是同时间内取优，不会冲掉或者删除原活动。
涉及两个接口参数：
cover_before 是否压单
priority_value 优先级
特价活动默认不参加压单。
如果参加，（后单和前单）活动必须都设置cover_before=true.
压单规则只在参与压单活动上生效，对不设置压单的活动无效。
1.设置压单，不设置优先级：
默认不设置优先级或者活动优先级相同，以创建时间最晚的为准。
2.设置压单，设置优先级
多个活动取优先级最高（priority_value值最大的）
特价活动如果设置了优先级，一定会设置后单压前单
同个时间内优先级越高，活动优先生效。
1.5.1.4 使用说明
活动和商品上传完成后，可以在ReX中台查看是否发布成功和有效。
路径：总部视角->APP线上运营->营销工具
如下图：
活动商品：
最终手淘展示效果（消费者视角）
后单压前单的活动说明：
示例说明一：
设置后单压前单，默认不设置优先级，压单效果，以创建活动最晚原则生效。
牵牛花测试门店
商品SKU：50100215 商品名称：B劳士消防应急灯
| 活动名称 |
创建时间 |
开始时间 |
结束时间 |
特价 |
优先级 |
| 前单活动00 |
2019-06-16 22:00:16 |
2019-06-16 21:50:00 |
2019-06-16 23:50:00 |
8 |
无设置 |
| 后单活动01 |
2019-06-16 22:15:32 |
2019-06-16 21:50:00 |
2019-06-16 22:50:00 |
7 |
无设置 |
| 后单活动02 |
2019-06-16 22:19:36 |
2019-06-16 21:50:00 |
2019-06-16 22:40:00 |
7.5 |
无设置 |
Portal后台活动如下图：
示例一解说：
前单活动00
生效时间段如下：特价为 8元
2019-06-16 22:00:16~2019-06-16 22:15:31
2019-06-16 22:50:01~2019-06-16 23:50:00
效果如下图：
（请仔细看效果图左上角时间）
后单活动01
生效时间段如下：特价为 7元
2019-06-16 22:15:32~2019-06-16 22:19:35
2019-06-16 22:40:01~2019-06-16 22:50:00
效果如下图：
（请仔细看效果图左上角时间）
后单活动02
生效时间段如下：特价为 7.5元
2019-06-16 21:50:00~2019-06-16 22:40:00
效果如下图：
（请仔细看效果图左上角时间）
示例说明二：
设置后单压前单，设置活动优先级priority_value值越大，活动优先级越高。
取优先级高生效。
牵牛花测试门店
商品SKU：92264997商品名称：测试商品3 优先级值越大，优先级越高
| 活动名称 |
创建时间 |
开始时间 |
结束时间 |
特价 |
优先级 |
| 前单活动带优先级1 |
2019-06-16 22:35:00 |
2019-06-16 22:30:00 |
2019-06-16 23:59:00 |
0.4 |
1001 |
| 后单活动带优先级1002 |
2019-06-16 22:39:19 |
2019-06-16 22:35:00 |
2019-06-16 23:00:00 |
0.3 |
1002 |
| 后单活动带优先级999 |
2019-06-16 22:43:12 |
2019-06-16 22:40:00 |
2019-06-16 23:20:00 |
0.2 |
999 |
Portal后台活动如下图：
示例二解说：
前单活动带优先级1
生效时间段如下：特价为0.4元
2019-06-16 22:35:00~2019-06-16 22:39:18
2019-06-16 23:00:01~2019-06-16 23:59:00
效果如下图：
（请仔细看效果图左上角时间）
后单活动带优先级1002
生效时间段如下：特价为0.3元
2019-06-16 22:39:19~2019-06-16 23:00:00
效果如下图：
（请仔细看效果图左上角时间）
后单活动带优先级999
2019-06-16 22:43:12~2019-06-16 23:00:00
虽然此活动创建时间最晚，但在此时间内优先级低于活动“后单活动带优先级1002”
因此不生效。
2019-06-16 23:00:01~2019-06-16 23:59:00
此时间内优先级低于活动 “前单活动带优先级1”，因此不生效。
示例说明三：
Portal创建特价活动
单个商品在portal创建两个活动，活动生效原则是按照商品特价最低原则为准。
商品SKU：50100215 商品名称：B劳士消防应急灯
| 活动名称 |
创建时间 |
开始时间 |
结束时间 |
特价 |
优先级 |
| 特价活动1 |
2019-06-21 10:59:35 |
2019-06-21 00:00:00 |
2019-06-21 23:59:59 |
9 |
无设置 |
| 特价活动2 |
2019-06-21 11:00:40 |
2019-06-21 04:00:00 |
2019-06-21 23:59:59 |
9.5 |
无设置 |
Portal后台活动如下图：
手淘最终生效是以最低价9元为准。
示例说明四：
当portal创建特价活动和API上传压单活动同时存在时
以活动最低价原则为准生效。
商品SKU：92264997商品名称：测试商品3
| 活动名称 |
创建时间 |
开始时间 |
结束时间 |
特价 |
优先级 |
| 前单活动带优先级999 |
2019-06-21 09:55:48 |
2019-06-16 22:40:00 |
2019-06-22 09:54:43 |
0.4 |
999 |
| 后单活动带优先级1000 |
2019-06-21 09:57:25 |
2019-06-16 22:40:00 |
2019-06-22 09:54:43 |
0.3 |
1000 |
| Portal后台手创建活动 |
2019-06-21 10:01:13 |
2019-06-21 00:00:00 |
2019-06-22 23:59:59 |
0.25 |
此时手淘0.25生效 |
| 0.45 |
特价改为0.45时，手淘上0.3生效。 |
Portal后台活动如下图：
Portal活动价0.25时,手淘按最低价0.25生效
Portal活动价0.45时;手淘按最低价0.3生效。
