物流流转信息查询

物流流转信息查询

用户根据淘宝交易号查询物流流转信息， 如2010-8-10 15：23：00到达杭州集散地。
此接口的返回信息都由物流公司提供。（备注：使用线下发货（offline.send）的运单，不支持运单状态的实时跟踪，只要一发货，状态就会变为对方已签收，该字段仅对线上发货（online.send）的运单有效。）

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/logistices/tracesearch

2. 请求示例代码(Java)

  @Test
    public void  TaoBaoLogisticesTraceSearchUrl() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tb_seller_nick", tb_seller_nick);
        // 淘宝交易号，请勿传非淘宝交易号
         data.put("tid", "1276643677752460576");
         //data.put("is_split", "1");// 表明是否是拆单，默认值0，1表示拆单
         //data.put("sub_tid", "1913286207344933700");//拆单子订单列表，当is_split=1时，需要传人；对应的数据是：子订单号的列表。
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoLogisticesTraceSearchUrl ,data); 
    }

3. 返回结果如下（部分数据）：

{
    "code": 0,
    "message": "ok",
    "data": {
        "company_name": "韵达快递",
        "out_sid": "4313661400715", // 物流单号
        "request_id": "3nsp1xwz2uk2",
        "status": "订单已关闭（交易关闭或会员手工关闭）", // 订单的物流状态（仅支持线上发货online订单，线下发货offline发出后直接变为已签收） * 等候发送给物流公司 *已提交给物流公司,等待物流公司接单 *已经确认消息接收，等待物流公司接单 *物流公司已接单 *物流公司不接单 *物流公司揽收失败 *物流公司揽收成功 *签收失败 *对方已签收 *对方拒绝签收
        "tid": "1276643677752460576",  // 淘宝订单号
        "trace_list": {
            "transit_step_info": [{
                "action": "CREATE",  // 节点说明 ，指明当前节点揽收、派送，签收。 
                "status_desc": "商品已经下单",   // 状态描述 
                "status_time": "2021-04-12 14:24:11" // 描述发生时间
            }, {
                "action": "CONSIGN",
                "status_desc": "包裹正在等待揽收",
                "status_time": "2021-04-12 15:08:23"
            }, {
                "action": "TRADE_CLOSE_NO_CONSIGN",
                "status_desc": "交易关闭未发货", 
                "status_time": "2021-04-12 15:11:04"
            }]
        }
    }
}

说明： code为0表示成功， 非0为失败， 如果失败，msg会包含失败原因。

4. 其他说明

物流流转节点（action）可参考以下字段，物流节点是物流公司命名定义的，平台没有统一枚举，不同物流公司返回 action 的值不同，请以接口实际返回的数据为准，以下节点仅供参考：

1）CONSIGN(“等待揽收中”)，物流订单发货

2）GOT(“揽收成功”)，含义: 包裹已被揽收

3）ARRIVAL(“进站”)，含义: 包裹进入站点

4）DEPARTURE(“出站”)，含义: 包裹离开站点

5）SIGNED(“签收成功”)，含义: 包裹签收

6）SENT_SCAN(“派件扫描”)，含义: 包裹开始派送

7）FAILED(“签收失败/拒签”)，含义: 包裹签收失败/拒签

8）ERROR(“签收失败/拒签”)，含义: 包裹签收失败/拒签

9）LOST(“丢失”)，含义: 包裹丢失

10）OTHER(“其他事件/操作”)，含义: 其他事件