查询物流详情 | 大麦家礼品代发API

# 查询物流详情

接口地址： http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-orders-detail-get

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数	类型	必选	描述
shop_id	string	是	店铺 id
fields	string	是	需返回的字段列表。可选值：shipping 物流数据结构中所有字段。fileds 中可以指定返回以上任意一个或者多个字段，以","分隔。
tid	number	否	交易 id.如果加入 tid 参数的话，不用传其他的参数，但是仅会返回一条物流订单信息。
buyer_nick	string	否	买家昵称
status	string	否	物流状态。可查看数据结构 shipping 中的 status 字段。
seller_confirm	string	否	卖家是否发货。可选值：yes(是),no(否).如：yes.
receiver_name	string	否	收货人姓名
start_created	date	否	创建时间开始。格式：yyyy-MM-dd HH:mm:ss
end_created	date	否	创建时间结束。格式：yyyy-MM-dd HH:mm:ss
freight_payer	string	否	谁承担运费。可选值：buyer(买家),seller(卖家).如：buyer
type	string	否	物流方式。可选值：post(平邮),express(快递),ems(e_ms).如：post
page_no	number	否	页码。该字段没传或值 <1 ,则默认 page_no 为 1
page_size	number	否	每页条数。该字段没传或值 <1 ，则默认 page_size 为 40
edition	string	否	版本默认:1(不传默认为1) 1:1.0,2:2.0

# 请求示例

{
"shop_id":173926031,
    "params":{
"fields": "tid,order_code,seller_nick,buyer_nick,item_title,receiver_location,status,type,company_name,created,modified,is_quick_cod_order,sub_tids,is_split,receiver_location,receiver_name,receiver_phone,receiver_mobile",
"tid": 255222,
"buyer_nick": "*****",
"status": "c_re_at_ed",
"seller_confirm": "yes",
"receiver_name": "name",
"start_created": "2000-01-01 00:00:00",
"end_created": "2000-01-01 00:00:00",
"freight_payer": "buyer",
"type": "post",
"page_no": 1,
"page_size": 40
    }
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-orders-detail-get' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
"shopId": "1234",
"fields": "tid,orderCode,sellerNick,buyerNick,itemTitle,receiverLocation,status,type,companyName,created,modified,isQuickCodOrder,subTids,isSplit,receiverLocation,receiverName,receiverPhone,receiverMobile",
"tid": 255222,
"buyerNick": "*****",
"status": "CREATED",
"sellerConfirm": "yes",
"receiverName": "name",
"startCreated": "2000-01-01 00:00:00",
"endCreated": "2000-01-01 00:00:00",
"freightPayer": "buyer",
"type": "post",
"pageNo": 1,
"pageSize": 40
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-orders-detail-get',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
"shopId": "1234",
"fields": "tid,orderCode,sellerNick,buyerNick,itemTitle,receiverLocation,status,type,companyName,created,modified,isQuickCodOrder,subTids,isSplit,receiverLocation,receiverName,receiverPhone,receiverMobile",
"tid": 255222,
"buyerNick": "*****",
"status": "CREATED",
"sellerConfirm": "yes",
"receiverName": "name",
"startCreated": "2000-01-01 00:00:00",
"endCreated": "2000-01-01 00:00:00",
"freightPayer": "buyer",
"type": "post",
"pageNo": 1,
"pageSize": 40
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"shopId\": \"1234\",\r\n \"fields\": \"tid,orderCode,sellerNick,buyerNick,itemTitle,receiverLocation,status,type,companyName,created,modified,isQuickCodOrder,subTids,isSplit,receiverLocation,receiverName,receiverPhone,receiverMobile\",\r\n \"tid\": 255222,\r\n \"buyerNick\": \"*****\",\r\n \"status\": \"CREATED\",\r\n \"sellerConfirm\": \"yes\",\r\n \"receiverName\": \"name\",\r\n \"startCreated\": \"2000-01-01 00:00:00\",\r\n \"endCreated\": \"2000-01-01 00:00:00\",\r\n \"freightPayer\": \"buyer\",\r\n \"type\": \"post\",\r\n \"pageNo\": 1,\r\n \"pageSize\": 40\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-orders-detail-get")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-orders-detail-get"

