淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
wlb_order_code	String	必须	LBX0011922059003		物流宝订单编码

名称	类型	示例值	描述
wlb_order	WlbOrder		物流宝订单对象
└ operate_type String IN 出库或者入库，IN表示入库，OUT表示出库 └ order_code String LP12312312 订单编码 └ order_source String TAOBAO 订单来源: 产生物流订单的原因，比如: 订单来源:1:TAOBAO;2:EXT;3:ERP;4:WMS └ order_source_code String 43112312312 对应创建物流宝订单top接口中的的out_biz_code字段，主要是用来去重用 └ order_type String NORMAL 1:正常订单: NORMAL 2:退货订单: RETURN 3:换货订单: CHANGE └ order_sub_type String TAOBAO (1)其它: OTHER (2)淘宝交易: TAOBAO (3)301:调拨: ALLOCATION (4)401:盘点:CHECK (5)501:销售采购:PRUCHASE └ total_amount Number 100 订单总价 └ user_id String 321123 卖家ID └ user_nick String eyyatta 卖家NICK └ store_code String BEST-0001 仓库编码 └ tms_tp_code String STO 发货物流公司编码，STO,YTO,EMS等 └ order_status String 0 物流状态，订单已创建：0 订单已取消: -1 订单关闭:-3 下发中: 10 已下发: 11 TMS拒签 :-100 接收方拒签：-200 已发货:100 签收成功:200 └ order_status_reason String 卖家取消卖家取消,仓库取消标识 └ remark String 备注订单备注 └ prev_order_code String LP0123123 原订单编码 └ is_completed Boolean true 系统自动生成 └ buyer_nick String littlecat 买家nick └ receiver_name String 张三接收人姓名 └ receiver_wangwang String little_cat 接收人旺旺 └ receiver_mail String little_cat@163.com 收件人邮箱 └ receiver_zip_code String 310016 收件人邮编 └ receiver_mobile String 13562548935 接收人手机号码 └ receiver_phone String 88155189 接收人固定电话 └ invoice_info String 抬头:**有限公司发票信息 └ order_flag Number 3 第1位:COD,2:限时配送,3:预售,4:需要发票,5:已投诉,第6位:合单,第7位:拆单第8位：EXCHANGE-换货，第9位:VISIT-上门，第10位: MODIFYTRANSPORT-是否可改配送方式，第11位：是否物流代理确认发货 └ receivable_amount Number 10000 应收金额 └ receiver_province String 浙江省收件人省份 └ receiver_city String 绍兴市收件人城市 └ receiver_area String 越城区区或者县 └ receiver_address String 跃升公寓2幢2单元504 收件人具体地址 └ service_fee Number 300 cod服务费 └ cancel_order_status Number 1 订单取消状态： 1-取消中； 2-取消失败； 3-取消完成 └ sender_province String 浙江省发件人所在省份 └ sender_city String 杭州发件人城市 └ sender_area String 西湖区发件人所在区 └ sender_address String 浙江省杭州市西湖区发件人地址 └ sender_name String 小a 发件人姓名 └ sender_email String aa@taobao.com 发件人电子邮箱 └ sender_phone String 0571-88155188 发件人联系电话 └ sender_mobile String 13569856256 发件人移动电话 └ sender_zip_code String 310023 发件人邮编 └ schedule_day String 12:40 配送开始时间通常是HH:MM格式 └ schedule_end String 17:40 配送结束时间通常是HH:MM格式 └ expect_start_time Date 2000-01-01 00:00:00 计划送达开始时间 └ expect_end_time Date 2000-01-01 00:00:00 计划送达结束时间 └ schedule_speed Number 101 发货速度， 101-当日达， 102-次晨达， 103-次日达

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWlborderGetRequest req = new WlbWlborderGetRequest();
req.setWlbOrderCode("LBX0011922059003");
WlbWlborderGetResponse response = client.execute(req , sessionKey);

ITopClient client = new DefaultTopClient(url, appkey, appsecret);
WlbWlborderGetRequest req=new WlbWlborderGetRequest();
req.WlbOrderCode = "LBX0011922059003";
WlbWlborderGetResponse response = client.Execute(req, sessionKey);

$c = new TopClient;
$c->appkey = appkey;
$c->secretKey = secret;
$req = new WlbWlborderGetRequest;
$req->setWlbOrderCode("LBX0011922059003");
$resp = $c->execute($req, $sessionKey);

# -*- coding: utf-8 -*-
import top.api

req=top.api.WlbWlborderGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.wlb_order_code="LBX0011922059003"
try:
resp= req.getResponse(sessionkey)
print(resp)
except Exception,e:
print(e)

