需求背景
现在优惠券提报需要统一提报入口,方便数据管理与避免重复执行
需求内容
对接优惠券队列新接口,同时保留当前原有程序服务。
前期测试联调流程:支持指定来源渠道配置,通过新接口提报优惠券任务;
后期全部切换到新接口:新增开关控制,用于可快速切换回原有程序服务提交任务
1.obs对接
生成文件后保存到obs
2.优惠券提交接口
提交接口(新增优惠券促销活动任务):https://webapi.internal.zhcxkj.com/doc.html#/zhcxkj-application-open/IAmzPromotionTaskApi/addAmzPromotionTaskUsingPOST
优惠券任务提报:按技术中心提供的模板进行提报,具体可见附件
A)文件名称命名:战略部按原有规则命名
B)文件内容:战略部按原有规则命名
提交表格需要注意:
a)百分比值要带%,金额不要带币种符号
b)一个来源渠道一个文件:时间格式用横杠
c)对接技术中心新接口:过滤已提报且未过期的。
过滤技术中心提报未过期接口(根据渠道+asin查询最新的优惠券活动信息):https://webapi.internal.zhcxkj.com/doc.html#/zhcxkj-application-open/IAmzPromotionTaskApi/qryLatestActivityUsingPOST

3.优惠券提交结果同步
优惠券组结果目前都是按照整组获取——按时间增量查询,支持按优惠券组查询
提报结果接口(查询战略提交的优惠券活动信息):https://webapi.internal.zhcxkj.com/doc.html#/zhcxkj-application-open/IAmzPromotionTaskApi/qryUploadResultUsingPOST
其次针对优惠券组成功的,但是部分ASIN失败需要提供查询具体明细以及失败原因。————技术中心需要增加ASIN后台是否生效的结果,以及未生效原因
部分ASIN维度未生效——不能直接查所有ASIN维度的数据,需要单独建表提供接口查询未SIN后台是否生效的结果,以及未生效原因
优惠券组id重试提交——增加一个请求ID的字段,如果重新请求时这个字段要更新
3.1)上传文件结果:
A、上传文件成功:status=1,看提交文件结果。
B、上传文件失败:status=2,且【Message】信息是【您的文件存在错误 - 请更新以下文件中的错误字段,然后重新上传】,需要进行解析:【UploadResponse】字段【errorMessage】不为空的,需要将【errorMessage】失败原因返回,重试服务针对指定失败原因进行重新处理并提交
3.2)上传文件成功,提交文件结果:
A、提交文件成功:可进行采集生效结果与领取兑换
B、提交文件失败:status=1,且 【Message】信息是【下载数据成功】,需要进行解析:【DownLoadData】字段【errorMessage】不为空的,需要将【errorMessage】失败原因返回,重试服务针对指定失败原因进行重新处理并提交
3.3)战略部重试服务判断逻辑如下:
失败原因内容是【newui-error-invalid-asins】,需要进行解析【errorMessage】该字段里提供的ASIN,并将这些ASIN从优惠券组里进行移除后,按照重试规则重新提交。——
失败原因内容是【newui-error-past-start】,需要判断任务的提交时间距离当前时间<=3天,如果符合,则重新更新优惠券开始结束时间后再次提交。
失败原因内容是【newui-error-min-budget】,需要重新更新预算值,根据采集结果提供的最小预算值进行赋值
失败原因内容是【newui-error-max-budget】,需要重新更新预算值,根据采集结果提供的最大预算值进行赋值
失败原因内容是【newui-generic-bulk-failure】,直接按照重试通用规则重新提交(更新优惠券开始结束时间)
4.优惠券生效结果同步、领取兑换同步
目前技术中心一天更新一次,直接获取亚马逊后台报告
战略部不需要生成任务进行采集领取、兑换数。
直接通过
提报结果接口(查询战略提交的优惠券活动信息)查询领取、兑换数:https://webapi.internal.zhcxkj.com/doc.html#/zhcxkj-application-open/IAmzPromotionTaskApi/qryUploadResultUsingPOST