payload = json.dumps({
"shopId": "1234",
"fields": "tid,orderCode,sellerNick,buyerNick,itemTitle,receiverLocation,status,type,companyName,created,modified,isQuickCodOrder,subTids,isSplit,receiverLocation,receiverName,receiverPhone,receiverMobile",
"tid": 255222,
"buyerNick": "*****",
"status": "CREATED",
"sellerConfirm": "yes",
"receiverName": "name",
"startCreated": "2000-01-01 00:00:00",
"endCreated": "2000-01-01 00:00:00",
"freightPayer": "buyer",
"type": "post",
"pageNo": 1,
"pageSize": 40
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# 响应参数

参数	类型	描述
data	object	返回数据
----shippings	Shipping []	获取的物流订单详情列表。返回的 Shipping 包含的具体信息为入参 fields 请求的字段信息。
----tid	Number	交易 ID
----order_code	String	物流订单编号
----status	String	物流订单状态，可选值：CREATED(订单已创建) RECREATED(订单重新创建) CANCELLED(订单已取消) CLOSED(订单关闭) SENDING(等候发送给物流公司) ACCEPTING(已发送给物流公司，等待接单) ACCEPTED(物流公司已接单) REJECTED(物流公司不接单) PICK_UP(物流公司揽收成功) PICK_UP_FAILED(物流公司揽收失败) LOST(物流公司丢单) REJECTED_BY_RECEIVER(对方拒签) ACCEPTED_BY_RECEIVER(发货方式在线下单：对方已签收；自己联系：卖家已发货)
----is_quick_cod_order	Boolean	标示为是否快捷 COD 订单
----seller_nick	String	卖家昵称
----buyer_nick	String	买家昵称
----delivery_start	Date	预约取货开始时间
----delivery_end	Date	预约取货结束时间
----out_sid	String	运单号。具体一个物流公司的运单号码。
----item_title	String	货物名称
----receiver_name	String	收件人姓名
----receiver_phone	String	收件人电话
----receiver_mobile	String	收件人手机号码
----location	Location	收件人地址信息(在传输请求参数 Fields 字段时，必须使用“receiver_location”才能返回此字段)
----zip	String	邮政编码
----address	String	详细地址，最大 256 个字节（128 个中文）
----city	String	所在城市（中文名称）
----state	String	所在省份（中文名称）
----country	String	国家名称
----district	String	区/县（只适用于物流 API）
----type	String	物流方式。可选值：free(卖家包邮),post(平邮),express(快递),ems(EMS).
----freight_payer	String	谁承担运费。可选值：buyer(买家承担),seller(卖家承担运费).
----seller_confirm	String	卖家是否确认发货。可选值：yes(是),no(否).
----company_name	String	物流公司名称
----created	Date	运单创建时间
----modified	Date	运单修改时间
----sub_tids	Number[]	拆单子订单列表，对应的数据是：该物流订单下的全部子订单
----is_split	Number	表明是否是拆单，默认值 0，1 表示拆单
----deduct_money	int	消耗点券
status	int	状态码，0为成功

# 返回数据

{
  "data": {
        "0":{
            "buyer_nick": "~yOlO+Nau***********1vgPL7Ej0u~1~~",
            "created": "2021-04-01 16:40:47",
            "is_quick_cod_order": false,
            "is_split": 0,
            "item_title": "婴幼儿童**********************宝***********多场景使用包",
            "location": {
                "address": "****",
                "city": "杭州市",
                "district": "西湖区",
                "state": "浙江省",
                "zip": "000000"
            },
            "modified": "2021-04-01 18:04:10",
            "order_code": "LP0***********40",
            "receiver_mobile": "$un9BDyLXr***********RmROJ7sKQoA==$1$$",
            "receiver_name": "~c7taW1O***********=~W+3x~1~~",
            "seller_nick": "tb5***********0350",
            "status": "CLOSED",
            "sub_tids": {
                "number": [
                    "16***********451"
                ]
            },
            "tid": "1692***********451",
            "type": "express"
        },
        "deduct_money": 4
},
  "status": 0
}

# 错误码

状态码(status)	错误信息	解决方案
132	请求格式必须为JSON	修改请求参数格式为json
422	参数列表不合法，在err中会给出提示	根据提示做相应修改
200	认证失败	请确保请求头里的Authorization存在或者未过期
422	参数：trade_id:P07 无效，格式不对、非法值、越界等	1. 在调用订单获取数据的时候，需要提前判断交易是否已经发货，对于没有发货的订单不要去取物流信息。2. 通过增量 API 接口同步订单的时候，不要同步 3 个月以外的订单，以防止取不到交易的情况。
2011	店铺未授权	使用已授权店铺
2010	未知错误请联系客服	联系客服

← 1-9_淘宝-快递公司查询 1-b_淘宝-线下物流发货 →