营销业务对接说明

更新时间：2020/03/06 访问次数：5978

对接流程

商家ERP与中间件，以及ReX中台的交互流程如下图所示 :

表结构说明

营销业务中各个表结构之间的关系如下图所示：
业务说明：对于营销活动的设置商家可以在自己的ERP中设置，然后同步到ReX中台。也可以在ReX后台设置。
- 营销活动在商家ERP中设置：这种场景用于商家的活动类型与ReX的活动类型基本一样。
- 营销活动在ReX后台设置：这种场景用于商家的活动类型比ReX的丰富，为了避免商家的ERP较大的改动，直接在ReX后台设置活动。对于这种场景，因为参与活动的商品的价格商家的ERP是不知道的，但是又需要用商家的ERP打印价签，所以中间件会把价格回流到商家ERP主要用于价签的打印。
- 对于数据处理：每种活动以及活动关联的商品信息，需要一次性写入到中间件DB中，通过outactid来关联。中间件会先上传活动信息，返回活动id，然后在上传关联的商品数据。(买赠、特价、商品池活动上传时，商家插入顺序：优先插入活动商品表，再插入活动规则；中间件执行原理：先读取商家活动信息上传成功后拿到ReX活动ID activity_id ，补更新补充到活动规则和活动商品信息中。切记：如果商家先上传活动，后上传商品，则有可能出现规则上传了，商品一直未处理)

表结构字段

买赠活动表：wdk_itembuygift_activity

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
terminals	varchar	64	0		2	优惠可以生效的场景，分为：仅APP下单可用\|仅门店POS结算可用\|APP和POS同时可用，对应值为[1\|2\|1,2]
out_act_id	varchar	64	0		118_30754845	商家自己ERP中的活动id，必填，当ERP中同时传输营销活动和活动商品时，此字段为唯一辨识标志。
shop_ids	varchar	128	0		193118372	参加活动的渠道店id，即分配的storeId，非门店code（storecode）多个用英文逗号切割
description	varchar	512	0			活动详情描述,不超过30个英文字符
activity_name	varchar	64	0			活动名称,不超过10个英文字符
member_limit	int	10	0	√		商家维度会员参与限制，[-1:不限制;1:会员专享;2:非会员专享]，默认-1
end_time	datetime	23	3		2018/8/11 23:59:59	活动结束时间
start_time	datetime	23	3		2018/8/20 23:59:59	活动开始时间
activity_id	bigint	19	0	√		活动id，活动创建成功之后会返回这个活动id
op_type	varchar	64	0		add	本次操作类型，是新增还是更新，新增是add，删除是delete。如果乱填写，则不进行任何操作
status	int	10	0		0	处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√	2018/8/28 2:23:06	创建时间
gmt_modified	datetime	23	3	√	2018/8/28 2:23:06	修改时间
merchant_crowd_code	varchar	64	0	√		商家人群编码
txd_crowd_code	varchar	64	0	√		淘鲜达人群编码。淘鲜达APP新用户，~TXDOldAPP 淘鲜达APP老用户， TXDOldAPP 淘鲜达POS新用户， ~TXDOldPOS 淘鲜达POS老用户， TXDOldPOS 淘鲜达新用户， ~TXDOldUser 淘鲜达老用户， TXDOldUser

================================================================================================

买赠活动对应商品表：wdk_itembuygift_item

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
user_daily_limit_cnt	int	10	0	√		每人每日限制获得的赠品数，比如限购数为2，活动为买5赠1，则用户当天可以买5赠1，买10赠2，买15也只赠2。-1不限制。
user_limit_cnt	int	10	0	√		活动期间每人限制获得的赠品数，比如限购数为2，活动为买5赠1，则该用户整个活动期间最多获得2个赠品。-1不限制。
total_limit_cnt	int	10	0	√		活动期间总限购的赠品数，比如限购数为10000，则活动最多发出10000个赠品，超出数量后用户。-1不限制。
buy_num	int	10	0			买N赠1的N，即买几件可以获得赠品。-1不限制。
gift_sku_code	varchar	64	0			赠品的skuCode，如果和主商品的skuCode相同，则为买A赠A；如果不同，则为买A赠B
sku_code	varchar	64	0			买N赠1的N的商品的skuCode，即主商品的skuCode，2000个上限
activity_id	bigint	19	0	√		活动id，活动创建成功之后生成的活动id
out_act_id	varchar	64	0			商家自己ERP中的活动id，填写后可将淘鲜达活动与门店活动串联，有助于财务结算
op_type	varchar	64	0			操作类型，是新增还是更新，新增是add，删除是delete。如果乱填写，则不进行任何操作
status	int	10	0			处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√		创建时间
gmt_modified	datetime	23	3	√		修改时间
gift_sku_name	varchar	64	0	√		赠品名称
sku_name	varchar	64	0	√		主商品名称
success_item_shop_rel	varchar	2048	0	√		上传成功的商品与门店的关系，格式是json，比如{"2300929749296":"1000847028"},淘宝item和shop的对应关系， key-itemId, value-shopId。key是商品id，value是门店id

