任务描述


需求描述

需求背景

目前战略部执行的智能运营策略,业务无法查看listing正在执行什么策略,现在需要提供战略部运营数据给到listing进行展示


需求内容

需要将目前战略部执行的运营数据通过接口给技术中心获取数据,并展示到listingV2页面,涉及服务:优惠券、促销调价、层级促销、专享折扣、日本积分


1、优惠券:只返回优惠券提交状态成功的(UploadStatus=1)

目前已有接口提供不调整,重新新增一个接口

入参:来源渠道ID、ASIN、优惠券开始时间、优惠券结束时间

出参:来源渠道ID、渠道SKU、ASIN、SKU、优惠券策略名称、优惠券ID、优惠券提交状态、优惠券生效状态、优惠券开始时间、优惠券结束时间、优惠券折扣

说明:

优惠券提交状态:展示系统优惠券的提交结果

优惠券生效状态:展示系统优惠券上传成功后,优惠券在亚马逊后台的实际生效结果


2、促销调价:只返回促销调价提交成功的(status=2)

入参:来源渠道ID、渠道SKU、ASIN、促销开始时间、促销结束时间

出参:来源渠道ID、渠道SKU、ASIN、SKU、促销调价策略名称、调价提交状态、促销开始时间、促销结束时间、促销折扣率、促销折后价、当一次折后价、是否修复原价、上一次原价、当前原价、企业价

说明:

当【是否修复原价】为:否,则上一次原价、当前原价、企业价:有值

当【是否修复原价】为:否,则上一次原价、企业价:为空


3、层级促销:只返回层级促销提交状态成功的(status=1)

入参:来源渠道ID、渠道SKU、ASIN、层级促销开始时间、层级促销时间

出参:来源渠道ID、渠道SKU、ASIN、SKU、层级促销策略名称、层级促销活动名称、层级促销ID、层级促销提交状态、层级促销开始时间、层级促销时间、层级促销折扣


4、专享折扣:只返回专享折扣提交状态成功的(status=2、4、9)

入参:来源渠道ID、渠道SKU、ASIN、专享折扣开始时间、专享折扣结束时间

出参:来源渠道ID、渠道SKU、ASIN、SKU、专享折扣策略名称、专享折扣ID、专享折扣提交状态、专享折扣上传结果(采集信息msg,只有status=9才会有数据)、专享折扣开始时间、专享折扣结束时间、专享折扣折扣、最低价、最低价百分比

说明:

专享折扣提交状态:展示系统专享折扣的提交结果

专享折扣生效状态:展示系统专享折扣上传成功后,专享折扣在亚马逊后台的实际生效结果


5、日本积分:只返回日本积分提交状态成功的(status=1)

入参:来源渠道ID、渠道SKU

出参:来源渠道ID、渠道SKU、ASIN、SKU、提交类型(全店铺、指定渠道sku)、日本积分策略名称、日本积分提交状态、提交时间、日本积分折扣

注意:日本积分需要先查询时间范围内是否有执行全店铺,如果有需要返回最新一条全店铺的记录;再按listing维度查时间范围内最新一条listing




新补充内容:


1、优惠券接口新作一个,之前的接口不改动。

2、以上五个接口,

出参字段:来源渠道ID、开始时间、结束时间是必填项;ASIN 、渠道SKU是非必填;开始时间只能在近15天以内的时间(日本积分除外)。

只给来源渠道ID,则根据时间范围查询该店铺里的所有ASIN/渠道SKU的记录数据;如果给来源渠道ID+ASIN/渠道SKU,则根据时间范围查询该店铺里的指定ASIN/渠道SKU的记录数据



验收标准
智能运营数据提供接口
历史记录  
  1. 2024-01-02 13:32:37, 由 罗友军 创建。
  2. 2024-01-08 09:59:10, 由 梁文立 完成。
    修改了 总计消耗,旧值为 "0",新值为 "16"。
    修改了 指派给 ,旧值为 "liangwenli",新值为 "luoyoujun"。
    修改了 实际完成,旧值为 "",新值为 "2024-01-04 17:56:37"。
    修改了 任务状态,旧值为 "wait",新值为 "done"。
    修改了 实际开始,旧值为 "0000-00-00 00:00:00",新值为 "2024-01-04 18:04:22"。
    修改了 预计剩余,旧值为 "16",新值为 "0"。
    修改了 由谁完成,旧值为 "",新值为 "liangwenli"。

    1、分支代码【develop-wenli-61810】


    2、注意项

    2.1 日本积分,因为策略可以是很久之前设置的,所以不能有时间范围的条件。

    先找来源渠道全店铺的最新1条。然后再找listing最新的1条。


    3、主要代码

    3.1 增加5个接口,先进行参数校验

    3.2 获取数据后,对数据进行转换为需要的实体。同时返回MaxId


    3.3 日本积分的主要代码,没有翻页,先找来源渠道,全店铺最新的1条,然后找listing最新的1条。

  3. 2024-01-15 09:49:32, 由 梁文立 确认需求变动,最新版本为#12。
  4. 2024-01-31 20:59:00, 由 刘霞 编辑。
    修改了 最初预计,旧值为 "16",新值为 "22"。
所属迭代 智能中心-智能刊登迭代
所属模块 智能中心-需求池  战略独立项目   智能刊登
相关需求 智能运营数据提供接口
指派给 罗友军 于 2024-01-04 18:04:22
任务类型 后端
任务标签 初始
开发组 仓储物流开发组
任务状态 已完成
进度 100%
优先级 P0
关键词
抄送给
由谁创建 罗友军 于 2024-01-02 13:32:37
由谁完成 梁文立 于 2024-01-04 17:56:37
由谁取消 暂无
由谁关闭 暂无
关闭原因 暂无
最后编辑 刘霞 于 2024-01-31 20:59:00
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 22工时
总计消耗 16工时
预计剩余 0工时
预计开始 2024-01-02
实际开始 2024-01-04
截止日期 2024-01-31