任务描述

【数据库 -- 表设计】


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


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


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

需求描述

1.    需求概述

1.1. 背景

新平台，fannoshop对接


来源渠道使用logo：


需和平台澄清问题：

1、订单下载的最小单位是个数组，一个代表街道编号，一个代表房子编号吗？需要拼接？

2、有自发货和线上物流发货，怎样判断什么情况下是线上物流发货？根据订单国家？还是根据订单详情是否返回跟踪号？

3、买家发起退款请求的时候，是有一个单独的字段来标识的，那对应的订单是什么状态？



2.    功能设计

2.1. 来源渠道授权

2.1.1 需求说明


fannoshop使用OAuth2.0标准协议作为用户身份验证与授权协议，流程如下：

1、点击授权按钮，弹出fannoshop登录界面；

2、用户输入用户名和密码，点击登录，进入授权页面；

3、点击授权，即可授权成功；



2.2. 订单下载

2.2.1 需求说明


获取订单列表

方法：/api/orders/search

根据“订单更新时间”获取订单列表

获取的订单状态：


AWAITING_SHIPMENT



获取订单详情

方法：/api/orders/detail/query

根据订单号获取订单详情


费用相关：





2.3. 订单更新

2.3.1 需求说明


更新订单使用服务进行请求，通过订单修改时间获取，当检测到订单状态改变时，重新同步订单信息



2.4. 平台运输方式管理

2.4.1 需求说明


获取承运商列表接口

方法：/api/logistics/shipping_providers




2.5. 平台标记发货规则

2.5.1 需求说明



方法：ShipOrder


有两种标发方式：
1）平台运输方式标发；

     1.1）先通过接口GetShippingProvider获取承运商和追踪号；

     1.2）调用ShipOrder传值追踪号进行标记发货；


2）卖家自发货方式；


     1.1）调用接口ShipOrder传值承运商和追踪号进行标发；



操作位置：销售管理->通用订单设置->平台标记发货规则->设置->添加特殊规则

满足条件后的执行，展示“只上传真实追踪号”和“自行标记发货_ERP不操作”









验收标准

api地址：https://bytedance.feishu.cn/docs/doccnp9gDal0wq7PJZTCAuEqOJd


应用信息

AppKey：4pkc70

AppSecret：725d2b456283b91937b5a08f018f0cb2bb79b657

AppName：test024

测试账号

Fanno Seller Center URL: https://seller-global.fannoshop.com

测试店铺登陆邮箱：yangpanting+0011@bytedance.com

测试店铺登陆密码：123456y

相关用例
子任务
任务ID P 任务名称 截止日期 指派给 任务状态 消耗(h) 剩余(h) 操作
23730 P2 【订单】新平台-抖音旗下fannoshop对接 --SDK封装 0000-00-00 maojinqiang 已完成 6 0
23731 P2 【订单】新平台-抖音旗下fannoshop对接 --订单来源渠道授权 0000-00-00 maojinqiang 已完成 6 0
23732 P2 【订单】新平台-抖音旗下fannoshop对接 --订单同步 0000-00-00 maojinqiang 已完成 12 0
23733 P2 【订单】新平台-抖音旗下fannoshop对接 --标记发货 0000-00-00 maojinqiang 已完成 12 0
23734 P2 【订单】新平台-抖音旗下fannoshop对接 --平台运输方式 0000-00-00 maojinqiang 已完成 6 0
23735 P2 【订单】新平台-抖音旗下fannoshop对接 --订单执行策略 0000-00-00 maojinqiang 已完成 8 0
历史记录  
  1. 2021-12-21 18:55:05, 由 maojinqiang 创建。
  2. 2021-12-21 19:03:25, 由 maojinqiang 编辑。
    修改了 父任务 ，旧值为 "0"，新值为 "-1"。
    修改了 最初预计，旧值为 "49"，新值为 "50"。
    修改了 预计剩余，旧值为 "49"，新值为 "50"。
  3. 2021-12-21 19:03:25, 由 maojinqiang 创建子任务 #23730 【订单】新平台-抖音旗下fannoshop对接 --SDK封装 , #23731 【订单】新平台-抖音旗下fannoshop对接 --订单来源渠道授权 , #23732 【订单】新平台-抖音旗下fannoshop对接 --订单同步 , #23733 【订单】新平台-抖音旗下fannoshop对接 --标记发货 , #23734 【订单】新平台-抖音旗下fannoshop对接 --平台运输方式 , #23735 【订单】新平台-抖音旗下fannoshop对接 --订单执行策略 。
    修改了 父任务 ，旧值为 "0"，新值为 "-1"。
    修改了 最初预计，旧值为 "49"，新值为 "50"。
    修改了 预计剩余，旧值为 "49"，新值为 "50"。
  4. 2021-12-24 14:26:01, 由 fangdahua 启动。
    修改了 总计消耗，旧值为 "0"，新值为 "6"。
    修改了 预计剩余，旧值为 "50"，新值为 "44"。
    修改了 任务状态，旧值为 "wait"，新值为 "doing"。
  5. 2021-12-24 14:32:57, 由 fangdahua 编辑。
    修改了 总计消耗，旧值为 "6"，新值为 "12"。
    修改了 预计剩余，旧值为 "44"，新值为 "38"。
  6. 2021-12-27 16:56:58, 由 fangdahua 编辑。
    修改了 总计消耗，旧值为 "12"，新值为 "24"。
    修改了 预计剩余，旧值为 "38"，新值为 "26"。
  7. 2021-12-27 17:06:40, 由 fangdahua 编辑。
    修改了 总计消耗，旧值为 "24"，新值为 "30"。
    修改了 预计剩余，旧值为 "26"，新值为 "20"。
  8. 2021-12-28 19:56:07, 由 fangdahua 编辑。
    修改了 总计消耗，旧值为 "30"，新值为 "38"。
    修改了 预计剩余，旧值为 "20"，新值为 "12"。
  9. 2021-12-29 13:51:53, 由 fangdahua 完成。
    修改了 总计消耗，旧值为 "38"，新值为 "50"。
    修改了 预计剩余，旧值为 "12"，新值为 "0"。
    修改了 任务状态，旧值为 "doing"，新值为 "done"。
    修改了 指派给 ，旧值为 ""，新值为 "maojinqiang"。
    修改了 由谁完成，旧值为 ""，新值为 "fangdahua"。
    修改了 实际完成，旧值为 "0000-00-00 00:00:00"，新值为 "2021-12-29 13:51:53"。
返回
所属迭代 【主干】产品中心1月第一个版本（2022年）
所属模块 赛盒科技  赛盒ERP管理系统   订单组
相关需求 【订单】新平台-抖音旗下fannoshop对接
指派给 毛金强 于 2021-12-29 13:51:53
任务类型 后端
任务标签 初始
开发组
任务状态 已完成
进度 100%
优先级 P2
关键词
抄送给
由谁创建 maojinqiang 于 2021-12-21 18:55:05
由谁完成 fangdahua 于 2021-12-29 13:51:53
由谁取消 暂无
由谁关闭 暂无
关闭原因 暂无
最后编辑 fangdahua 于 2021-12-29 15:34:22
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 50工时
总计消耗 50工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 2021-12-24
截止日期 0000-00-00