STORY #13310 Amazon运营平台-重构v0.1：listing管理、数据结构 - 技术中心-需求池

业务需求

需求描述

验收标准

价值描述

对亚马逊的数据结构进行重构

附件

历史记录

2023-01-09 18:11:52, 由 zhangcehong 创建。
2023-01-09 18:15:16, 由 zhangcehong 记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2023-01-09"。
修改了 指派给 ，旧值为 "Admin186"，新值为 "zhangcehong"。
修改了 当前状态，旧值为 "draft"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "zhangcehong"。
2023-01-09 18:21:30, 由 zhangcehong 编辑。
修改了 所属计划，旧值为 ""，新值为 "704"。
修改了 更新点 ，旧值为 "point"，新值为 ""。
修改了 所处阶段，旧值为 "wait"，新值为 "planned"。
2023-01-09 18:31:55, 由李冠关联到迭代 亚马逊listing重构 。
2023-01-09 18:52:58, 由 zhangcehong 变更。
修改了 当前状态，旧值为 "active"，新值为 "changed"。
修改了 版本号 ，旧值为 "1"，新值为 "2"。
修改了 由谁评审，旧值为 "zhangcehong"，新值为 ""。
修改了 评审时间，旧值为 "2023-01-09"，新值为 "0000-00-00"。
修改了 需求描述，区别为：
001-
001+ 需求背景
002+ 一、重构亚马逊listing，保证搞可用性、扩展性的数据结构与产品架构，并解决卡顿问题
003+ 需求描述
004+ 一、功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】
005+
006+ 二、功能点2：数据同步逻辑
007+ （一）同步listing基础数据
008+ 第一步1、1天/次，获取所有listing涉及API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference【获取“All Listings Report”】第二步1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表PS、目的：保证数据实时性、同时减少数据拉取量
009+ （二）更新本地listing数据
010+ 1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数”PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互
011+ （三）修改FBM的可售库存、修改FBM\FBA的价格
012+ 1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】
013+ 三、功能点3：listing管理【见原型】