================================================================================================

单品特价活动表：wdk_itemdiscount_activity

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
terminals	varchar	64	0		1,2	优惠可以生效的场景，分为：仅APP下单可用\|仅门店POS结算可用\|APP和POS同时可用，对应值为[1\|2\|1,2]
out_act_id	varchar	64	0		21418432	商家自己ERP中的活动id，填写后可将淘鲜达活动与门店活动串联，必填，此字段为唯一辨识标志。
shop_ids	varchar	128	0		193118372	参加活动的渠道店id，即分配的storeId，非门店code（storecode），多个用英文逗号切割
discount_type	varchar	64	0		itemFixPrice	商品特价优惠方式[itemDecreaseMoney:商品特价减价;itemFixPrice:商品特价一口价;itemDiscount:商品特价打折]
description	varchar	512	0			活动详情描述,不超过30个英文字符
activity_name	varchar	64	0			活动名称,不超过10个英文字符
member_limit	int	10	0	√		商家维度会员参与限制，[-1:不限制;1:会员专享;2:非会员专享]，默认-1
end_time	datetime	23	3		2018/6/14 23:59:59	活动结束时间
start_time	datetime	23	3		2018/6/12 00:00:00	活动开始时间
activity_id	bigint	19	0	√		活动id，活动创建成功之后会返回这个活动id
op_type	varchar	64	0		add	操作类型，是新增还是更新，新增是add，删除是delete。如果乱填写，则不进行任何操作
status	int	10	0		1	处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√	2018/8/28 2:23:06	创建时间
gmt_modified	datetime	23	3	√	2018/8/28 2:23:06	修改时间
merchant_crowd_code	varchar	64	0	√		商家人群编码
txd_crowd_code	varchar	64	0	√		淘鲜达人群编码
every_day_periods	varchar	128		√		每天的那些时间段生效，例如["03:00:00_05:00:00"]，多时间段用英文逗号分隔
weekdays	varchar	128		√		一周的哪几天生效，例如[1,5]，表示周一和周五生效，周日取值是7

================================================================================================

单品特价对应商品表：wdk_itemdiscount_item

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
daily_limit_cnt	int	10	0	√		活动每天限购的商品数，超出数量后则不享受优惠。-1不限制。
user_daily_limit_cnt	int	10	0	√		活动每人每天限购的商品数，超出数量后则不享受优惠。-1不限制。
user_limit_cnt	int	10	0	√		活动期间每人限购的总商品数，超出数量后则不享受优惠。-1不限制。
total_limit_cnt	int	10	0	√		活动期间限购的总商品数，超出数量后则不享受优惠。-1不限制。
value	int	10	0			[优惠明细,分为单位]。优惠类型为[减价],则代表直降金额[如700,表示商品直降7元];优惠券类型为[一口价],则代表一口价[如700,表示商品一口价为7元];优惠券类型为[打折],则代表折扣[如788,表示打7.88折]
sku_name	varchar	64	0	√		商品名称
sku_code	varchar	64	0			商品的skuCode，2000个上限
activity_id	bigint	19	0	√		活动id，活动创建成功之后生成的活动id
out_act_id	varchar	64	0			商家自己ERP中的活动id，填写后可将淘鲜达活动与门店活动串联
op_type	varchar	64	0			操作类型，是新增还是更新，新增是add，删除是delete。如果乱填写，则不进行任何操作
status	int	10	0			处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√		创建时间
gmt_modified	datetime	23	3	√		修改时间
success_item_shop_rel	varchar	2048	0	√		上传成功的商品与门店的关系，格式是json，比如{"2300929749296":"1000847028"},淘宝item和shop的对应关系， key-itemId, value-shopId。key是商品id，value是门店id

================================================================================================

