暂无
任务描述
需求描述
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
相关用例
- #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平台
订单中间表执行策略映射到ERP，字段关系。
ERP - 》 中间表
1.平台状态 UNPAID = 100,
AWAITING_SHIPMENT = 111,
AWAITING_COLLECTION = 112,
IN_TRANSIT = 121,
DELIVERED = 122,
COMPLETED = 130,
CANCELLED = 140
--------------------------------------------------------------
订单信息
2.平台单号-》OrderID
3.订单发货状态默认未发货，如是AWAITING_COLLECTION、IN_TRANSIT、DELIVERED、COMPLETED则全部发货
4.订单状态，默认正常，如是CANCELLED作废（底层逻辑会设置待审核），如是UNPAID待审核
5.标记发货状态默认等待处理，，如是AWAITING_COLLECTION、IN_TRANSIT、DELIVERED、COMPLETED则标记成功
6.订单国家取当前来源渠道设置的市场国家
7.订单币种-》Currency
8.订单支付状态，默认未支付，如是 AWAITING_SHIPMENT、AWAITING_COLLECTION、IN_TRANSIT、DELIVERED、COMPLETED
、CANCELLED已支付
9.支付时间-》PaidTime
10.订单金额TotalPrice-》TotalAmount
11.订单运费TransportPay-》ShippingFee
12.订单优惠券PromotionDiscountAmount-》SellerDiscount+PlatformDiscount
13.订单产品价格ProductTotalPrice-》SubTotal
14.如果PaymentMethod是CASH_ON_DELIVERY则设置为货到付款，已支付，添加订单备注和订单日志
15.根据Name名称，中间空格截取，前面是姓FirstName ，后面是名LastName
16.省份Province-》State
17.城市City-》City
18.邮编PostCode-》Zipcode
19.电话Telephone-》Phone
20.街道District-》District
21.地址1Address1 -》FullAddress
22.订单类型PromotionType-》DeliveryOption，用于判断标记发货是否传入追踪号和平台运输渠道
23.平台运输方式ShippingService-》ShippingProvider
24.订单备注-》BuyerMessage
25.如果订单状态是CANCELLED，则设置待审核，添加订单备注和订单问题日志，
内容：检测到平台订单取消-取消原因：{取消类型CancelUser}{取消原因CancelReason}
--------------------------------------------------------------
产品信息
1.渠道sku，SellerSKU-》SellerSku
2.OrderItemId-》ProductId
3.产品名称ItemTitle-》ProductName
4.产品数量ProductNum-》Quantity
5.产品价格ProductPrice-》SkuSalePrice
6.产品规格Marks-》SkuName
自测截图：