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