1. 需求概述

1.1. 背景

虾皮2.0通知接口升级，同步更新，平台通知如下：

---------------------------

1.GetOrderDetail、V2.get_order_detail、MyIncome 、get_escrow_detail均新增加了reverse_shipping_fee字段，用来表示当buyer尝试退回购买的产品时，退货产生的运费。

影响接口：

shopee.orders.GetOrderDetails

v2.order.get_order_detail

shopee.orders.MyIncome

v2.payment.get_escrow_detail

------------------------

4. v2.logistics.get_channel_list新增返参字段dimension_sum, 表示使用该渠道的物品的长宽高总和的限制

影响接口：v2.logistics.get_channel_list

2. 功能设计

2.1. 订单接口增加字段

2.1.1 需求说明

订单两个接口增加reverse_shipping_fee字段，保存在订单表

v2.order.get_order_detail
v2.payment.get_escrow_detail

------------------------------------------------------------------------------------------------------------------------------------------------------------

2.2需求暂时不做

2.2. 组包揽收渠道筛选

2.2.1 需求说明

针对V2版本接口

交运批次管理中，提交组包揽收选择shopee线上发货，选择客户自送，搜索物流渠道的时候，将返回物流渠道中的以下6个字段和勾选的交运批次中的各个包裹对应的值进行比较：

length（最大长）

width（最大宽）

height（最大高）

dimension_sum（最大长宽高和）

item_max_weight（最大重量）

item_min_weight（最小重量）

依此遍历包裹，必须所有包裹尺寸重量均满足渠道限制，才能使用该渠道；如果有包裹的尺寸及重量不满足对应渠道限制，则将对应渠道过滤掉；

单个产品包裹对应ERP取值：

长-【产品管理-单个包装尺寸】

宽-【产品管理-单个包装尺寸】

高-【产品管理-单个包装尺寸】

长宽高和-【产品管理-单个包装尺寸】

重量-【产品管理-单个产品重量-包裹重量】

订单有多个产品时，尺寸取最大的长宽高，重量为单个产品重量*数量相加

api文档地址：https://open.shopee.com/documents?module=95&type=1&id=559&version=2

2.2.1 原型界面

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

2.3. 增加服务刷新token

2.3.1 需求说明

现状：虾皮刷新token后，旧的token会在5分钟后过期，容易出现不同程序调用刷新token接口，导致token频繁失效的情况；

解决方案：增加刷新token的服务，检测到token快过期的时候进行刷新，而不是在应用中调用；

验收标准

暂无

子任务

任务ID	P	任务名称	截止日期	指派给	任务状态	消耗(h)	剩余(h)
21180	P2	【订单&物流】shopee接口升级 --订单同步调整	0000-00-00	maojinqiang	已完成	6	0
21276	P2	【订单&物流】shopee接口升级 --服务刷新Token	0000-00-00	maojinqiang	已完成	4	0
21413	P2	shopee接口升级-交运批次优化	0000-00-00	Closed	已关闭	0	12

历史记录

2021-10-19 20:48:32, 由 maojinqiang 创建。
2021-10-19 20:53:36, 由 maojinqiang 编辑。
修改了 父任务 ，旧值为 "0"，新值为 "-1"。
修改了 最初预计，旧值为 "0"，新值为 "4"。
修改了 预计剩余，旧值为 "0"，新值为 "4"。
2021-10-19 20:53:36, 由 maojinqiang 创建子任务 #21180 【订单&物流】shopee接口升级 --订单同步调整 。
修改了 父任务 ，旧值为 "0"，新值为 "-1"。
修改了 最初预计，旧值为 "0"，新值为 "4"。
修改了 预计剩余，旧值为 "0"，新值为 "4"。
2021-10-19 20:54:02, 由 maojinqiang 编辑。
修改了 任务描述，区别为：
001- ~~【数据库--表设计】~~
001+
002-
003- ~~订单表与订单产品表加扩展字段~~
004-
005- IF OBJECT_ID('RB_OrderInfo') IS NULL PRINT 'Error:Table RB_OrderInfo don''t exists!'ELSEIF NOT EXISTS(SELECT 1 FROM SYSOBJECTS T1 JOIN SYSCOLUMNS T2 ON T1.ID=T2.ID WHERE T1.NAME='RB_OrderInfo' AND T2.NAME='ExtendedInfo')begin ALTER TABLE RB_OrderInfo ADD ExtendedInfo nvarchar(1000) EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'订单扩展信息,以JSON字符串形式保存' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'RB_OrderInfo', @level2type=N'COLUMN',@level2name=N'ExtendedInfo'endIF @@ERROR>0 PRINT 'Error:Failed to add column ExtendedInfo on table RB_OrderInfo!'GOIF OBJECT_ID('RB_OrderList') IS NULL PRINT 'Error:Table RB_OrderList don''t exists!'ELSEIF NOT EXISTS(SELECT 1 FROM SYSOBJECTS T1 JOIN SYSCOLUMNS T2 ON T1.ID=T2.ID WHERE T1.NAME='RB_OrderList' AND T2.NAME='ExtendedInfo')begin ALTER TABLE RB_OrderList ADD ExtendedInfo nvarchar(1000) EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'订单扩展信息,以JSON字符串形式保存' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'RB_OrderList', @level2type=N'COLUMN',@level2name=N'ExtendedInfo'endIF @@ERROR>0 PRINT 'Error:Failed to add column ExtendedInfo on table RB_OrderList!'GO
006-
007-
008- ~~【业务设计--业务逻辑设计，梳理】~~
009-
010- ~~1. 保存中间表后，以Json字符串的形式保存在扩展字段~~
011-
012- ~~【风险识别--性能，并发，扩展】~~
013-
014- ~~【注意事项-- 编码规范、可能存在Bug、风险和业务关联】~~

