任务描述
暂无
需求描述

一、背景和价值

   1.背景

       通过接口自动抓取轨迹, 无需登录爬虫工具 ,避免人工遗漏的情况。

   2.价值

      通过接口抓取lazada平台订单轨迹,提高轨迹数据的准确率,确保上网率。

二、需求描述

   2.1. 功能清单

        lazada轨迹API对接

   2.2.影响点

         无

   2.3. 功能描述:

     1.路径:仓储物流管理->包裹物流轨迹查询->轨迹查询
     2. API接口地址&名称:
            ①接口地址:https://open.lazada.com/apps/doc/api?path=%2Flogistic%2Forder%2Ftrace
            ②接口名称:GetOrderTrace
     3.API调用逻辑及界面显示逻辑
        1)轨迹系统>轨迹查询->查询不到的页签,
           ①目前ERP系统根据【客户订单同步规则】自动同步到轨迹系统----------------------------现有逻辑
           ②无任何的轨迹内容信息返回,则认为查询不到-----------------------------现有逻辑
           ③全部调用API接口进行获取轨迹信息,获取回来后进行单独的存储,订单号,轨迹内容,轨迹时间,来源渠道,追踪号,平台类型,发货时间,上网时间,上网信息,状态等重要信息。
        2)轨迹系统>"待上网" 的页签
            ①根据规则设置->自定义上网规则,有任意一条轨迹信息产生,单不包含上网规则时,则认为是待上网


            ②列表界面显示上网时间为北京时间,确保轨迹和列表界面显示一致。(若后台返回是UTC则需要转为北京时间)


        3)轨迹系统>"运输途中" 的页签
            ①根据规则设置->自定义上网规则,若当前订单的内容符合上网规则,则该订单状态就修改为运输途中。 

            ②列表界面显示上网时间为北京时间,确保轨迹和列表界面显示一致。(若后台返回是UTC则需要转为北京时间)


        4)接口调用的时间范围
             ①从订单添加时间近2个月内的所有订单都检索(已上网的除外)
             ②只要获取到上网信息后,则不再进行订单接口的调用,否则都要一直进行调用API接口去获取。(物流人员自行打上妥投的标识)

         
        5)历史数据处理
            ①功能上线后,系统默认获取12月1日到至今的轨迹数据拉取到系统。

           

        6)包裹状态的列显示内容显示如下图(针对lazada和shopee)
              ①当前的逻辑:界面看到的信息都是直接调用51track 的接口进行实时显示的
              ②修改后逻辑:鼠标移上去后如下图
                 A,追踪号:订单对应的追踪号信息
                 B.目的地:中国-XXXXXX   --------------------------发货国家默认为中文,到货国家为对应订单对应的国家
                 C.轨迹发件国家:每条轨迹的产生时间+ 轨迹内容.

 

lazada后台轨迹截图: 订单号:202212310127133982076   轨迹如下图


轨迹系统截图:

验收标准
暂无
历史记录  
  1. 2023-01-06 09:51:59, 由 程伟 创建。
  2. 2023-01-09 11:30:27, 由 谢业福 添加备注。

    SDK:


    接口数据返回:


    {
    	"result": {
    		"error_code": {
    			"displayMessage": null
    		},
    		"repeated": false,
    		"retry": false,
    		"not_success": false,
    		"success": true,
    		"module": [{
    			"warehouse_detail_info": null,
    			"ofc_order_id": null,
    			"package_detail_info_list": [{
    				"order_line_info_list": null,
    				"tracking_number": "LXBPH000114213394",
    				"ofc_package_id": "FP008211814796232",
    				"logistic_detail_info_list": [{
    					"package_location_name": null,
    					"event_date": null,
    					"detail_type": "ready_to",
    					"proof_images": [],
    					"receive_time": "0",
    					"status_code": "1200",
    					"icon": null,
    					"event_time": "1673218372536",
    					"description": "Your package is packed and will be handed over to our logistics partner.",
    					"title": "Packed by Seller / Warehouse"
    				}]
    			}]
    		}]
    	},
    	"Type": null,
    	"Code": "0",
    	"Message": null,
    	"RequestId": "214127c316732345490088782",
    	"Body": "{"result":{"not_success":false,"success":true,"module":[{"package_detail_info_list":[{"ofc_package_id":"FP008211814796232","tracking_number":"LXBPH000114213394","logistic_detail_info_list":[{"status_code":"1200","proof_images":[],"detail_type":"ready_to","receive_time":0,"description":"Your package is packed and will be handed over to our logistics partner.","title":"Packed by Seller / Warehouse","event_time":1673218372536}]}]}],"error_code":{},"repeated":false,"retry":false},"code":"0","request_id":"214127c316732345490088782"}"
    }


  3. 2023-01-09 11:32:05, 由 谢业福 添加备注。

    测试代码备份:

    页面testcw.aspx

     <fieldset class="AmazonCampaign">
                <legend>lazada物流轨迹对接</legend>
                <table>
                    <tr>
                        <td>
                            <label>系统订单号:</label><asp:TextBox ID="TextBox29" runat="server"></asp:TextBox>
                            <asp:Button runat="server" ID="Button119" Text="执行" OnClick="btClick_GetOrderTrace" />
                            <asp:Label ID="Label14" runat="server"></asp:Label>
                        </td>
                    </tr>
                </table>
            </fieldset>

    protected void btClick_GetOrderTrace(object sender, EventArgs e)
            {
    
                var orderCode = TextBox29.Text.Trim();
                try
                {
                    if (!string.IsNullOrWhiteSpace(orderCode))
                    {
    
                        RB.Model.RB_OrderInfo orderInfo = null;
                        RB.Model.RB_OrderSource_EbayAmazonAPI api = null;
                        using (var hp = new DALHelper())
                        {
                            orderInfo = hp.GET<RB.DAL.RB_OrderInfo>().GetOrderInfoByPrimaryKey(base.CustomerID,orderCode);
                            if (orderInfo == null || orderInfo.ID == 0)
                            {
                                Label14.Text = "没有找到订单" + orderCode + "信息";
                            }
                            else
                            {
                                api = hp.GET<RB.DAL.RB_OrderSource_EbayAmazonAPI>().GetModelByOrderSourceID(base.CustomerID, orderInfo.OrderSourceID);
                            }
                        }
                        if (api == null || api.ID == 0)
                        {
                            Label14.Text = "没有找到渠道ID"+ orderInfo.OrderSourceID+ "的授权:";
                        }
                        else
                        {
                            var apiUtil = new Biz.Lazada.LazadaV2ApiUtil(base.CustomerID, orderInfo.OrderSourceID);
                            var request = new LazadaV2APIService.Request.GetOrderTraceRequest
                            {
                                OrderId=orderInfo.ClientOrderCode
                            };
                            var response= apiUtil.Execute<LazadaV2APIService.Response.GetOrderTraceResponse>(request);
                            Label14.Text = response.ObjectToJson();
                        }
                    }
                    else
                    {
                        Label14.Text = "请输入系统订单号";
                    }
    
                }
                catch (Exception ex)
                {
                    Label14.Text = ex.Message;
                }
    
            }


  4. 2023-01-09 18:48:12, 由 谢业福 完成。
    修改了 总计消耗,旧值为 "0",新值为 "4"。
    修改了 实际完成,旧值为 "",新值为 "2023-01-09 18:48:07"。
    修改了 任务状态,旧值为 "wait",新值为 "done"。
    修改了 实际开始,旧值为 "0000-00-00 00:00:00",新值为 "2023-01-09 18:48:12"。
    修改了 预计剩余,旧值为 "4",新值为 "0"。
    修改了 由谁完成,旧值为 "",新值为 "xieyefu"。
  5. 2023-02-01 13:58:29, 由 zhengqiao 关闭。
    修改了 任务状态,旧值为 "done",新值为 "closed"。
    修改了 指派给 ,旧值为 "xieyefu",新值为 "closed"。
    修改了 由谁关闭,旧值为 "",新值为 "zhengqiao"。
    修改了 关闭时间,旧值为 "0000-00-00 00:00:00",新值为 "2023-02-01 13:58:29"。
    修改了 关闭原因,旧值为 "",新值为 "done"。
所属迭代 技术研发中心 1月分支版本(2023年)
所属模块 /
相关需求 lazada物流轨迹对接
指派给 Closed 于 2023-02-01 13:58:29
任务类型 后端
任务标签 初始
开发组
任务状态 已关闭
进度 100%
优先级 P2
关键词
抄送给
由谁创建 程伟 于 2023-01-06 09:51:59
由谁完成 谢业福 于 2023-01-09 18:48:07
由谁取消 暂无
由谁关闭 zhengqiao 于 2023-02-01 13:58:29
关闭原因 已完成
最后编辑 zhengqiao 于 2023-02-01 13:58:29
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 4工时
总计消耗 4工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 2023-01-09
截止日期 0000-00-00