商品池活动表：wdk_itempool_activity

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
terminals	varchar	64	0		2	优惠可以生效的场景，分为：仅APP下单可用\|仅门店POS结算可用\|APP和POS同时可用，对应值为[1\|2\|1,2]
out_act_id	varchar	64	0		21418432	商家自己ERP中的活动id，填写后可将淘鲜达活动与门店活动串联，有助于财务结算，必填，此字段为唯一辨识标志。
shop_ids	varchar	128	0		193118372	参加活动的渠道店id，即分配的storeId，非门店code（storecode），多个用英文逗号切割
description	varchar	512	0			活动详情描述,不超过30个英文字符
activity_name	varchar	64	0			活动名称,不超过10个英文字符
member_limit	int	10	0	√		商家维度会员参与限制，[-1:不限制;1:会员专享;2:非会员专享]，默认-1
end_time	datetime	23	3		2018/4/24 23:59:59	活动结束时间
start_time	datetime	23	3		2018/4/22 23:59:59	活动开始时间
activity_id	bigint	19	0	√		活动id，活动创建成功之后会返回这个活动id
op_type	varchar	64	0		add	操作类型，是新增还是更新，新增是add，删除是delete。如果乱填写，则不进行任何操作
status	int	10	0		1	处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√	2018/4/24 23:59:59	创建时间
gmt_modified	datetime	23	3	√	2018/4/24 23:59:59	修改时间
daily_limit_cnt	int	10	0	√		活动每日总限购订单数，当优惠订单数超过限制，则后续订单无法享受优惠。-1不限制。
user_daily_limit_cnt	int	10	0	√		每人每日限购订单数，当优惠订单数超过限制，则后续订单无法享受优惠。-1不限制。
user_limit_cnt	int	10	0	√		活动期间每人总限购订单数，当优惠订单数超过限制，则后续订单无法享受优惠。-1不限制。
total_limit_cnt	int	10	0	√		活动期间总限购订单数，当优惠订单数超过限制，则后续订单无法享受优惠。-1不限制。
merchant_crowd_code	varchar	64	0	√		商家人群编码
txd_crowd_code	varchar	64	0	√		淘鲜达人群编码

================================================================================================

商品池活动规则：wdk_itempool_activity_rule

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
enable_multiple	int	10	0	√		活动是否上不封顶[满元活动使用使用此功能时，只能有一个梯度]。如果活动设置为满10元减1元，true代表满10元减1元，满20减2元，以此类推；false代表满10元减1元，满20也减1元，以此类推。满件活动，例如“满2件，第2件5折”，如果没有上不封顶，第三件开始就不会打折。传1表示true，传0或其他值代表false。默认为false。
amount_at	int	10	0	√		是否使用满元条件，不能与满件、N件Y折同时使用。此选项为true时，countAt和countBegin必须为false。传1表示true，传0或其他值代表false。默认为false
amount	int	10	0	√		满多少元[单位为分，传入700，代表满7元]，amountAt为true时，必须设置
count_at	int	10	0	√		是否使用满件条件，不能与满元、N件Y折同时使用。此选项为true时，countBegin和amountAt必须为false。传1表示true，传0或其他值代表false。默认为false
count_begin	int	10	0	√		是否使用N件Y折，不能与满元、满件同时使用。此选项为true时，countAt和amountAt必须为false。传1表示true，传0或其他值代表false。默认为false
count	int	10	0	√		满多少件或者第多少件开始参与活动[传入4，代表满4件打折或者第4件打折]。该值与countBegin和countAt相关，如果countBegin为true，则为N件Y折活动，如果countAt为true，则为满件活动
decrease	int	10	0	√		是否使用减钱功能，不能与打折功能同时使用，此选项为true时，discount必须为false。传1表示true，传0或其他值代表false。默认为false
decrease_money	int	10	0	√		减多少元[单位为分，传入700，代表减7元]，decrease为true时，必须设置
discount	int	10	0	√		是否使用打折功能，不能与减钱功能同时使用，此选项为true时，decrease必须为false。传1表示true，传0或其他值代表false。默认为false
discount_rate	int	10	0	√		打几折[单位为分，传入900，代表打9折]，discount为true时，必须设置
out_act_id	varchar	64	0	√		商家的活动id，跟wdk_marketing_itempool_activity活动里面的out_act_id是一样的，相关联的，通过这个字段来查找对应的规则。
gmt_create	datetime	23	3	√		创建时间
gmt_modified	datetime	23	3	√		修改时间
can_extra_item_num	bigint	11	0	√		可换购的数量，is_exchange为1时，该字段必填
is_exchange	bigint	11	0	√		是否为换购活动(1: 是；0：否)。is_exchange 为是的话，则把返回的活动ID更新到商品池活动阶梯商品表（wdk_itempool_stair_item）和商品池活动商品表（wdk_itempool_item）；否则只更新商品池商品表（wdk_itempool_item）
fix_price	int	11	0	√		是否每件一口价（1表示是，0或者其他值表示否。默认为否）
fix_price_amount	int	11	0	√		一口价价格(分为单位)

