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

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

获取的订单状态：

获取订单详情

方法：/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

应用信息

测试账号

• #40017 【订单来源渠道】新增fannoshop平台渠道后，自动同步到新销售平台，并记录日志
• #40018 【订单来源渠道】修改渠道后，自动将修改的字段同步到新销售平台，并记录日志
• #40019 【订单来源渠道】fannoshop平台渠道授权后，自动同步到新销售平台，并记录授权日志
• #40020 【订单来源渠道】新销售平台映射到erp后，自动执行订单策略
• #40021 【订单来源渠道】手动创建订单，执行订单策略，执行成功
• #40022 【订单来源渠道】未付款状态的订单，映射到erp后，不执行订单策略
• #40023 【订单来源渠道】订单未支付状态UNPAID，新销售平台映射到erp
• #40024 【订单来源渠道】订单未发货状态AWAITING_SHIPMENT，新销售平台映射到erp
• #40025 【订单来源渠道】订单状态变更AWAITING_COLLECTION，新销售平台映射到erp
• #40026 【订单来源渠道】订单状态变更IN_TRANSIT，新销售平台映射到erp
• #40027 【订单来源渠道】订单状态变更DELIVERED，新销售平台映射到erp
• #40028 【订单来源渠道】订单状态变更CANCELLED，新销售平台映射到erp
• #40029 【订单来源渠道】订单状态变更UNPAID，新销售平台映射到erp
• #40030 【订单来源渠道】订单未支付状态UNPAID，ERP中间表映射到erp
• #40031 【订单来源渠道】订单未发货状态AWAITING_SHIPMENT，ERP中间表映射到erp
• #40032 【订单来源渠道】订单状态变更AWAITING_COLLECTION，ERP中间表映射到erp
• #40033 【订单来源渠道】订单状态变更IN_TRANSIT，ERP中间表映射到erp
• #40034 【订单来源渠道】订单状态变更DELIVERED，ERP中间表映射到erp
• #40035 【订单来源渠道】订单状态变更CANCELLED，ERP中间表映射到erp
• #40036 【订单来源渠道】订单状态变更UNPAID，ERP中间表映射到erp
• #40037 【运输方式】平台运输方式新增fannoshop平台
• #40038 【客户订单】批量标发fannoshop平台订单
• #40039 【客户订单】批量标发fannoshop平台订单失败后，记录错误日志
• #40040 【平台标记发货规则】平台发货规则，增加fannoshop平台，以及图标
• #40041 【客户订单】客户订单编辑-分析运输方式页面，渠道类型增加fannoshop平台