任务描述

【数据库 -- 表设计】


【业务设计 -- 业务逻辑设计,梳理 】


官方文档显示:GetOrderBuyerInfo,GetOrderAddress和GetOrderItemsBuyerInfo操作计划于2022年1月12日弃用



一、调用接口调整 -- API SDK 查看附件


文档:https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md


1. getOrderBuyerInfo 与 getOrderAddress 合并到 getOrders ,即调整后不用调用 getOrderBuyerInfo 与 getOrderAddress

2. getOrderItemsBuyerInfo 合并到 getOrderItems,即调整后不用调用  getOrderItemsBuyerInfo


二、受限数据令牌(RDT)-- API SDK 查看附件


文档:https://github.com/amzn/selling-partner-api-docs/blob/main/guides/zh-CN/use-case-guides/tokens-api-use-case-guide/tokens-API-use-case-guide-2021-03-01(%E4%B8%AD%E6%96%87).md


getOrders 与  getOrderItemsBuyerInfo 都属于受限数据操作


AccessToken 需要使用 RDT



三、请求上报


参考 SDK 项目: http://192.168.200.253:808/svn/Irobotbox2020/IrobotBoxFrameworkCore/IrobotBox.Amazon.Sdk/IrobotBox.Amazon.Sdk.Net4.0


【风险识别 -- 性能,并发,扩展】


【注意事项 -- 编码规范、可能存在Bug、风险和业务关联】


1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试

2. 注意对比合并后,是否有对应的信息,例如 getOrderBuyerInfo 有数据,但getOrders对应的买家信息是空的

需求描述

1.    需求概述

1.1. 背景

现有亚马逊订单下载接口为,先获取订单信息,再获取买家信息;升级后的接口,将买家信息获取整合到订单信息获取中,减少请求次数,同步进行升级;


订单接口api地址:https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitems


2.    功能设计

2.1. 订单接口更新

2.1.1 需求说明

旧接口:先调用ListOrders方法,再调用getOrderBuyerInfo、getOrderAddress


新接口:直接调用getOrders方法,获取全部数据



2.1. 订单产品接口更新

2.1.1 需求说明

旧接口:先调用ListOrderItems方法,再调用getOrderItemsBuyerInfo


新接口:直接调用getOrderItems方法,获取所有订单产品数据



