任务描述


需求描述

需求背景

现在优惠券提报需要统一提报入口,方便数据管理与避免重复执行


需求内容

对接优惠券队列新接口,同时保留当前原有程序服务。

前期测试联调流程:支持指定来源渠道配置,通过新接口提报优惠券任务;

后期全部切换到新接口:新增开关控制,用于可快速切换回原有程序服务提交任务



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



5.优惠券重构



验收标准
优惠券对接技术中心提报优惠券
历史记录  
  1. 2024-06-17 15:26:53, 由 罗友军 创建。
  2. 2024-07-01 10:54:29, 由 罗友军 编辑。
    修改了 指派给,旧值为 "liuxuesen",新值为 "shanglei"。
  3. 2024-07-08 13:42:48, 由 商雷 指派给 罗友军。
    修改了 指派给,旧值为 "shanglei",新值为 "luoyoujun"。
    需求已取消不做
  4. 2024-08-15 09:38:14, 由 罗友军 取消。
    修改了 任务状态,旧值为 "wait",新值为 "cancel"。
    修改了 实际完成,旧值为 "",新值为 "0000-00-00"。
    修改了 由谁取消,旧值为 "",新值为 "luoyoujun"。
    修改了 取消时间,旧值为 "",新值为 "2024-08-15 09:38:14"。
所属迭代 智能中心-智能刊登迭代
所属模块 智能中心-需求池  战略独立项目   智能刊登
相关需求 优惠券对接技术中心
指派给 罗友军 于 2024-08-15 09:38:14
任务类型 后端
任务标签 初始
开发组
任务状态 已取消
进度 0%
优先级 P0
关键词
抄送给
由谁创建 罗友军 于 2024-06-17 15:26:53
由谁完成 暂无
由谁取消 罗友军 于 2024-08-15 09:38:14
由谁关闭 暂无
关闭原因 暂无
最后编辑 罗友军 于 2024-08-15 09:38:14
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 40工时
总计消耗 0工时
预计剩余 40工时
预计开始 2024-06-17
实际开始 0000-00-00
截止日期 2024-06-30