任务描述
暂无
需求描述

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,以及追踪号进行标发





验收标准
开放平台地址:http://open.taobao.com
历史记录  
  1. 2021-12-03 19:28:26, 由 maojinqiang 创建。
  2. 2021-12-03 20:10:44, 由 田子豪 确认需求变动,最新版本为#5。
  3. 2021-12-06 19:46:15, 由 maojinqiang 指派给 fangdahua。
    修改了 指派给,旧值为 "",新值为 "fangdahua"。
  4. 2021-12-07 09:53:02, 由 田子豪 确认需求变动,最新版本为#6。
  5. 2021-12-17 16:24:06, 由 fangdahua 完成。
    修改了 总计消耗,旧值为 "0",新值为 "10"。
    修改了 指派给 ,旧值为 "fangdahua",新值为 "maojinqiang"。
    修改了 实际完成,旧值为 "",新值为 "2021-12-17 16:11:45"。
    修改了 任务状态,旧值为 "wait",新值为 "done"。
    修改了 实际开始,旧值为 "0000-00-00 00:00:00",新值为 "2021-12-17 16:24:06"。
    修改了 预计剩余,旧值为 "10",新值为 "0"。
    修改了 由谁完成,旧值为 "",新值为 "fangdahua"。

    阿里巴巴国际站标记发货


    标记发货逻辑

    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.根据客户提供真实订单和物流信息,真实数据验证接口


    调用接口成功


    记录订单日志


    标记成功,客户截图平台界面。标记后状态和物流信息正确





  6. 2021-12-28 15:46:00, 由 fangdahua 添加备注。

    ERP 标记推送服务配置

所属迭代 【主干】产品中心12月第二个版本(2021年)
所属模块 赛盒科技  赛盒ERP管理系统   订单组
相关需求 【订单】新平台-阿里巴巴国际站对接
指派给 毛金强 于 2021-12-17 16:24:06
任务类型 后端
任务标签 初始
开发组
任务状态 已完成
进度 100%
优先级 P2
关键词
抄送给
由谁创建 maojinqiang 于 2021-12-03 19:28:26
由谁完成 fangdahua 于 2021-12-17 16:11:45
由谁取消 暂无
由谁关闭 暂无
关闭原因 暂无
最后编辑 fangdahua 于 2021-12-28 15:46:00
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 10工时
总计消耗 10工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 2021-12-17
截止日期 0000-00-00