XML示例
JSON示例

<wlb_wlborder_get_response>
    <wlb_order>
        <operate_type>IN</operate_type>
        <order_code>LP12312312</order_code>
        <order_source>TAOBAO</order_source>
        <order_source_code>43112312312</order_source_code>
        <order_type>NORMAL</order_type>
        <order_sub_type>TAOBAO</order_sub_type>
        <total_amount>100</total_amount>
        <user_id>321123</user_id>
        <user_nick>eyyatta</user_nick>
        <store_code>BEST-0001</store_code>
        <tms_tp_code>STO</tms_tp_code>
        <order_status>0</order_status>
        <order_status_reason>卖家取消</order_status_reason>
        <remark>备注</remark>
        <prev_order_code>LP0123123</prev_order_code>
        <is_completed>true</is_completed>
        <buyer_nick>littlecat</buyer_nick>
        <receiver_name>张三</receiver_name>
        <receiver_wangwang>little_cat</receiver_wangwang>
        <receiver_mail>little_cat@163.com</receiver_mail>
        <receiver_zip_code>310016</receiver_zip_code>
        <receiver_mobile>13562548935</receiver_mobile>
        <receiver_phone>88155189</receiver_phone>
        <invoice_info>抬头:**有限公司</invoice_info>
        <order_flag>3</order_flag>
        <receivable_amount>10000</receivable_amount>
        <receiver_province>浙江省</receiver_province>
        <receiver_city>绍兴市</receiver_city>
        <receiver_area>越城区</receiver_area>
        <receiver_address>跃升公寓2幢2单元504</receiver_address>
        <service_fee>300</service_fee>
        <cancel_order_status>1</cancel_order_status>
        <sender_province>浙江省</sender_province>
        <sender_city>杭州</sender_city>
        <sender_area>西湖区</sender_area>
        <sender_address>浙江省杭州市西湖区</sender_address>
        <sender_name>小a</sender_name>
        <sender_email>aa@taobao.com</sender_email>
        <sender_phone>0571-88155188</sender_phone>
        <sender_mobile>13569856256</sender_mobile>
        <sender_zip_code>310023</sender_zip_code>
        <schedule_day>12:40</schedule_day>
        <schedule_end>17:40</schedule_end>
        <expect_start_time>2000-01-01 00:00:00</expect_start_time>
        <expect_end_time>2000-01-01 00:00:00</expect_end_time>
        <schedule_speed>101</schedule_speed>
    </wlb_order>
</wlb_wlborder_get_response>

{
    "wlb_wlborder_get_response":{
        "wlb_order":{
            "operate_type":"IN",
            "order_code":"LP12312312",
            "order_source":"TAOBAO",
            "order_source_code":"43112312312",
            "order_type":"NORMAL",
            "order_sub_type":"TAOBAO",
            "total_amount":100,
            "user_id":"321123",
            "user_nick":"eyyatta",
            "store_code":"BEST-0001",
            "tms_tp_code":"STO",
            "order_status":"0",
            "order_status_reason":"卖家取消",
            "remark":"备注",
            "prev_order_code":"LP0123123",
            "is_completed":true,
            "buyer_nick":"littlecat",
            "receiver_name":"张三",
            "receiver_wangwang":"little_cat",
            "receiver_mail":"little_cat@163.com",
            "receiver_zip_code":"310016",
            "receiver_mobile":"13562548935",
            "receiver_phone":"88155189",
            "invoice_info":"抬头:**有限公司",
            "order_flag":3,
            "receivable_amount":10000,
            "receiver_province":"浙江省",
            "receiver_city":"绍兴市",
            "receiver_area":"越城区",
            "receiver_address":"跃升公寓2幢2单元504",
            "service_fee":300,
            "cancel_order_status":1,
            "sender_province":"浙江省",
            "sender_city":"杭州",
            "sender_area":"西湖区",
            "sender_address":"浙江省杭州市西湖区",
            "sender_name":"小a",
            "sender_email":"aa@taobao.com",
            "sender_phone":"0571-88155188",
            "sender_mobile":"13569856256",
            "sender_zip_code":"310023",
            "schedule_day":"12:40",
            "schedule_end":"17:40",
            "expect_start_time":"2000-01-01 00:00:00",
            "expect_end_time":"2000-01-01 00:00:00",
            "schedule_speed":101
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.wlb-error:40007	查询不到任何结果	查询结果为空

API测试工具错误码查询工具 SDK下载

开放平台

物流宝API

taobao.wlb.wlborder.get (根据物流宝订单编号查询物流宝订单概要信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