================================================================================================

商品池活动商品表：wdk_itempool_item

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
sku_name	varchar	64	0	√		商品名称
sku_code	varchar	64	0			商品的skuCode，30000个上限
activity_id	bigint	19	0	√		活动id，活动创建成功之后生成的活动id
out_act_id	varchar	64	0			商家自己ERP中的活动id，填写后可将淘鲜达活动与门店活动串联，有助于财务结算
op_type	varchar	64	0			操作类型，是新增还是更新，新增是add，删除是delete。如果乱填写，则不进行任何操作
status	int	10	0			处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√		创建时间
gmt_modified	datetime	23	3	√		修改时间
success_item_shop_rel	varchar	2048	0	√		上传成功的商品与门店的关系，格式是json，比如{"2300929749296":"1000847028"},淘宝item和shop的对应关系， key-itemId, value-shopId。key是商品id，value是门店id
logic_group_number	int	20		√		逻辑分组ID
is_fix_price	int	20		√		是否为一口价 0否 1是
fix_price	int	20		√		一口价金额【分】
is_discount_rate	int	20		√		是否为商品折扣0否 1是
discount_rate	int	20		√		折扣率，300=3折
is_decrease_money	int	20		√		是否为减钱0否 1是
decrease_money	int	20		√		减钱金额【分】

================================================================================================

商品池活动阶梯商品表（换购活动wdk_itempool_activity_rule.is_exchange=1时启用）：wdk_itempool_stair_item

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
sku_code	varchar	32	0			商品skucode，当wdk_itempool_activity.terminals=2或1，2时，商品sku_code不能和wdk_itempool_item.sku_code重复，即线下pos换购，主商品和换购品不能是同一个商品
exchange_price	int	10	0			换购价格（单位为分）
exchange_total_limit	int	10	0	√		换购商品总数限制
out_act_id	varchar	64	0			商家活动id
activity_id	bigint	19	0	√		报名活动Id
op_type	varchar	16	0			是新增还是更新，新增是add 删除是delete。如果乱填写，则不进行任何操作
status	int	10	0			处理的结果，0未处理，1处理成功，-1处理失败
err_msg	varchar	4096	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√		创建时间
gmt_modified	datetime	23	3	√		修改时间

================================================================================================

商品营销价格表：wdk_promotion_price

字段名	类型	长度	小数位数	允许空	示例	字段说明
id	bigint	19	0			数据库自增id
shop_id	bigint	19	0	√	193118372	渠道店id，即分配的storeId，非门店code（storecode）
merchant_code	varchar	64	0	√	CSWA	商家编码
sku_code	varchar	64	0	√	99956	商品编码
promotion_type	varchar	64	0	√	ItemFixPrice	促销类型[ItemFixPrice:一口价,DecreaseMoney:减钱,Discount:打折]，，促销活动结束，该字段会置空
promotion_price	bigint	19	0	√	350	促销价格，必须小于商品原价。促销活动结束，该字段会恢复成商品原价
promotion_start	datetime	23	3	√	2018-08-29 00:00:00	促销开始时间，促销活动结束，该字段会置空
promotion_end	datetime	23	3	√	2018-09-11 23:59:59	促销结束时间，促销活动结束，该字段会置空
promotion_reason	varchar	512	0	√	让利	降价原因
promotion_gift_info	varchar	512	0	√		赠品活动信息
status	int	10	0	√		处理的结果，0未处理，1处理成功，-1处理失败
op_type	varchar	64	0	√	delete	操作类型，是新增还是更新，新增是add，删除是delete,查询是query。如果乱填写，则不进行任何操作
err_msg	varchar	4000	0	√		处理失败的时候的错误信息，用于排查错误
gmt_create	datetime	23	3	√	2018-05-12 01:21:13	创建时间
gmt_modified	datetime	23	3	√	2018-05-12 01:21:13	修改时间
shop_code	varchar	64	0	√	CSWA013	门店编码，即storeCode
member_promotion_type	varchar	64	0	√	ItemFixPrice	促销类型[ItemFixPrice:一口价,DecreaseMoney:减钱,Discount:打折]，，促销活动结束，该字段会置空
member_promotion_price	bigint	20	0	√	300	商品会员促销价
member_promotion_start_time	datetime	23	0	√	2018-08-29 00:00:00	会员促销价开始时间
member_promotion_end_time	datetime	23	0	√	2018-08-29 23:00:00	会员促销价结束时间

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

开发文档

营销业务对接说明

对接流程

表结构说明

表结构说明

表结构字段

FAQ