001- ~~【数据库--表设计】~~
001+ 
002- ~~ ~~
003- ~~订单表与订单产品表加扩展字段~~
004- ~~ ~~
005- IF OBJECT_ID('RB_OrderInfo') IS NULL PRINT 'Error:Table RB_OrderInfo don''t exists!' ELSE IF NOT EXISTS(SELECT 1 FROM SYSOBJECTS T1 JOIN SYSCOLUMNS T2 ON T1.ID=T2.ID WHERE T1.NAME='RB_OrderInfo' AND T2.NAME='ExtendedInfo') begin ALTER TABLE RB_OrderInfo ADD ExtendedInfo nvarchar(1000) EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'订单扩展信息,以JSON字符串形式保存' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'RB_OrderInfo', @level2type=N'COLUMN',@level2name=N'ExtendedInfo' end IF @@ERROR>0 PRINT 'Error:Failed to add column ExtendedInfo on table RB_OrderInfo!' GO IF OBJECT_ID('RB_OrderList') IS NULL PRINT 'Error:Table RB_OrderList don''t exists!' ELSE IF NOT EXISTS(SELECT 1 FROM SYSOBJECTS T1 JOIN SYSCOLUMNS T2 ON T1.ID=T2.ID WHERE T1.NAME='RB_OrderList' AND T2.NAME='ExtendedInfo') begin ALTER TABLE RB_OrderList ADD ExtendedInfo nvarchar(1000) EXEC sys.sp_addextendedproperty @name=N'MS_Description', @value=N'订单扩展信息,以JSON字符串形式保存' , @level0type=N'SCHEMA',@level0name=N'dbo', @level1type=N'TABLE',@level1name=N'RB_OrderList', @level2type=N'COLUMN',@level2name=N'ExtendedInfo' end IF @@ERROR>0 PRINT 'Error:Failed to add column ExtendedInfo on table RB_OrderList!' GO 
006- ~~ ~~
007- ~~ ~~
008- ~~【业务设计--业务逻辑设计，梳理】~~
009- ~~ ~~
010- ~~1. 保存中间表后，以Json字符串的形式保存在扩展字段~~
011- ~~ ~~
012- ~~【风险识别--性能，并发，扩展】~~
013- ~~ ~~
014- ~~【注意事项-- 编码规范、可能存在Bug、风险和业务关联】~~
2021-10-19 20:54:18, 由 maojinqiang 编辑。
修改了 最初预计，旧值为 "4"，新值为 "5"。
修改了 预计剩余，旧值为 "4"，新值为 "5"。
2021-10-19 20:54:26, 由 maojinqiang 编辑。
修改了 最初预计，旧值为 "5"，新值为 "4"。
修改了 预计剩余，旧值为 "5"，新值为 "4"。
2021-10-19 20:54:38, 由 maojinqiang 编辑。
修改了 最初预计，旧值为 "4"，新值为 "5"。
修改了 预计剩余，旧值为 "4"，新值为 "5"。
2021-10-19 21:01:40, 由 maojinqiang 编辑。
修改了 最初预计，旧值为 "5"，新值为 "6"。
修改了 预计剩余，旧值为 "5"，新值为 "6"。
2021-10-20 16:15:25, 由 liushaohua 启动。
修改了 任务状态，旧值为 "wait"，新值为 "doing"。
2021-10-22 16:45:21, 由 maojinqiang 编辑。
修改了 最初预计，旧值为 "6"，新值为 "10"。
修改了 预计剩余，旧值为 "6"，新值为 "10"。
2021-10-22 16:45:21, 由 maojinqiang 创建子任务 #21276 【订单&物流】shopee接口升级 --服务刷新Token 。
修改了 最初预计，旧值为 "6"，新值为 "10"。
修改了 预计剩余，旧值为 "6"，新值为 "10"。
2021-10-23 10:06:17, 由 田子豪 确认需求变动，最新版本为#5。
2021-10-23 17:40:06, 由 liushaohua 编辑。
修改了 总计消耗，旧值为 "0"，新值为 "4"。
修改了 预计剩余，旧值为 "10"，新值为 "6"。
2021-10-23 17:51:57, 由 liushaohua 完成。
修改了 总计消耗，旧值为 "4"，新值为 "10"。
修改了 预计剩余，旧值为 "6"，新值为 "0"。
修改了 任务状态，旧值为 "doing"，新值为 "done"。
修改了 指派给 ，旧值为 ""，新值为 "maojinqiang"。
修改了 由谁完成，旧值为 ""，新值为 "liushaohua"。
修改了 实际完成，旧值为 "0000-00-00 00:00:00"，新值为 "2021-10-23 17:51:57"。
2021-10-25 15:59:45, 由 田子豪 确认需求变动，最新版本为#6。
2021-10-26 14:16:48, 由 田子豪 确认需求变动，最新版本为#9。
2021-10-26 15:47:16, 由 田子豪 确认需求变动，最新版本为#10。
2021-10-26 18:03:13, 由程伟激活。
修改了 最初预计，旧值为 "10"，新值为 "22"。
修改了 预计剩余，旧值为 "0"，新值为 "12"。
修改了 任务状态，旧值为 "done"，新值为 "doing"。
修改了 由谁完成，旧值为 "liushaohua"，新值为 ""。
修改了 实际完成，旧值为 "2021-10-23 17:51:57"，新值为 "0000-00-00 00:00:00"。
2021-10-26 18:03:13, 由程伟创建子任务 #21413 shopee接口升级-交运批次优化 。
修改了 最初预计，旧值为 "10"，新值为 "22"。
修改了 预计剩余，旧值为 "0"，新值为 "12"。
修改了 任务状态，旧值为 "done"，新值为 "doing"。
修改了 由谁完成，旧值为 "liushaohua"，新值为 ""。
修改了 实际完成，旧值为 "2021-10-23 17:51:57"，新值为 "0000-00-00 00:00:00"。
2021-10-26 18:05:03, 由程伟完成。
修改了 最初预计，旧值为 "22"，新值为 "10"。
修改了 预计剩余，旧值为 "12"，新值为 "0"。
修改了 任务状态，旧值为 "doing"，新值为 "done"。
修改了 由谁完成，旧值为 ""，新值为 "chengwei"。
修改了 实际完成，旧值为 "0000-00-00 00:00:00"，新值为 "2021-10-26 18:05:03"。
2021-10-26 18:05:06, 由程伟编辑。
修改了 最初预计，旧值为 "10"，新值为 "22"。
2021-11-08 15:43:52, 由 田子豪 确认需求变动，最新版本为#11。

基本信息
任务的一生

所属迭代	【主干】产品中心11月第一个版本（2021年）
所属模块	赛盒科技赛盒ERP管理系统物流发货组
相关需求	【订单&物流】shopee接口升级
指派给	毛金强于 2021-10-26 18:05:03
任务类型	后端
任务标签	初始
开发组
任务状态	已完成
进度	100%
优先级	P2
关键词
抄送给

由谁创建	maojinqiang 于 2021-10-19 20:48:32
由谁完成	程伟于 2021-10-26 18:05:03
由谁取消	暂无
由谁关闭	暂无
关闭原因	暂无
最后编辑	liushaohua 于 2021-10-27 10:42:25

团队	最初预计	总计消耗	预计剩余

工时信息

最初预计	22工时
总计消耗	10工时
预计剩余	0工时
预计开始	0000-00-00
实际开始	2021-10-20
截止日期	0000-00-00