任务描述

【数据库 -- 表设计】


订单表与订单产品表加扩展字段


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



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


1. 中间表保存对应的字段


2. 以Json字符串的形式保存在订单表扩展字段


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


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


1. 涉及到公共方法时注意验证，不要影响到其他逻辑

需求描述

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快过期的时候进行刷新，而不是在应用中调用；





验收标准
暂无
历史记录  
  1. 2021-10-19 20:53:36, 由 maojinqiang 创建。
  2. 2021-10-19 20:54:19, 由 maojinqiang 编辑。
    修改了 最初预计，旧值为 "4"，新值为 "5"。
    修改了 预计剩余，旧值为 "4"，新值为 "5"。
    修改了 任务描述，区别为：
    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+ <p>【数据库--表设计】</p>
    002+ <p><br /></p>
    003+ <p>订单表与订单产品表加扩展字段</p>
    004+ <p><br /></p>
    005+ <p>IF OBJECT_ID('RB_OrderInfo') IS NULL PRINT 'Error:Table RB_OrderInfo don''t exists!'<br />ELSE<br />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')<br />begin<br /> ALTER TABLE RB_OrderInfo ADD ExtendedInfo nvarchar(1000)<br /> 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'<br />end<br />IF @@ERROR&gt;0 PRINT 'Error:Failed to add column ExtendedInfo on table RB_OrderInfo!'<br />GO<br /><br />IF OBJECT_ID('RB_OrderList') IS NULL PRINT 'Error:Table RB_OrderList don''t exists!'<br />ELSE<br />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')<br />begin<br /> ALTER TABLE RB_OrderList ADD ExtendedInfo nvarchar(1000)<br /> 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'<br />end<br />IF @@ERROR&gt;0 PRINT 'Error:Failed to add column ExtendedInfo on table RB_OrderList!'<br />GO</p>
    006+ <p><br /></p>
    007+ <p><br /></p>
    008+ <p>【业务设计--业务逻辑设计，梳理】</p>
    009+ <p><br /></p>
    010+ <p>1. 保存中间表后，以Json字符串的形式保存在扩展字段</p>
    011+ <p><br /></p>
    012+ <p>【风险识别--性能，并发，扩展】</p>
    013+ <p><br /></p>
    014+ <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
  3. 2021-10-19 20:54:26, 由 maojinqiang 编辑。
    修改了 最初预计，旧值为 "5"，新值为 "4"。
    修改了 预计剩余，旧值为 "5"，新值为 "4"。
  4. 2021-10-19 20:54:38, 由 maojinqiang 编辑。
    修改了 最初预计，旧值为 "4"，新值为 "5"。
    修改了 预计剩余，旧值为 "4"，新值为 "5"。
  5. 2021-10-19 20:55:35, 由 maojinqiang 编辑。
    修改了 任务描述，区别为：
    010- 1. 保存中间表后，以Json字符串的形式保存在扩展字段
    010+ 1. 中间表保存对应的字段
    012- 【风险识别--性能，并发，扩展】
    012+ 2. 以Json字符串的形式保存在订单表扩展字段
    014- 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    014+ 【风险识别--性能，并发，扩展】
    015+
    016+ 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    010- <p>1. 保存中间表后，以Json字符串的形式保存在扩展字段</p>
    010+ <p>1. 中间表保存对应的字段</p>
    012- <p>【风险识别--性能，并发，扩展】</p>
    012+ <p>2. 以Json字符串的形式保存在订单表扩展字段</p>
    014- <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    014+ <p>【风险识别--性能，并发，扩展】</p>
    015+ <p><br /></p>
    016+ <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
  6. 2021-10-19 21:01:40, 由 maojinqiang 编辑。
    修改了 最初预计，旧值为 "5"，新值为 "6"。
    修改了 预计剩余，旧值为 "5"，新值为 "6"。
    修改了 任务描述，区别为：
    016- 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    016+ 【注意事项-- 编码规范、可能存在Bug、风险和业务关联】
    017+
    018+ 1. 涉及到公共方法时注意验证，不要影响到其他逻辑
    016- <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    016+ <p>【注意事项-- 编码规范、可能存在Bug、风险和业务关联】</p>
    017+ <p><br /></p>
    018+ <p>1. 涉及到公共方法时注意验证，不要影响到其他逻辑</p>
  7. 2021-10-20 16:15:15, 由 liushaohua 添加备注。

    1、签入SQL脚本、

    2、中间表新增字段

    3、订单策略把中间表的json保存到ERP订单表

  8. 2021-10-20 16:15:25, 由 liushaohua 启动。
    修改了 实际开始，旧值为 "0000-00-00 00:00:00"，新值为 "2021-10-20 16:15:22"。
    修改了 任务状态，旧值为 "wait"，新值为 "doing"。
  9. 2021-10-23 10:06:06, 由 田子豪 确认需求变动，最新版本为#5。
  10. 2021-10-23 17:51:04, 由 liushaohua 添加备注。

    1、新销售平台中间表数据：


    2、ERP订单表数据：

    SELECT ExtendedInfo, * FROM dbo.RB_OrderInfo WHERE CustomerID=1 AND ClientOrderCode IN ('210909SYGYM048','2109122AEPBCA3','2109257VYQRVHD')


  11. 2021-10-23 17:51:57, 由 liushaohua 完成。
    修改了 总计消耗，旧值为 "0"，新值为 "6"。
    修改了 实际完成，旧值为 ""，新值为 "2021-10-23 17:51:46"。
    修改了 任务状态，旧值为 "doing"，新值为 "done"。
    修改了 预计剩余，旧值为 "6"，新值为 "0"。
    修改了 由谁完成，旧值为 ""，新值为 "liushaohua"。
  12. 2021-10-25 15:59:42, 由 田子豪 确认需求变动，最新版本为#6。
  13. 2021-10-26 14:16:55, 由 田子豪 确认需求变动，最新版本为#9。
  14. 2021-10-26 15:47:20, 由 田子豪 确认需求变动，最新版本为#10。
  15. 2021-10-27 10:41:21, 由 liushaohua 指派给 maojinqiang。
    修改了 指派给，旧值为 "liushaohua"，新值为 "maojinqiang"。
  16. 2021-11-08 15:43:41, 由 田子豪 确认需求变动，最新版本为#11。
返回
所属迭代 【主干】产品中心11月第一个版本（2021年）
所属模块 赛盒科技  赛盒ERP管理系统   物流发货组
相关需求 【订单&物流】shopee接口升级
指派给 毛金强 于 2021-10-27 10:41:21
任务类型 后端
任务标签 初始
开发组
任务状态 已完成
进度 100%
优先级 P2
关键词
抄送给
由谁创建 maojinqiang 于 2021-10-19 20:53:36
由谁完成 liushaohua 于 2021-10-23 17:51:46
由谁取消 暂无
由谁关闭 暂无
关闭原因 暂无
最后编辑 liushaohua 于 2021-10-27 10:41:21
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 6工时
总计消耗 6工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 2021-10-20
截止日期 0000-00-00