001-
001+ <h1>需求背景</h1>
002+ 一、重构亚马逊listing，保证搞可用性、扩展性的数据结构与产品架构，并解决卡顿问题
003+ <h1>需求描述</h1>
004+ 一、功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】
005+ 
006+ 二、功能点2：数据同步逻辑
007+ （一）同步listing基础数据
008+ 第一步 1、1天/次，获取所有listing 涉及API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference【获取“All Listings Report”】 第二步 1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】 2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态 3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表 PS、目的：保证数据实时性、同时减少数据拉取量 
009+ （二）更新本地listing数据
010+ 1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据 2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数” PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】 PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互 
011+ （三）修改FBM的可售库存、修改FBM\FBA的价格
012+ 1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口 PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】 
013+ 三、功能点3：listing管理【见原型】
2023-01-09 18:53:08, 由 zhangcehong 记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2023-01-09"。
修改了 当前状态，旧值为 "changed"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "zhangcehong"。
2023-01-11 10:40:22, 由 zhangcehong 编辑。
修改了 所属模块，旧值为 "1678"，新值为 "1813"。
2023-01-11 10:47:24, 由胡凯关联到迭代 开发项目部 - 亚马逊 - 迭代1 。
2023-01-11 12:12:26, 由 zhangcehong 变更。
修改了 当前状态，旧值为 "active"，新值为 "changed"。
修改了 版本号 ，旧值为 "2"，新值为 "3"。
修改了 由谁评审，旧值为 "zhangcehong"，新值为 ""。
修改了 评审时间，旧值为 "2023-01-09"，新值为 "0000-00-00"。
修改了 需求描述，区别为：
004- ~~一、功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】~~
004+ 功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】
005-
005+ 功能点2：数据同步逻辑
006- ~~二、功能点2：数据同步逻辑~~
006+ 一、第一步：获取“待获取实时数据”的listing队列
007- ~~（一）同步listing基础数据~~
007+ （一）场景“迁入新店铺、功能上线数据初始化、每月数据校准”：全量获取“All Listings Report”【API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference】
008- 第一步1、1天/次，获取所有listing涉及API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference【获取“All Listings Report”】第二步1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表PS、目的：保证数据实时性、同时减少数据拉取量
008+ 1、每月数据校准：每月1月3日中国时间19点（美国时间凌晨4点）执行
009- ~~（二）更新本地listing数据~~
009+
010- 1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数”PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互
010+ （二）场景“日常运营”：增量数据同步1、listing参数变化-数据更新：数据源如下、更新逻辑见流程图【目的：保证listing参数与亚马逊后台同步】①库存1）FBA的SKU：NOTIFICATIONS API “FBA_INVENTORY_AVAILABILITY_CHANGES”2）FBM的SKU2.1）新系统改动的数据更新：本地任务“本地listing数据更新”2.2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖订单、人为调整引起的变化，但时效性低-24h/次更新】
011- ~~（三）修改FBM的可售库存、修改FBM\FBA的价格~~
011+ ②价格
012- 1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】
012+ 1）新系统改动的数据更新：本地任务“本地listing数据更新”2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖人为调整引起的变化，但时效性低-24h/次更新】③状态：NOTIFICATIONS API “LISTINGS_ITEM_STATUS_CHANGE”1）status是返回一个状态数组，包含枚举buyable、discoverable、deleted；返回buyable意为可购买，不返回buyable意为不可购买，返回discoverable意为可见，不返回discoverable意为不可见，返回deleted意为该listing将被删除2）示例：意为“可购买、可见”"Status": [ "BUYABLE", "DISCOVERABLE"③状态对应Status=BUYABLE、DISCOVERABLE，listing_status=在售Status=DISCOVERABLE，listing_status=售完Status=DELETED，listing_status=删除
013- ~~三、功能点3：listing管理【见原型】~~
013+ ④商品名、商品描述、主图：NOTIFICATIONS API “BRANDED_ITEM_CONTENT_CHANGE”PS、报告状态：NOTIFICATIONS API “REPORT_PROCESSING_FINISHED”
014+ PS、接口
015+ NOTIFICATIONS API：https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-reference
016+ REPORTS API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference
017+
018+
019+ 2、有销量渠道SKU-数据更新【目的：保证相对较高的实时性；有销量SKU对价格、可售数的数据时效性要求更高、有销量SKU不一定发生了价格变动】
020+ ①每天6点、12点、18点、24点，获取亚马逊当天有销量的渠道SKU
021+ 1）数据源：ERP，RB_Report_OrderSourceSKUDay
022+ 1.1）该表数据更新频率：4次/天1.2）OrderSourceID=1，为亚马逊平台；OrderSourceSKU，为渠道SKU；SalesNum为销售数量
023+
024+ ②处理逻辑
025+ 1）获取“OrderSourceID=1、SalesNum≠0、SalesDay=当天”的渠道SKU
026+ 2）对比：本次SalesNum是否与今日、上次的值一致3）如果一致，则过滤掉此渠道SKU
027+ 4）如果不一致，则将渠道SKU记录到“待获取实时数据”listing队列
028+
029+ 二、第二步：获取实时数据
030+ 1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表
031+ PS、目的：保证数据实时性、同时减少数据拉取量
032+
033+ 三、更新本地listing数据
034+ 1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数”PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互
035+
036+ 四、修改FBM的可售库存、修改FBM\FBA的价格
037+ 1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】
038+ 功能点3：listing管理【见原型】

004- ~~一、功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】~~
004+ <h2>功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】</h2>
005- ~~ ~~
005+ 功能点2：数据同步逻辑
006- ~~二、功能点2：数据同步逻辑~~
006+ 一、第一步：获取“待获取实时数据”的listing队列
007- ~~（一）同步listing基础数据~~
007+ （一）场景“迁入新店铺、功能上线数据初始化、每月数据校准”：全量获取“All Listings Report”【API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference】
008- 第一步 1、1天/次，获取所有listing 涉及API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference【获取“All Listings Report”】 第二步 1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】 2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态 3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表 PS、目的：保证数据实时性、同时减少数据拉取量 
008+ 1、每月数据校准：每月1月3日中国时间19点（美国时间凌晨4点）执行
009- ~~（二）更新本地listing数据~~
009+ 
010- 1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据 2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数” PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】 PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互 
010+ （二）场景“日常运营”：增量数据同步 1、listing参数变化-数据更新：数据源如下、更新逻辑见流程图【目的：保证listing参数与亚马逊后台同步】 ①库存 1）FBA的SKU：NOTIFICATIONS API “FBA_INVENTORY_AVAILABILITY_CHANGES” 2）FBM的SKU 2.1）新系统改动的数据更新：本地任务“本地listing数据更新” 2.2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖订单、人为调整引起的变化，但时效性低-24h/次更新】
011- ~~（三）修改FBM的可售库存、修改FBM\FBA的价格~~
011+ ②价格
012- 1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口 PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】 
012+ 1）新系统改动的数据更新：本地任务“本地listing数据更新” 2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖人为调整引起的变化，但时效性低-24h/次更新】 ③状态：NOTIFICATIONS API “LISTINGS_ITEM_STATUS_CHANGE” 1）status是返回一个状态数组，包含枚举buyable、discoverable、deleted； 返回buyable意为可购买，不返回buyable意为不可购买， 返回discoverable意为可见，不返回discoverable意为不可见， 返回deleted意为该listing将被删除 2）示例：意为“可购买、可见” "Status": [ "BUYABLE", "DISCOVERABLE" ③状态对应 Status=BUYABLE、DISCOVERABLE，listing_status=在售 Status=DISCOVERABLE，listing_status=售完 Status=DELETED，listing_status=删除
013- ~~三、功能点3：listing管理【见原型】~~
013+ ④商品名、商品描述、主图：NOTIFICATIONS API “BRANDED_ITEM_CONTENT_CHANGE” PS、报告状态：NOTIFICATIONS API “REPORT_PROCESSING_FINISHED” 
014+ PS、接口
015+ NOTIFICATIONS API：https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-reference 
016+ REPORTS API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference
017+ 
018+ 
019+ 2、有销量渠道SKU-数据更新【目的：保证相对较高的实时性；有销量SKU对价格、可售数的数据时效性要求更高、有销量SKU不一定发生了价格变动】
020+ ①每天6点、12点、18点、24点，获取亚马逊当天有销量的渠道SKU
021+ 1）数据源：ERP，RB_Report_OrderSourceSKUDay
022+ 1.1）该表数据更新频率：4次/天 1.2）OrderSourceID=1，为亚马逊平台；OrderSourceSKU，为渠道SKU；SalesNum为销售数量
023+ <img src="{237070.png}" alt="" />
024+ ②处理逻辑
025+ 1）获取“OrderSourceID=1、SalesNum≠0、SalesDay=当天”的渠道SKU
026+ 2）对比：本次SalesNum是否与今日、上次的值一致 3）如果一致，则过滤掉此渠道SKU
027+ 4）如果不一致，则将渠道SKU记录到“待获取实时数据”listing队列
028+ 
029+ 二、第二步：获取实时数据
030+ 1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】 2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态 3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表
031+ PS、目的：保证数据实时性、同时减少数据拉取量
032+ 
033+ 三、更新本地listing数据
034+ 1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据 2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数” PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】 PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互
035+ 
036+ 四、修改FBM的可售库存、修改FBM\FBA的价格
037+ 1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口 PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】
038+ <h2>功能点3：listing管理【见原型】</h2>

上传了附件 1、流程图.vsdx,1、Amazon listing详情数据.xlsx
2023-01-11 12:12:40, 由 zhangcehong 删除了附件：1、流程图.vsdx。
2023-01-11 12:12:42, 由 zhangcehong 删除了附件：1、Amazon listing详情数据.xlsx。
2023-01-12 17:03:20, 由 zhangcehong 变更。
修改了 版本号 ，旧值为 "3"，新值为 "4"。
修改了 需求描述，区别为：
038- ~~功能点3：listing管理【见原型】~~
038+
039+
040+ 五、销售&店铺，对照关系
041+ （一）调研内容&调研结论&方案确认
042+ 1、行为：销售会每月统计“正常运营的店铺、店铺负责人变更-店铺A负责人变更为C”
043+ 2、问题：销售去系统更新店铺负责人不及时，导致2类情况，C在listing页，搜自己搜不出“店铺&lsiting”、搜店铺&lsiting“名字不是自己”
044+ 3、不及时、没法确定时间的原因&当前解决方案：
045+ ①C的工作规划如果是本月15号开始做这个店铺，15号再改负责人也没问题
046+ ②操作时，看到不是自己名字，会汇报给上级去刷
047+ ③销售一般是月度调整，因为涉及业绩统计
048+ 4、listing/渠道SKU授权：B把店铺中的SKU授权给C，业务意义为“店长背负整个SKU业绩考核，店员分担”【当前考核方式：某几个SKU由C卖，可以刊登到C负责的店铺去（具体上架到哪些店铺：部分有要求），来完成对此SKU的业绩考核】
049+ ①店铺负责人不是C，B把其中的渠道SKU授权给C，能看到listing
050+ ②授权listing/渠道SKU后，会授权SKU权限
051+ ③SKU权限+店铺权限=渠道SKU（能看哪些listing）。与身份无关-店铺负责人、渠道SKU负责人
052+ 5、小结：当前解决方案、销售操作无问题。梳理出了最新对照关系，没改因为不需要改
053+ 6、结论：新listing页的“销售&店铺对照关系”：以系统的对照关系
054+ （二）方案：“订单来源渠道管理”，取“来源渠道类型=亚马逊”的数据“首选业务员”是销售“渠道名称/真实店铺名称”是店铺
055+
056+
057+ 功能点3：listing管理【见原型】

038- ~~<h2>功能点3：listing管理【见原型】</h2>~~
038+ 
039+ 
040+ 五、销售&店铺，对照关系
041+ （一）调研内容&调研结论&方案确认
042+ 1、行为：销售会每月统计“正常运营的店铺、店铺负责人变更-店铺A负责人变更为C”
043+ 2、问题：销售去系统更新店铺负责人不及时，导致2类情况，C在listing页，搜自己搜不出“店铺&lsiting”、搜店铺&lsiting“名字不是自己”
044+ 3、不及时、没法确定时间的原因&当前解决方案：
045+ ①C的工作规划如果是本月15号开始做这个店铺，15号再改负责人也没问题
046+ ②操作时，看到不是自己名字，会汇报给上级去刷
047+ ③销售一般是月度调整，因为涉及业绩统计
048+ 4、listing/渠道SKU授权：B把店铺中的SKU授权给C，业务意义为“店长背负整个SKU业绩考核，店员分担”【当前考核方式：某几个SKU由C卖，可以刊登到C负责的店铺去（具体上架到哪些店铺：部分有要求），来完成对此SKU的业绩考核】
049+ ①店铺负责人不是C，B把其中的渠道SKU授权给C，能看到listing
050+ ②授权listing/渠道SKU后，会授权SKU权限
051+ ③SKU权限+店铺权限=渠道SKU（能看哪些listing）。与身份无关-店铺负责人、渠道SKU负责人
052+ 5、小结：当前解决方案、销售操作无问题。梳理出了最新对照关系，没改因为不需要改
053+ 6、结论：新listing页的“销售&店铺对照关系”：以系统的对照关系
054+ （二）方案：“订单来源渠道管理”，取“来源渠道类型=亚马逊”的数据“首选业务员”是销售“渠道名称/真实店铺名称”是店铺
055+ <img src="{237561.png}" alt="" />
056+ 
057+ <h2>功能点3：listing管理【见原型】</h2>
2023-01-14 14:19:39, 由 zhangcehong 删除了附件：1、流程图.vsdx。
2023-01-14 14:19:41, 由 zhangcehong 删除了附件：1、Amazon listing详情数据.xlsx。
2023-01-14 14:20:07, 由 zhangcehong 变更。
修改了 需求描述，旧值为 "
需求背景

一、重构亚马逊listing，保证搞可用性、扩展性的数据结构与产品架构，并解决卡顿问题

需求描述

功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】

功能点2：数据同步逻辑

一、第一步：获取“待获取实时数据”的listing队列

（一）场景“迁入新店铺、功能上线数据初始化、每月数据校准”：全量获取“All Listings Report”【API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference】

1、每月数据校准：每月1月3日中国时间19点（美国时间凌晨4点）执行

（二）场景“日常运营”：增量数据同步
1、listing参数变化-数据更新：数据源如下、更新逻辑见流程图【目的：保证listing参数与亚马逊后台同步】
①库存
1）FBA的SKU：NOTIFICATIONS API “FBA_INVENTORY_AVAILABILITY_CHANGES”
2）FBM的SKU
2.1）新系统改动的数据更新：本地任务  “本地listing数据更新”
2.2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖订单、人为调整引起的变化，但时效性低-24h/次更新】

②价格

1）新系统改动的数据更新：本地任务  “本地listing数据更新”
2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖人为调整引起的变化，但时效性低-24h/次更新】
③状态：NOTIFICATIONS API “LISTINGS_ITEM_STATUS_CHANGE”
1）status是返回一个状态数组，包含枚举buyable、discoverable、deleted；
返回buyable意为可购买，不返回buyable意为不可购买，
返回discoverable意为可见，不返回discoverable意为不可见，
返回deleted意为该listing将被删除
2）示例：意为“可购买、可见”
"Status": [
"BUYABLE",
"DISCOVERABLE"
③状态对应
Status=BUYABLE、DISCOVERABLE，listing_status=在售
Status=DISCOVERABLE，listing_status=售完
Status=DELETED，listing_status=删除

④商品名、商品描述、主图：NOTIFICATIONS API “BRANDED_ITEM_CONTENT_CHANGE”
PS、报告状态：NOTIFICATIONS API “REPORT_PROCESSING_FINISHED”

PS、接口

NOTIFICATIONS API：https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-reference

REPORTS API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference

2、有销量渠道SKU-数据更新【目的：保证相对较高的实时性；有销量SKU对价格、可售数的数据时效性要求更高、有销量SKU不一定发生了价格变动】

①每天6点、12点、18点、24点，获取亚马逊当天有销量的渠道SKU

1）数据源：ERP，RB_Report_OrderSourceSKUDay

1.1）该表数据更新频率：4次/天
1.2）OrderSourceID=1，为亚马逊平台；OrderSourceSKU，为渠道SKU；SalesNum为销售数量

②处理逻辑

1）获取“OrderSourceID=1、SalesNum≠0、SalesDay=当天”的渠道SKU

2）对比：本次SalesNum是否与今日、上次的值一致
3）如果一致，则过滤掉此渠道SKU

4）如果不一致，则将渠道SKU记录到“待获取实时数据”listing队列

二、第二步：获取实时数据

1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】
2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态
3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表

PS、目的：保证数据实时性、同时减少数据拉取量

三、更新本地listing数据

1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据
2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数”
PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】
PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互

四、修改FBM的可售库存、修改FBM\FBA的价格

1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口
PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】

五、销售&店铺，对照关系

（一）调研内容&调研结论&方案确认

1、行为：销售会每月统计“正常运营的店铺、店铺负责人变更-店铺A负责人变更为C”

2、问题：销售去系统更新店铺负责人不及时，导致2类情况，C在listing页，搜自己搜不出“店铺&lsiting”、搜店铺&lsiting“名字不是自己”

3、不及时、没法确定时间的原因&当前解决方案：

①C的工作规划如果是本月15号开始做这个店铺，15号再改负责人也没问题

②操作时，看到不是自己名字，会汇报给上级去刷

③销售一般是月度调整，因为涉及业绩统计

4、listing/渠道SKU授权：B把店铺中的SKU授权给C，业务意义为“店长背负整个SKU业绩考核，店员分担”【当前考核方式：某几个SKU由C卖，可以刊登到C负责的店铺去（具体上架到哪些店铺：部分有要求），来完成对此SKU的业绩考核】

①店铺负责人不是C，B把其中的渠道SKU授权给C，能看到listing

②授权listing/渠道SKU后，会授权SKU权限

③SKU权限+店铺权限=渠道SKU（能看哪些listing）。与身份无关-店铺负责人、渠道SKU负责人

5、小结：当前解决方案、销售操作无问题。梳理出了最新对照关系，没改因为不需要改

6、结论：新listing页的“销售&店铺对照关系”：以系统的对照关系

（二）方案：“订单来源渠道管理”，取“来源渠道类型=亚马逊”的数据“首选业务员”是销售“渠道名称/真实店铺名称”是店铺

功能点3：listing管理【见原型】
"，新值为 "
需求背景

一、重构亚马逊listing，保证搞可用性、扩展性的数据结构与产品架构，并解决卡顿问题

需求描述

功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】

功能点2：数据同步逻辑

一、第一步：获取“待获取实时数据”的listing队列

（一）场景“迁入新店铺、功能上线数据初始化、每月数据校准”：全量获取“All Listings Report”【API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference】

1、每月数据校准：每月1月3日中国时间19点（美国时间凌晨4点）执行

（二）场景“日常运营”：增量数据同步
1、listing参数变化-数据更新：数据源如下、更新逻辑见流程图【目的：保证listing参数与亚马逊后台同步】
①库存
1）FBA的SKU：NOTIFICATIONS API “FBA_INVENTORY_AVAILABILITY_CHANGES”
2）FBM的SKU
2.1）新系统改动的数据更新：本地任务  “本地listing数据更新”
2.2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖订单、人为调整引起的变化，但时效性低-24h/次更新】

②价格

1）新系统改动的数据更新：本地任务  “本地listing数据更新”
2）老系统、后台改动的数据更新：REPORTS API “GET_MERCHANT_LISTINGS_DATA”【问题：涵盖人为调整引起的变化，但时效性低-24h/次更新】
③状态：NOTIFICATIONS API “LISTINGS_ITEM_STATUS_CHANGE”
1）status是返回一个状态数组，包含枚举buyable、discoverable、deleted；
返回buyable意为可购买，不返回buyable意为不可购买，
返回discoverable意为可见，不返回discoverable意为不可见，
返回deleted意为该listing将被删除
2）示例：意为“可购买、可见”
"Status": [
"BUYABLE",
"DISCOVERABLE"
③状态对应
Status=BUYABLE、DISCOVERABLE，listing_status=在售
Status=DISCOVERABLE，listing_status=售完
Status=DELETED，listing_status=删除

④商品名、商品描述、主图：NOTIFICATIONS API “BRANDED_ITEM_CONTENT_CHANGE”
PS、报告状态：NOTIFICATIONS API “REPORT_PROCESSING_FINISHED”

PS、接口

NOTIFICATIONS API：https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-reference

REPORTS API：https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-reference

2、有销量渠道SKU-数据更新【目的：保证相对较高的实时性；有销量SKU对价格、可售数的数据时效性要求更高、有销量SKU不一定发生了价格变动】

①每天6点、12点、18点、24点，获取亚马逊当天有销量的渠道SKU

1）数据源：ERP，RB_Report_OrderSourceSKUDay

1.1）该表数据更新频率：4次/天
1.2）OrderSourceID=1，为亚马逊平台；OrderSourceSKU，为渠道SKU；SalesNum为销售数量

②处理逻辑

1）获取“OrderSourceID=1、SalesNum≠0、SalesDay=当天”的渠道SKU

2）对比：本次SalesNum是否与今日、上次的值一致
3）如果一致，则过滤掉此渠道SKU

4）如果不一致，则将渠道SKU记录到“待获取实时数据”listing队列

二、第二步：获取实时数据

1、1h、4h/次，获取实时数据，用“在售、已下架、不可售”状态listing的MSKU批量获取listing详情数据&并落库【https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#getlistingsitem】
2、本接口返回的“状态”，如果不等于上一个接口的状态，则以此接口状态，更新listing状态
3、本接口返回的FBM_Listing、FBA_Listing的“可售库存、价格”，更新到本地listing表

PS、目的：保证数据实时性、同时减少数据拉取量

三、更新本地listing数据

1、从“listing管理”调用feeds-API-上传“价格、可售数”模板（见文件夹“价格、可售数模板”）来调整“价格、可售数”，收到异步回执“成功”，则按成功的数据更新本地listing的“价格、可售数”数据
2、1h/次，获取亚马逊订单-各SKU数量（记录该SKU对应的listing），再根据SKU数量，更新对应本地listing的“可售数”
PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】
PS、设计目的：价格、可售数主要依赖本地listing的数据更新，减少与平台交互

四、修改FBM的可售库存、修改FBM\FBA的价格

1、文本框失焦时，判断是否与原值有差异，有差异则以该listing，调用刊登接口
PS、涉及API：https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-use-case-guide【刊登接口】

五、销售&店铺，对照关系

（一）调研内容&调研结论&方案确认

1、行为：销售会每月统计“正常运营的店铺、店铺负责人变更-店铺A负责人变更为C”

2、问题：销售去系统更新店铺负责人不及时，导致2类情况，C在listing页，搜自己搜不出“店铺&lsiting”、搜店铺&lsiting“名字不是自己”

3、不及时、没法确定时间的原因&当前解决方案：

①C的工作规划如果是本月15号开始做这个店铺，15号再改负责人也没问题

②操作时，看到不是自己名字，会汇报给上级去刷

③销售一般是月度调整，因为涉及业绩统计

4、listing/渠道SKU授权：B把店铺中的SKU授权给C，业务意义为“店长背负整个SKU业绩考核，店员分担”【当前考核方式：某几个SKU由C卖，可以刊登到C负责的店铺去（具体上架到哪些店铺：部分有要求），来完成对此SKU的业绩考核】

①店铺负责人不是C，B把其中的渠道SKU授权给C，能看到listing

②授权listing/渠道SKU后，会授权SKU权限

③SKU权限+店铺权限=渠道SKU（能看哪些listing）。与身份无关-店铺负责人、渠道SKU负责人

5、小结：当前解决方案、销售操作无问题。梳理出了最新对照关系，没改因为不需要改

6、结论：新listing页的“销售&店铺对照关系”：以系统的对照关系

（二）方案：“订单来源渠道管理”，取“来源渠道类型=亚马逊”的数据“首选业务员”是销售“渠道名称/真实店铺名称”是店铺

功能点3：listing管理【见原型】
"。
修改了 版本号 ，旧值为 "4"，新值为 "5"。

上传了附件 1、Amazon listing详情数据.xlsx,1、流程图.vsdx
2023-02-10 13:58:21, 由 王晓洛 验收。
修改了 所处阶段 ，旧值为 "projected"，新值为 "verified"。
修改了 设置阶段者，旧值为 ""，新值为 "wangxiaoluo"。
2023-02-21 13:48:02, 由胡凯关联到迭代 开发项目部 - 亚马逊 - 迭代2 。
2023-02-21 13:48:09, 由胡凯验收。
修改了 设置阶段者，旧值为 "wangxiaoluo"，新值为 "hukai"。
2023-05-13 16:20:18, 由周杰关闭，原因为 已完成 。
修改了 关闭原因，旧值为 ""，新值为 "done"。
修改了 当前状态，旧值为 "changed"，新值为 "closed"。
修改了 指派给 ，旧值为 "zhangcehong"，新值为 "closed"。
修改了 所处阶段，旧值为 "verified"，新值为 "closed"。
修改了 关闭日期，旧值为 "0000-00-00 00:00:00"，新值为 "2023-05-13 16:20:18"。
修改了 由谁关闭，旧值为 ""，新值为 "zhoujie"。

基本信息
需求的一生

迭代版本	2022年12月第2个迭代
提报业务部门
提报人员	公司
需求来源	需求缺陷优化
所属项目	技术中心-需求池
所属模块	亚马逊
所属计划
业务价值
开发组
受益业务部门	亚马逊平台运营中心
验收人员
业务目标类型
中心业务目标
业务价值	提升人效
每月价值量	1
每月节省人数	0
优先级	P1
价值类型
预计工时	40
成本
ROI
操作手册	否
高价值
主被动
复杂度
工作流ID
工作流创建时间
更新点
是否高危	否
评分
当前状态	已关闭
所处阶段	已关闭
关键词
评审次数
计划上线
上线时间
计划验收时间
业务验收时间
满意度
价值验收
满意度分值
业务回填价值
验收达成价值
验收达成ROI
抄送给	李冠

由谁创建	zhangcehong 于 2023-01-09 18:11:52
指派给	Closed 于 2023-05-13 16:20:18
由谁评审
评审时间
由谁关闭	周杰于 2023-05-13 16:20:18
关闭原因	已完成
最后修改	周杰于 2023-05-13 16:20:18

迭代任务
相关信息

相关Bug	[B] #34138 发送生成listing在线报告，请求失败 [B] #34142 listing同步下来的数据缺失，比亚马逊后台下载的在线报告数据少 [B] #34143 listing管理页面没有数据，表里面是有的 [B] #34144 listing表发货方式没有值，亚马逊在售报告是有的 [B] #34161 listing管理页面的产品状态与ERP的listing页面不一样 [B] #34177 listing管理页面，1. 点击第几页，页面数据没有变化，2. 点击展示多少行，数据总量没有变化 [B] #34182 listing同步下来的数据，在我们的listing表没有，在亚马逊后台是存在的 [B] #34250 批量解析数据，部分队列生成失败或者下载失败
相关用例	[C] #52828 页面操作listing--查询 [C] #52829 页面操作lisngting---列表 [C] #52830 全量同步亚马逊listing数据 [C] #52831 亚马逊listing增量同步 [C] #52832 亚马逊listing更新同步
相关需求
细分需求

需求背景

需求描述

功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】

功能点3：listing管理【见原型】

需求背景

需求描述

功能点1：搭建数据结构&取值【见文档“Amazon listing详情数据”】

功能点3：listing管理【见原型】