1. 需求概述
1.1. 背景
新平台,阿里巴巴国际站对接
2. 功能设计
2.1. 来源渠道授权
2.1.1 需求说明
国际站使用OAuth2.0标准协议作为用户身份验证与授权协议,流程如下:
1、点击授权按钮,弹出国际站登录界面;
2、用户输入用户名和密码,点击登录,进入授权页面;
3、点击授权,即可授权成功


2.2. 订单下载
2.2.1 需求说明
获取订单列表
方法:alibaba.seller.order.list
接口地址:https://open.taobao.com/api.htm?docId=41047&docType=2&scopeId=15989
获取订单详情
方法:alibaba.seller.order.get
接口地址:https://developer.alibaba.com/doc.htm?spm=0.0.0.0.o1YyAq#?treeId=450&platformId=62&docType=2&docId=41148
请求以下类型的订单:
状态:undeliver(待卖家发货)
费用相关:
这里和方达华确认下,如果接口既可以通过订单下载时间同步,也可以根据订单修改时间同步,那订单下载是以下哪种逻辑:
1、首次下载和更新都通过订单更新时间同步;
2、首次下载通过下单时间同步,更新通过更新时间同步;
2.3. 订单更新
2.3.1 需求说明
获取订单列表
方法:alibaba.seller.order.list
接口地址:https://open.taobao.com/api.htm?docId=41047&docType=2&scopeId=15989
获取订单详情
获取订单详情
方法:alibaba.seller.order.get
接口地址:https://developer.alibaba.com/doc.htm?spm=0.0.0.0.o1YyAq#?treeId=450&platformId=62&docType=2&docId=41148
更新订单使用服务进行请求,通过订单修改时间获取,当检测到订单状态改变时,重新同步订单信息
2.4. 平台运输方式管理
2.4.1 需求说明
获取承运商列表接口
方法:alibaba.seller.order.shipping.channels
接口地址:https://developer.alibaba.com/doc.htm?spm=0.0.0.0.o1YyAq#?treeId=450&platformId=62&docType=2&docId=47280
请求接口后,分别保存物流商code和type

2.5. 平台标记发货规则
2.5.1 需求说明
操作位置:销售管理->通用订单设置->平台标记发货规则->设置->添加特殊规则
满足标发条件后,只显示【上传真实追踪号】和【自动标记发货_ERP不操作】两个选项
标记发货
方法:alibaba.seller.order.shipping
接口地址:https://developer.alibaba.com/doc.htm?spm=0.0.0.0.o1YyAq#?treeId=450&platformId=62&docType=2&docId=47112
通过获取承运商接口返回的code和type,以及追踪号进行标发


阿里巴巴国际站标记发货
标记发货逻辑
1. 阿里巴巴国际站标记,根据系统订单号查询预生成后且状态是6的面单地址,将FilePath地址传入标记
FilePath格式如:https://irobotbox-hd1.oss-cn-hangzhou.aliyuncs.com/1/ApplyTaskExcel/2021/12/17/2e161573c1fc4cc298d8d3c55a5f4f2d/XF0005739661.pdf
SELECT t.CustomerId,
t.OrderCode,
t.FilePath
FROM RB_TempTransportRequest t (nolock)
WHERE t.CustomerId IN (1)
AND t.OrderCode IN ( 'xx')
AND Status=6
2.标记逻辑
a.如果面单地址为空,则标记异常,提示:暂无面单,请等待面单生成后再标发
b.如果面单地址无法解析,则标记异常,提示异常错误
c.如果上传文件接口返回失败,则标记异常,提示接口返回错误信息
d.如果接口返回成功但是返回的value空值,则标记异常,提示:Upload-ErrMsg:接口未返回FilePath
否则,调用接口成功,获取接口返回的value传入标记接口,进行调用标记接口。
如果标记接口异常,则标记异常,提示接口返回错误信息。如果接口返回成功,则标记成功。
1.标记发货规则
2.模拟手动和自动标记成功和失败
3.根据客户提供真实订单和物流信息,真实数据验证接口
调用接口成功
记录订单日志
标记成功,客户截图平台界面。标记后状态和物流信息正确