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"
}]
}