开发文档
商品池活动
1.5.2.1 场景介绍
Erp中商品池活动需要通过api接口上传到ReX平台，目前支持的业务规则有：
| 能力模型 |
样例 |
参数组合 |
| 单一商品/商品池商品满N元减Y元 |
满10元，减5元 |
阶梯（整体优惠）+逻辑分组规则 |
| 单一商品/商品池商品满N元打Y折 |
满10元，打5折 |
阶梯（整体优惠）+逻辑分组规则 |
| 单一商品/商品池商品满N件减Y元 |
满10件，减5元 |
阶梯（整体优惠）+逻辑分组规则 |
| 单一商品/商品池商品满N件打Y折 |
满10件，打5折 |
阶梯（整体优惠）+逻辑分组规则 |
| 单一商品/商品池商品满N件第N件打Y折 |
满10件，第10件5折 |
阶梯（第N件优惠规则）+逻辑分组规则 |
| 单一商品/商品池商品满N件每件Y元 |
满10件，每件5元 |
阶梯（整体优惠）+逻辑分组规则 |
| 单一商品/商品池商品满N件第N件Y元 |
满10件，第10件5元 |
阶梯（第N件优惠规则）+逻辑分组规则 |
1.5.2.2 业务流程
1.5.2.3 业务说明
商品池活动涉及接口列表如下
| 商品池活动 |
商品池活动 |
创建商品池活动 |
|
| 删除商品池活动 |
|||
| 查询商品池活动 |
|||
| 活动商品 |
商品池活动中增加商品 |
||
| 商品池活动中删除商品 |
|||
| 查询商品池活动中的商品 |
创建商品池接口字段：
| 字段 |
字段名称 |
字段描述 |
必填 |
备注 |
| terminals |
优惠适用场景 |
分为：仅APP下单可用|仅门店POS结算可用|APP和POS同时可用，对应值为[1|2|1,2] |
是 |
针对线上只填[1] |
| out_act_id |
商家自己ERP中的活动id |
ReX平台活动与erp活动的关联字段 |
是 |
|
| shop_ids |
参加活动的渠道店id |
分配的渠道店ID，多个用英文逗号分割 |
是 |
|
| description |
活动描述 |
|
是 |
|
| activity_name |
活动名称 |
|
是 |
|
| start_time |
活动开始时间 |
时间戳 |
是 |
|
| end_time |
活动结束时间 |
时间戳 |
是 |
|
| merchant_crowd_code |
商家人群编码 |
ReX平台分配 |
否 |
不限制人群：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
|
活动优先级 |
|
否 |
活动优先级，值越大表示优先级越高，必须大于0 |
| exclude_single
|
商品池是否排除特价 |
true：是，false：否 |
否 |
默认是不排特价 |
| rule_stairs |
商品池活动的梯度列表 |
OpenPromotionRuleStair[] |
是 |
|
| logic_group_rules |
逻辑分组规则 |
OpenLogicGroupRule[] |
是 |
|
| activity_rule |
活动优惠规则 |
ActivityRule |
否 |
|
商品池活动的梯度列表OpenPromotionRuleStair字段：
| 字段 |
字段名称 |
字段描述 |
备注 |
| number |
阶梯序号 |
代表商家的阶梯ID，同时代表阶梯优先级的顺序 |
|
| is_amount |
是否满元 |
true：是，false：否 |
二选一 |
| is_count |
是否满件 |
true：是，false：否 |
|
| amount |
满x元【单位为分】 |
|
|
| count |
满x件 |
|
|
| cover_all_discount_rule |
阶梯整体优惠规则 |
|
|
| -- is_cover_all_discount_rate |
是否整体打折 |
true：是，false：否 |
|
| -- over_all_discount_rate |
整体打折【分】 |
600=6折 |
|
| -- is_cover_all_decrease_money |
是否整体减钱 |
true：是，false：否 |
|
| -- cover_all_decrease_money |
整体减钱【分】 |
200=2元 |
|
| --is_each_fix_price |
是否每件一口价 |
|
满件用 |
| --each_fix_price |
每件商品一口价【分】 |
|
|
| count_at_discount_rule |
第N件优惠规则 |
|
|
| --is_count_at_discount_rate |
是否第N件打折 |
true：是，false：否 |
|
| --is_count_at_fix_price |
是否第N件一口价 |
|
|
| --count_at_discount_rate |
第N件折扣率 |
600=6折 |
|
| --count_at_fix_price |
第N件一口价【分】 |
|
|
逻辑分组规则OpenLogicGroupRule字段：
| 字段 |
字段名称 |
字段描述 |
是否必填 |
备注 |
| number |
商家逻辑分组Id |
单个活动不能重复 |
是 |
填数字，添加商品接口需要用 |
| is_effective_group |
是否为优惠作用分组 |
true：是，false：否 |
是 |
固定true |
| logic_group_type |
分组类型 |
1-普通分组，2-换购分组，3-买赠分组，此处为1 |
是 |
固定1 |
活动优惠规则ActivityRule字段：
| 字段 |
字段名称 |
字段描述 |
是否必填 |
备注 |
| enable_multiple |
是否上不封顶 |
true：是，false：否 |
否 |
|
1.5.2.4 使用说明
活动和商品上传完成后，可以在ReX中台商家查看是否发布成功和有效。
路径：总部视角-》APP线上运营-》营销工具-》商品池满额促销
如下图：
查看活动规则：
查看活动商品：
手淘展示验证：
