Api-订单物流查询

该api为通过接口获取产品订单物流查询
备注:原订单后期不方便查询订单的跟单信息,请每12小时请更新一下未获取到跟单信息的原始订单号,更快捷更新订单跟单号相关信息。

准备工作

登录获取access-token,并将access-token设置为请求头参数,如何获取access-token,请参考“获取token文档

API说明:

URL: https://dpapi.quarkscm.com/v1/myorder/get-shipping-tracking-number

格式:JSON
方式:POST

请求参数说明:

请求头参数:

参数名称 是否必须 类型 描述
access-token 必须 string 登录后获取的token,此接口access-token必填

Body Form-Data:

参数名称 是否必须 类型 描述
orginal_order_no 必须 String 商家订单号

请求参数示例如下:

{
    "orginal_order_no": "D3381-2"
}

返回参数说明 :

格式:json

参数名称 是否必须 类型 描述
code 必须 integer 状态码
data 不必须 array 请求成功为data数组数据,请求失败则无此参数
message 不必须 string 请求失败返回错误信息,请求成功则无此参数

返回数据data参数说明:

参数名称 类型 描述
ship_confirm_date string 发货日期
order_no string 包裹号
track_number string 追踪号
track_updated string 追踪号追踪更新时间
order_refund_border string 订单退件类型
refund_verify_type int 退款类型
return_date string 退款日期
sale_status int 销售状态
shipping_company_id int 渠道id
shipping_cost int 运费
shipping_type int 订单渠道
shipping_verify_date string 渠道复核时间
shipping_weight string 订单包裹重量
order_id string 订单ID,唯一标识
order_status int 订单状态
localTrackNumber string 平邮追踪号
is_register string 发货代码
clientTrackNumber string 客户追踪号
sku array Sku集合
sku_info array Sku信息集合
sku_qty int SKU数量
sku_type int SKU类型
spu array 商品SPU
stock_id int 仓库id
stock_code int 仓库代号
shipping_method string 运输方式简码
shipping_method_en_name string 运输方式英文名称
shipping_method_ch_name string 运输方式中文名称
subtotal string 商品价格
handle_fee string 仓库处理费
package_fee string 打包费
insurance_fee string 运费险
shipping_cost string 物流费
grand_total string 总价

返回参数示例:

返回参数详细:

1.成功:返回参数

{
    "code": 200,
    "data": [
    {
        "item_id": "QSCM1100000236",
        "ship_confirm_date": "2017-07-25 16:30:14",
        "order_no": "No.16620170725-57580324-ZDP",
        "track_number": "1Z06981A6898663975",
        "track_updated": "2017-10-19 15:35:22",
        "sale_status": "140",
        "shipping_company_id": "77",
        "shipping_type": "10",
        "shipping_verify_date": "2017-07-25 16:30:14",
        "shipping_weight": "1335",
        "order_id": "57580324",
        "order_status": "140",
        "localTrackNumber": null,
        "is_register": "ZDP",
        "clientTrackNumber": null,
        "sku": ["RM7101US"],
        "sku_info": [
        {
            "qty": 1,
            "sku": "RM7101US"
        }],
        "sku_qty": "1",
        "sku_type": "1",
        "spu": null,
        "stock_id": "7",
        "stock_code": "SZ1",
        "shipping_method": "HW",
        "shipping_method_en_name": "China USPS",
        "shipping_method_ch_name": "wish平台E邮宝(0-2kg)",
        "subtotal": "3.18",
        "handle_fee": "0.27",
        "package_fee": "0.08",
        "insurance_fee": "0",
        "shipping_cost": "2.97",
        "grand_total": "6.50"
    }]
}

2.失败:返回参数

2.1 参数不完整

{
    "code": 401,
    "message": "Parameter missing",
}

2.2 订单不存在

{
    "code": 402,
    "message": "Order that don't exist",
}

php 代码示例:

<?php
function getCurlData($url,$type="get",$data=array(),$timeout = 10) {
    //对空格进行转义
    $http_header = array();
    if(isset($data['access-token'])){
        $http_header[] = 'access-token: ' . $data['access-token'];
        unset($data['access-token']);
    }
    $url = str_replace(' ','+',$url);
    if (strtolower($type) == "get") {
        if (!empty($data) && is_array($data)) {
            $arr = [];
            foreach ($data as $k=>$v) {
                $arr[] = $k."=".$v;
            }
            $str = implode("&",$arr);
            if (strstr($url,"?")) {
                $url .= "&".$str;
            } else {
                $url .= "?".$str;
            }
        }
    }
    
    $ch   = curl_init();
    curl_setopt($ch, CURLOPT_URL, "$url");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch,CURLOPT_TIMEOUT,$timeout);  //定义超时3秒钟
    if(strtolower($type) == "post"){
        $data = json_encode($data);
        // POST数据
        curl_setopt($ch, CURLOPT_POST, 1);
        $http_header[] = 'Accept: application/json';
        $http_header[] = 'Content-Type: application/json';
        $http_header[] = 'Content-Length: ' . strlen($data);

        // 把post的变量加上
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    }
    curl_setopt($ch, CURLOPT_HTTPHEADER,$http_header);
    //执行并获取url地址的内容
    $output = curl_exec($ch);
    //echo $output ;
    //释放curl句柄
    curl_close($ch);
    //var_dump($output);exit;
    return $output;
}
$url = 'https://dpapi.quarkscm.com/v1/myorder/get-shipping-tracking-number';
$data['access-token'] = "c_xyXeQgyKcWHM9kS0yukwlC5bgMVJST";
$data['orginal_order_no'] = "O2011120216320581";
$res = getCurlData($url,'post',$data);
echo $res;
?>

返回json结果:

{
    "code": 200,
    "data": [
    {
        "id": "3",
        "item_id": "QSCM1100000236",
        "customer_id": "2",
        "ship_confirm_date": "2017-07-25 16:30:14",
        "order_no": "No.16620170725-57580324-ZDP",
        "track_number": "1Z06981A6898663975",
        "track_updated": "2017-10-19 15:35:22",
        "sale_status": "140",
        "shipping_company_id": "77",
        "shipping_type": "10",
        "shipping_verify_date": "2017-07-25 16:30:14",
        "shipping_weight": "1335",
        "order_id": "57580324",
        "order_status": "140",
        "localTrackNumber": null,
        "is_register": "ZDP",
        "clientTrackNumber": null,
        "sku": ["RM7101US"],
        "sku_info": [
        {
            "qty": 1,
            "sku": "RM7101US"
        }],
        "sku_qty": "1",
        "sku_type": "1",
        "spu": null,
        "stock_id": "7",
        "stock_code": "SZ1",
        "shipping_method": "HW",
        "shipping_method_en_name": "China USPS",
        "shipping_method_ch_name": "wish平台E邮宝(0-2kg)",
        "subtotal": "3.18",
        "handle_fee": "0.27",
        "package_fee": "0.08",
        "insurance_fee": "0",
        "shipping_cost": "2.97",
        "grand_total": "6.50"
    }]
}