1. 需求概述

1.1. 背景

新平台shopline对接

2. 来源渠道授权

2.1 需求说明

OAuth2.0认证，认证前需要申请开发者和应用，开发者账号由市场部进行跟进申请

发起授权

path：/admin/oauth-web/#/oauth/authorize

method：GET

授权流程：

弹出平台登录页面，输入店铺账号密码，点击确认；
账号校验，校验成功确定是否授权；
确认后授权成功，获取回调信息；

3. 订单下载

3.1 需求说明

请求订单信息，根据条件查询订单列表和详细信息；

方法名：orders.json

请求链接：https://{店铺handle}.myshopline.com/admin/openapi/v20210901/orders.json

4. 订单状态更新

4.1 需求说明

4.2 原型页面

5. 平台运输方式管理

5.1 需求说明

在平台运输方式管理界面中维护以下信息：

物流追踪URL

5.2 原型页面

6. 平台标记发货规则

6.1 需求说明

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

满足标发条件后，只显示【上传真实追踪号】和【自动标记发货_ERP不操作】两个选项

6.2 原型页面

验收标准

API文档地址：https://shopline.yuque.com/docs/share/b6511e05-b6a3-42f3-916e-38facd89c3ed?#

测试店铺：
买家链接：https://apitestshop001.myshopline.com/
卖家链接：https://admin.myshopline.com/user/signIn
账号：openapi_v2@shoplineapp.com
密码：Shopline2021

历史记录

2021-10-18 10:50:50, 由 maojinqiang 创建。
2021-10-18 11:22:05, 由 maojinqiang 编辑。
修改了 相关需求，旧值为 "0"，新值为 "9736"。
修改了 需求版本，旧值为 "1"，新值为 "7"。
2021-10-22 16:33:15, 由 maojinqiang 编辑。
修改了 所属模块，旧值为 "0"，新值为 "1572"。
修改了 相关需求，旧值为 "9736"，新值为 "0"。
2021-10-22 16:33:21, 由 maojinqiang 编辑。
修改了 相关需求，旧值为 "0"，新值为 "9736"。
2021-10-22 16:36:26, 由 maojinqiang 指派给 fangdahua。
修改了 指派给，旧值为 ""，新值为 "fangdahua"。
2021-10-26 16:17:25, 由 fangdahua 完成。
修改了 总计消耗，旧值为 "0"，新值为 "12"。
修改了 实际完成，旧值为 ""，新值为 "2021-10-26 16:10:40"。
修改了 任务状态，旧值为 "wait"，新值为 "done"。
修改了 实际开始，旧值为 "0000-00-00 00:00:00"，新值为 "2021-10-26 16:17:25"。
修改了 预计剩余，旧值为 "12"，新值为 "0"。
修改了 由谁完成，旧值为 ""，新值为 "fangdahua"。

标记发货

1.标记发货规则了配置该平台

2.手动标记和自动标记规则，可选类型：只显示【上传真实追踪号】和【自动标记发货_ERP不操作】两个选项

3.手动标记，推送数据到新销售平台调用接口（全部发货）

4.自动标记，调用接口，数据推送新销售平台数据库，服务消费调用接口标记。（支持部分标记和全部标记）模式

5.自动标记推送，需要配置服务配置标记服务 Task_ShopLine_OrderMarkeDelivery.cs （灰度前通过工作流给相关同事配置）

自测截图

手动标记

标记失败提示错误，标记成功，平台显示已发货及标记上传的渠道和追踪号等信息

自动标记

拆分订单自动标记，先满足标记订单为部分发货

直到最后一个订单标记，才为全部发货

标记成功后平台显示
2021-10-28 13:45:30, 由 fangdahua 指派给 maojinqiang。
修改了 指派给，旧值为 "fangdahua"，新值为 "maojinqiang"。
2021-11-02 21:54:16, 由 maojinqiang 关闭。
修改了 任务状态，旧值为 "done"，新值为 "closed"。
修改了 指派给 ，旧值为 "maojinqiang"，新值为 "closed"。
修改了 由谁关闭，旧值为 ""，新值为 "maojinqiang"。
修改了 关闭时间，旧值为 "0000-00-00 00:00:00"，新值为 "2021-11-02 21:54:16"。
修改了 关闭原因，旧值为 ""，新值为 "done"。
2021-11-08 15:56:17, 由 田子豪 确认需求变动，最新版本为#8。
2021-11-09 11:50:06, 由 fangdahua 添加备注。

自动标记服务流程

基本信息
任务的一生

所属迭代	【主干】产品中心11月第一个版本（2021年）
所属模块	赛盒科技赛盒ERP管理系统物流发货组
相关需求	【订单&物流】新平台-shopline对接
指派给	Closed 于 2021-11-02 21:54:16
任务类型	后端
任务标签	初始
开发组
任务状态	已关闭
进度	100%
优先级	P2
关键词
抄送给

由谁创建	maojinqiang 于 2021-10-18 10:50:50
由谁完成	fangdahua 于 2021-10-26 16:10:40
由谁取消	暂无
由谁关闭	maojinqiang 于 2021-11-02 21:54:16
关闭原因	已完成
最后编辑	fangdahua 于 2021-11-09 11:50:06

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

工时信息

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