验收标准
暂无
子任务
任务ID P 任务名称 截止日期 指派给 任务状态 消耗(h) 剩余(h) 操作
23136 P2 【订单】Amazon接口升级 --订单下载接口调整 0000-00-00 maojinqiang 已完成 22 0
23137 P2 【订单】Amazon接口升级 --代码审查 0000-00-00 maojinqiang 已完成 1 0
23143 P2 【订单】Amazon接口升级--请求上报 0000-00-00 maojinqiang 已完成 8 0
附件
历史记录  
  1. 2021-12-04 09:34:25, 由 maojinqiang 创建。
  2. 2021-12-04 09:52:01, 由 maojinqiang 编辑。
    修改了 任务描述,区别为:
    005- 【风险识别--性能,并发,扩展】
    005+ 官方文档显示:GetOrderBuyerInfo,GetOrderAddress和GetOrderItemsBuyerInfo操作计划于2022年1月12日弃用
    007- 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    007+
    008+
    009+ 一、调用接口的调整:
    010+
    011+ 文档:<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md" target="_blank" rel="noreferrer noopener">https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md
    012+
    013+ 1.<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo与<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderaddress">getOrderAddress合并到<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders,即调整后不用调用<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo与<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderaddress">getOrderAddress2.<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitemsbuyerinfo">getOrderItemsBuyerInfo合并到<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitems">getOrderItems,即调整后不用调用<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitemsbuyerinfo">getOrderItemsBuyerInfo
    014+
    015+ 二、受限数据令牌(RDT)
    016+
    017+ 文档:<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/guides/zh-CN/use-case-guides/tokens-api-use-case-guide/tokens-API-use-case-guide-2021-03-01(%E4%B8%AD%E6%96%87).md" target="_blank" rel="noreferrer noopener">https://github.com/amzn/selling-partner-api-docs/blob/main/guides/zh-CN/use-case-guides/tokens-api-use-case-guide/tokens-API-use-case-guide-2021-03-01(%E4%B8%AD%E6%96%87).md
    018+
    019+ <a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders与<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitemsbuyerinfo">getOrderItemsBuyerInfo都属于受限数据操作
    020+
    021+ AccessToken 需要使用 RDT
    022+
    023+ 【风险识别--性能,并发,扩展】
    024+
    025+ 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    026+
    027+ 1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试2. 注意对比合并后,是否有对应的信息,例如<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo有数据,但<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders对应的买家信息是空的
    005- <p>【风险识别--性能,并发,扩展】</p>
    005+ <p>官方文档显示:<span style="color:#333333;">GetOrderBuyerInfo,GetOrderAddress和GetOrderItemsBuyerInfo操作计划于2022年1月12日弃用</span></p>
    007- <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    007+ <p><img src="{173681.png}" alt="" /></p>
    008+ <p><br /></p>
    009+ <p>一、调用接口的调整:</p>
    010+ <p><br /></p>
    011+ <p>文档:<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md" target="_blank" rel="noreferrer noopener">https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md</a></p>
    012+ <p><br /></p>
    013+ <p>1.<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo</a>与<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderaddress">getOrderAddress</a>合并到<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders</a>,即调整后不用调用<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo</a><span>与</span><a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderaddress">getOrderAddress</a><br /><br />2.<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitemsbuyerinfo">getOrderItemsBuyerInfo</a>合并到<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitems">getOrderItems</a>,即调整后不用调用<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitemsbuyerinfo">getOrderItemsBuyerInfo</a></p>
    014+ <p><br /></p>
    015+ <p>二、受限数据令牌(RDT)</p>
    016+ <p><br /></p>
    017+ <p>文档:<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/guides/zh-CN/use-case-guides/tokens-api-use-case-guide/tokens-API-use-case-guide-2021-03-01(%E4%B8%AD%E6%96%87).md" target="_blank" rel="noreferrer noopener">https://github.com/amzn/selling-partner-api-docs/blob/main/guides/zh-CN/use-case-guides/tokens-api-use-case-guide/tokens-API-use-case-guide-2021-03-01(%E4%B8%AD%E6%96%87).md</a></p>
    018+ <p><br /></p>
    019+ <p><a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders</a><span>与<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderitemsbuyerinfo">getOrderItemsBuyerInfo</a>都属于受限数据操作</span></p>
    020+ <p><br /></p>
    021+ <p>AccessToken 需要使用 RDT</p>
    022+ <p><br /></p>
    023+ <p>【风险识别--性能,并发,扩展】</p>
    024+ <p><br /></p>
    025+ <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    026+ <p><br /></p>
    027+ <p>1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试<br /><br />2. 注意对比合并后,是否有对应的信息,例如<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo</a><span>有数据,但<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders</a>对应的买家信息是空的<br /><br /></span></p>
  3. 2021-12-04 09:54:06, 由 maojinqiang 编辑。
    修改了 父任务 ,旧值为 "0",新值为 "-1"。
    修改了 最初预计,旧值为 "14",新值为 "24"。
    修改了 预计剩余,旧值为 "14",新值为 "24"。
  4. 2021-12-04 09:54:06, 由 maojinqiang 创建子任务 #23136 【订单】Amazon接口升级 --订单下载接口调整 , #23137 【订单】Amazon接口升级 --代码审查 。
    修改了 父任务 ,旧值为 "0",新值为 "-1"。
    修改了 最初预计,旧值为 "14",新值为 "24"。
    修改了 预计剩余,旧值为 "14",新值为 "24"。
  5. 2021-12-04 10:55:22, 由 maojinqiang 编辑。
    修改了 任务描述,区别为:
    007- <img src="/zentao/file-read-173681.png" alt="" />
    007+
    007- <p><img src="/zentao/file-read-173681.png" alt="" /></p>
    007+ <p><img src="{173681.png}" alt="" /></p>
    上传了附件 sales.zip
  6. 2021-12-04 10:57:22, 由 maojinqiang 编辑。
    修改了 任务描述,区别为:
    007- <img src="/zentao/file-read-173681.png" alt="" />
    007+
    023- 【风险识别--性能,并发,扩展】
    023+
    024-
    024+ 三、请求上报
    025- 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    025+
    026-
    026+ 参考 SDK 项目:http://192.168.200.253:808/svn/Irobotbox2020/IrobotBoxFrameworkCore/IrobotBox.Amazon.Sdk/IrobotBox.Amazon.Sdk.Net4.0
    027- 1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试2. 注意对比合并后,是否有对应的信息,例如<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo有数据,但<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders对应的买家信息是空的
    027+
    028+ 【风险识别--性能,并发,扩展】
    029+
    030+ 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    031+
    032+ 1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试2. 注意对比合并后,是否有对应的信息,例如<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo有数据,但<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders对应的买家信息是空的
    007- <p><img src="/zentao/file-read-173681.png" alt="" /></p>
    007+ <p><img src="{173681.png}" alt="" /></p>
    023- <p>【风险识别--性能,并发,扩展】</p>
    023+ <p><br /></p>
    024- <p><br /></p>
    024+ <p>三、请求上报</p>
    025- <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    025+ <p><br /></p>
    026- <p><br /></p>
    026+ <p>参考 SDK 项目:http://192.168.200.253:808/svn/Irobotbox2020/IrobotBoxFrameworkCore/IrobotBox.Amazon.Sdk/IrobotBox.Amazon.Sdk.Net4.0</p>
    027- <p>1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试<br /><br />2. 注意对比合并后,是否有对应的信息,例如<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo</a><span>有数据,但<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders</a>对应的买家信息是空的<br /><br /></span></p>
    027+ <p><br /></p>
    028+ <p>【风险识别--性能,并发,扩展】</p>
    029+ <p><br /></p>
    030+ <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    031+ <p><br /></p>
    032+ <p>1. 单独新建一个订单下载类,届时用部分商户验证,实现AB测试<br /><br />2. 注意对比合并后,是否有对应的信息,例如<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorderbuyerinfo">getOrderBuyerInfo</a><span>有数据,但<a href="https://github.com/amzn/selling-partner-api-docs/blob/main/references/orders-api/ordersV0.md#getorders">getOrders</a>对应的买家信息是空的<br /><br /></span></p>
  7. 2021-12-04 10:58:44, 由 maojinqiang 编辑。
    修改了 任务描述,区别为:
    007- <img src="/zentao/file-read-173681.png" alt="" />
    007+
    009- 一、调用接口的调整:
    009+ 一、调用接口调整-- API SDK 查看附件
    015- 二、受限数据令牌(RDT)
    015+ 二、受限数据令牌(RDT)-- API SDK 查看附件
    007- <p><img src="/zentao/file-read-173681.png" alt="" /></p>
    007+ <p><img src="{173681.png}" alt="" /></p>
    009- <p>一、调用接口的调整:</p>
    009+ <p>一、调用接口调整<span>-- <strong>API SDK 查看附件</strong></span></p>
    015- <p>二、受限数据令牌(RDT)</p>
    015+ <p>二、受限数据令牌(RDT)<span>--<strong> API SDK 查看附件</strong></span></p>
  8. 2021-12-04 11:01:24, 由 maojinqiang 编辑。
    修改了 最初预计,旧值为 "24",新值为 "32"。
    修改了 预计剩余,旧值为 "24",新值为 "32"。
  9. 2021-12-04 11:01:24, 由 maojinqiang 创建子任务 #23143 【订单】Amazon接口升级--请求上报 。
    修改了 最初预计,旧值为 "24",新值为 "32"。
    修改了 预计剩余,旧值为 "24",新值为 "32"。
  10. 2021-12-04 11:03:06, 由 maojinqiang 编辑。
    修改了 最初预计,旧值为 "32",新值为 "34"。
    修改了 预计剩余,旧值为 "32",新值为 "34"。
  11. 2021-12-04 11:03:37, 由 maojinqiang 编辑。
    修改了 最初预计,旧值为 "34",新值为 "32"。
    修改了 预计剩余,旧值为 "34",新值为 "32"。
  12. 2021-12-06 15:54:48, 由 田子豪 确认需求变动,最新版本为#2。
  13. 2021-12-10 09:19:01, 由 liushaohua 启动。
    修改了 任务状态,旧值为 "wait",新值为 "doing"。
  14. 2021-12-17 16:42:35, 由 liushaohua 编辑。
    修改了 总计消耗,旧值为 "0",新值为 "8"。
    修改了 预计剩余,旧值为 "32",新值为 "24"。
  15. 2021-12-18 17:26:13, 由 liushaohua 编辑。
    修改了 总计消耗,旧值为 "8",新值为 "30"。
    修改了 预计剩余,旧值为 "24",新值为 "2"。
  16. 2021-12-24 18:39:08, 由 maojinqiang 完成。
    修改了 总计消耗,旧值为 "30",新值为 "31"。
    修改了 预计剩余,旧值为 "2",新值为 "0"。
    修改了 任务状态,旧值为 "doing",新值为 "done"。
    修改了 指派给 ,旧值为 "",新值为 "maojinqiang"。
    修改了 由谁完成,旧值为 "",新值为 "maojinqiang"。
    修改了 实际完成,旧值为 "0000-00-00 00:00:00",新值为 "2021-12-24 18:39:08"。
所属迭代 【主干】产品中心12月第二个版本(2021年)
所属模块 赛盒科技  赛盒ERP管理系统   订单组
相关需求 【订单】Amazon接口升级
指派给 毛金强 于 2021-12-24 18:39:08
任务类型 后端
任务标签 初始
开发组
任务状态 已完成
进度 100%
优先级 P2
关键词
抄送给
由谁创建 maojinqiang 于 2021-12-04 09:34:25
由谁完成 maojinqiang 于 2021-12-24 18:39:08
由谁取消 暂无
由谁关闭 暂无
关闭原因 暂无
最后编辑 maojinqiang 于 2021-12-24 18:39:08
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 32工时
总计消耗 31工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 2021-12-10
截止日期 0000-00-00