淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
waybill_apply_new_request	WaybillApplyNewRequest	必须			面单申请
└ cp_code String 必须 ZTO 物流服务商编码 shipping_address WaybillAddress 必须收\发货地址 └ address_detail String 必须朝阳路高井，财满街，财经中心9号楼21单元6013 详细地址 └ area String 可选朝阳区区名称（三级地址） └ city String 可选北京市市名称（二级地址） └ province String 必须北京省名称（一级地址） └ town String 可选八里庄街道\镇名称（四级地址） trade_order_info_cols TradeOrderInfo [] 必须订单数据 consignee_address WaybillAddress 必须收\发货地址 └ address_detail String 必须朝阳路高井，财满街，财经中心9号楼21单元6013 详细地址 └ area String 可选朝阳区区名称（三级地址） └ city String 可选北京市市名称（二级地址） └ province String 必须北京省名称（一级地址） └ town String 可选八里庄街道\镇名称（四级地址） └ consignee_name String 必须张三收货人 └ consignee_phone String 必须 13242422352 收货人联系方式 logistics_service_list LogisticsService [] 可选物流服务能力集合 └ service_code String 可选 SVC-DELIVERY-ENV 服务编码 └ service_value4_json String 可选 { "value": "100.00","currency": "CNY","ensure_type": "0"} 服务类型值，json格式表示 └ order_channels_type String 必须 TB 订单渠道 package_items PackageItem [] 必须包裹里面的商品名称 └ count Number 必须 123 商品数量 └ item_name String 必须衣服商品名称 └ product_type String 必须 STANDARD_EXPRESS 快递服务产品类型编码 └ send_name String 可选李四发货人姓名 └ send_phone String 可选 13242422352 发货人联系方式 └ trade_order_list String [] 必须 12321321,12321321 交易订单列表 └ real_user_id Number 必须 13123 使用者ID └ volume Number 可选 123 包裹体积（立方厘米） └ weight Number 可选 123 包裹重量（克） └ package_id String 可选 E12321321-1234567 包裹号(或者ERP订单号)

名称	类型	示例值	描述
waybill_apply_new_cols	WaybillApplyNewInfo []		面单申请接口返回信息
└ consignee_branch_code String 123132 包裹对应的派件（收件）物流服务商网点（分支机构）代码 └ consignee_branch_name String 余杭一部包裹对应的派件（收件）物流服务商网点（分支机构）名称 └ package_center_code String 123321 集包地代码 └ package_center_name String 杭州余杭集包地名称 └ print_config String SDFASFAFSAFSADF 打印配置项，传给ali-print组件 └ shipping_branch_code String 123132 面单号对应的物流服务商网点（分支机构）代码 └ shipping_branch_name String 西湖二部面单号对于的物流服务商网点（分支机构）名称 └ short_address String hello world 根据收货地址返回大头笔信息 trade_order_info TradeOrderInfo 面单对应的订单列 consignee_address WaybillAddress 收货人地址 └ address_detail String 朝阳路高井，财满街，财经中心9号楼21单元6013 详细地址 └ area String 朝阳区区名称（三级地址） └ city String 北京市市名称（二级地址） └ province String 北京省名称（一级地址） └ town String 八里庄街道\镇名称（四级地址） └ consignee_name String 张三收货人 └ consignee_phone String 13242422352 收货人联系方式 logistics_service_list LogisticsService [] 物流服务能力集合 └ service_code String SVC-DELIVERY-ENV 服务编码 └ service_value4_json String { "value": "100.00","currency": "CNY","ensure_type": "0"} 服务类型值，json格式表示 └ order_channels_type String TB 订单渠道 └ package_id String E12321321-1234567 包裹号(或者ERP订单号) package_items PackageItem [] 包裹中的商品类型 └ count Number 123 商品数量 └ item_name String 衣服商品名称 └ product_type String STANDARD_EXPRESS 快递服务产品类型编码 └ send_name String 李四发货人姓名 └ send_phone String 13242422352 发货人联系方式 └ trade_order_list String [] 12321321,12321321 交易订单列表 └ real_user_id Number 123232 使用者ID └ volume Number 123 包裹体积（立方厘米） └ weight Number 123 包裹重量（克） └ waybill_code String hello world 返回的面单号

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWaybillIGetRequest req = new WlbWaybillIGetRequest();
WlbWaybillIGetRequest.WaybillApplyNewRequest obj1 = new WlbWaybillIGetRequest.WaybillApplyNewRequest();
obj1.setCpCode("ZTO");
WlbWaybillIGetRequest.WaybillAddress obj2 = new WlbWaybillIGetRequest.WaybillAddress();
obj2.setAddressDetail("朝阳路高井，财满街，财经中心9号楼21单元6013");
obj2.setArea("朝阳区");
obj2.setCity("北京市");
obj2.setProvince("北京");
obj2.setTown("八里庄");
obj1.setShippingAddress(obj2);
List<WlbWaybillIGetRequest.TradeOrderInfo> list4 = new ArrayList<WlbWaybillIGetRequest.TradeOrderInfo>();
WlbWaybillIGetRequest.TradeOrderInfo obj5 = new WlbWaybillIGetRequest.TradeOrderInfo();
list4.add(obj5);
WlbWaybillIGetRequest.WaybillAddress obj7 = new WlbWaybillIGetRequest.WaybillAddress();
obj7.setAddressDetail("朝阳路高井，财满街，财经中心9号楼21单元6013");
obj7.setArea("朝阳区");
obj7.setCity("北京市");
obj7.setProvince("北京");
obj7.setTown("八里庄");
list6.setConsigneeAddress(obj7);
obj5.setConsigneeName("张三");
obj5.setConsigneePhone("13242422352");
List<WlbWaybillIGetRequest.LogisticsService> list10 = new ArrayList<WlbWaybillIGetRequest.LogisticsService>();
WlbWaybillIGetRequest.LogisticsService obj11 = new WlbWaybillIGetRequest.LogisticsService();
list10.add(obj11);
obj11.setServiceCode("SVC-DELIVERY-ENV");
obj11.setServiceValue4Json("{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}");
list8.setLogisticsServiceList(list10);
obj5.setOrderChannelsType("TB");
List<WlbWaybillIGetRequest.PackageItem> list14 = new ArrayList<WlbWaybillIGetRequest.PackageItem>();
WlbWaybillIGetRequest.PackageItem obj15 = new WlbWaybillIGetRequest.PackageItem();
list14.add(obj15);
obj15.setCount(123L);
obj15.setItemName("衣服");
list12.setPackageItems(list14);
obj5.setProductType("STANDARD_EXPRESS");
obj5.setSendName("李四");
obj5.setSendPhone("13242422352");
obj5.setTradeOrderList("12321321,12321321");
obj5.setRealUserId(13123L);
obj5.setVolume(123L);
obj5.setWeight(123L);
obj5.setPackageId("E12321321-1234567");
obj1.setTradeOrderInfoCols(list4);
req.setWaybillApplyNewRequest(obj1);
WlbWaybillIGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
WlbWaybillIGetRequest req = new WlbWaybillIGetRequest();
WlbWaybillIGetRequest.WaybillApplyNewRequestDomain obj1 = new WlbWaybillIGetRequest.WaybillApplyNewRequestDomain();
obj1.CpCode = "ZTO";
WlbWaybillIGetRequest.WaybillAddressDomain obj2 = new WlbWaybillIGetRequest.WaybillAddressDomain();
obj2.AddressDetail = "朝阳路高井，财满街，财经中心9号楼21单元6013";
obj2.Area = "朝阳区";
obj2.City = "北京市";
obj2.Province = "北京";
obj2.Town = "八里庄";
obj1.ShippingAddress= obj2;
List<WlbWaybillIGetRequest.TradeOrderInfoDomain> list4 = new List<WlbWaybillIGetRequest.TradeOrderInfoDomain>();
WlbWaybillIGetRequest.TradeOrderInfoDomain obj5 = new WlbWaybillIGetRequest.TradeOrderInfoDomain();
list4.Add(obj5);
WlbWaybillIGetRequest.WaybillAddressDomain obj6 = new WlbWaybillIGetRequest.WaybillAddressDomain();
obj6.AddressDetail = "朝阳路高井，财满街，财经中心9号楼21单元6013";
obj6.Area = "朝阳区";
obj6.City = "北京市";
obj6.Province = "北京";
obj6.Town = "八里庄";
obj5.ConsigneeAddress= obj6;
obj5.ConsigneeName = "张三";
obj5.ConsigneePhone = "13242422352";
List<WlbWaybillIGetRequest.LogisticsServiceDomain> list8 = new List<WlbWaybillIGetRequest.LogisticsServiceDomain>();
WlbWaybillIGetRequest.LogisticsServiceDomain obj9 = new WlbWaybillIGetRequest.LogisticsServiceDomain();
list8.Add(obj9);
obj9.ServiceCode = "SVC-DELIVERY-ENV";
obj9.ServiceValue4Json = "{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}";
obj5.LogisticsServiceList= list8;
obj5.OrderChannelsType = "TB";
List<WlbWaybillIGetRequest.PackageItemDomain> list11 = new List<WlbWaybillIGetRequest.PackageItemDomain>();
WlbWaybillIGetRequest.PackageItemDomain obj12 = new WlbWaybillIGetRequest.PackageItemDomain();
list11.Add(obj12);
obj12.Count = 123L;
obj12.ItemName = "衣服";
obj5.PackageItems= list11;
obj5.ProductType = "STANDARD_EXPRESS";
obj5.SendName = "李四";
obj5.SendPhone = "13242422352";
obj5.TradeOrderList = "12321321,12321321";
obj5.RealUserId = 13123L;
obj5.Volume = 123L;
obj5.Weight = 123L;
obj5.PackageId = "E12321321-1234567";
obj1.TradeOrderInfoCols= list4;
req.WaybillApplyNewRequest_ = obj1;
WlbWaybillIGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new WlbWaybillIGetRequest;
$waybill_apply_new_request = new WaybillApplyNewRequest;
$waybill_apply_new_request->cp_code="ZTO";
$shipping_address = new WaybillAddress;
$shipping_address->address_detail="朝阳路高井，财满街，财经中心9号楼21单元6013";
$shipping_address->area="朝阳区";
$shipping_address->city="北京市";
$shipping_address->province="北京";
$shipping_address->town="八里庄";
$waybill_apply_new_request->shipping_address = $shipping_address;
$trade_order_info_cols = new TradeOrderInfo;
$consignee_address = new WaybillAddress;
$consignee_address->address_detail="朝阳路高井，财满街，财经中心9号楼21单元6013";
$consignee_address->area="朝阳区";
$consignee_address->city="北京市";
$consignee_address->province="北京";
$consignee_address->town="八里庄";
$trade_order_info_cols->consignee_address = $consignee_address;
$trade_order_info_cols->consignee_name="张三";
$trade_order_info_cols->consignee_phone="13242422352";
$logistics_service_list = new LogisticsService;
$logistics_service_list->service_code="SVC-DELIVERY-ENV";
$logistics_service_list->service_value4_json="{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}";
$trade_order_info_cols->logistics_service_list = $logistics_service_list;
$trade_order_info_cols->order_channels_type="TB";
$package_items = new PackageItem;
$package_items->count="123";
$package_items->item_name="衣服";
$trade_order_info_cols->package_items = $package_items;
$trade_order_info_cols->product_type="STANDARD_EXPRESS";
$trade_order_info_cols->send_name="李四";
$trade_order_info_cols->send_phone="13242422352";
$trade_order_info_cols->trade_order_list="12321321,12321321";
$trade_order_info_cols->real_user_id="13123";
$trade_order_info_cols->volume="123";
$trade_order_info_cols->weight="123";
$trade_order_info_cols->package_id="E12321321-1234567";
$waybill_apply_new_request->trade_order_info_cols = $trade_order_info_cols;
$req->setWaybillApplyNewRequest(json_encode($waybill_apply_new_request));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.wlb.waybill.i.get' \
-d 'partner_id=apidoc' \
-d 'session=a7f3a7c1-2ac5-43ed-a2fd-5fb5c1fa3c2d' \
-d 'sign=83AB8DD0065FB1EBBE95E942F6B7C60C' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-13+18%3A41%3A13' \
-d 'v=2.0' \
-d 'waybill_apply_new_request=null'

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

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

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

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.wlb.waybill.i.get");
add_param(pRequest,"waybill_apply_new_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.wlb.waybill.i.get', {
	'waybill_apply_new_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<wlb_waybill_i_get_response>
    <waybill_apply_new_cols>
        <waybill_apply_new_info>
            <consignee_branch_code>123132</consignee_branch_code>
            <consignee_branch_name>余杭一部</consignee_branch_name>
            <package_center_code>123321</package_center_code>
            <package_center_name>杭州余杭</package_center_name>
            <print_config>SDFASFAFSAFSADF</print_config>
            <shipping_branch_code>123132</shipping_branch_code>
            <shipping_branch_name>西湖二部</shipping_branch_name>
            <short_address>hello world</short_address>
            <trade_order_info>
                <consignee_address>
                    <address_detail>朝阳路高井，财满街，财经中心9号楼21单元6013</address_detail>
                    <area>朝阳区</area>
                    <city>北京市</city>
                    <province>北京</province>
                    <town>八里庄</town>
                </consignee_address>
                <consignee_name>张三</consignee_name>
                <consignee_phone>13242422352</consignee_phone>
                <logistics_service_list>
                    <logistics_service>
                        <service_code>SVC-DELIVERY-ENV</service_code>
                        <service_value4_json>{ &quot;value&quot;: &quot;100.00&quot;,&quot;currency&quot;: &quot;CNY&quot;,&quot;ensure_type&quot;: &quot;0&quot;}</service_value4_json>
                    </logistics_service>
                </logistics_service_list>
                <order_channels_type>TB</order_channels_type>
                <package_id>E12321321-1234567</package_id>
                <package_items>
                    <package_item>
                        <count>123</count>
                        <item_name>衣服</item_name>
                    </package_item>
                </package_items>
                <product_type>STANDARD_EXPRESS</product_type>
                <send_name>李四</send_name>
                <send_phone>13242422352</send_phone>
                <trade_order_list>
                    <string>12321321</string>
                    <string>12321321</string>
                </trade_order_list>
                <real_user_id>123232</real_user_id>
                <volume>123</volume>
                <weight>123</weight>
            </trade_order_info>
            <waybill_code>hello world</waybill_code>
        </waybill_apply_new_info>
    </waybill_apply_new_cols>
</wlb_waybill_i_get_response>

{
    "wlb_waybill_i_get_response":{
        "waybill_apply_new_cols":{
            "waybill_apply_new_info":[
                {
                    "consignee_branch_code":"123132",
                    "consignee_branch_name":"余杭一部",
                    "package_center_code":"123321",
                    "package_center_name":"杭州余杭",
                    "print_config":"SDFASFAFSAFSADF",
                    "shipping_branch_code":"123132",
                    "shipping_branch_name":"西湖二部",
                    "short_address":"hello world",
                    "trade_order_info":{
                        "consignee_address":{
                            "address_detail":"朝阳路高井，财满街，财经中心9号楼21单元6013",
                            "area":"朝阳区",
                            "city":"北京市",
                            "province":"北京",
                            "town":"八里庄"
                        },
                        "consignee_name":"张三",
                        "consignee_phone":"13242422352",
                        "logistics_service_list":{
                            "logistics_service":[
                                {
                                    "service_code":"SVC-DELIVERY-ENV",
                                    "service_value4_json":"{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}"
                                }
                            ]
                        },
                        "order_channels_type":"TB",
                        "package_id":"E12321321-1234567",
                        "package_items":{
                            "package_item":[
                                {
                                    "count":123,
                                    "item_name":"衣服"
                                }
                            ]
                        },
                        "product_type":"STANDARD_EXPRESS",
                        "send_name":"李四",
                        "send_phone":"13242422352",
                        "trade_order_list":{
                            "string":[
                                "12321321",
                                "12321321"
                            ]
                        },
                        "real_user_id":123232,
                        "volume":123,
                        "weight":123
                    },
                    "waybill_code":"hello world"
                }
            ]
        }
    }
}

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.province of consigneeAddress can not be null	请求的省份为空	请添加省份信息
isv.waybill account not enough	电子面单单号余额不足	请联系对应网点进行充值
isv.subscribe service not found	没有开通对应快递公司的电子面单服务	请在卖家中心开通对应快递公司的电子面单服务
isv.shipping address cannot match any service	请求的发货地址与申请服务的地址不匹配	请检查参数
isv.detail consigneeAddress can not be null	详细地址不能为空	请检查参数
isv.consignee_address_area_too_long	收货地址太长	请检查参数
isv.request bizOrderCode has cross for exist!	申请的订单号已经被使用	请将重复申请的订单号删除
isv.phone of consignee too long	联系电话太长	联系电话请保持20位以内
isv.trade item into can not be null	商品信息不能为空	请检查参数
isv.province of shippingAddress can not be null	发件人的省份不能为空	请检查参数
isv.phone of consignee can not be null	联系人电话不能为空	请检查参数
PACKAGE_NOT_REACHABLE	该订单超出物流商承运范围	联系当地物流承运商
trade order code too long	商家请求参数非法,交易订单号太长(最长为40)	检查入参是否错误
subscribe service not found	面单订购服务不存在	确认是否已订购,已订购请联系菜鸟排查
consignee_address_province_too_long	收货地址省份信息过长(最长20)	检查参数中收货人省份信息长度,缩减长度
waybill account not enough	账户余额不足	请联系快递网点充值
phone or mobile illegal	电话或者手机号非法	检查手机号或者电话是否有误
shipping address cannot match any service	发货地址没有匹配的电子面单服务	请检查取号时的发货地址是否商家订购的地址，可通过订购关系查询接口获取
BRAND_CODE_NULL	品牌编码为空，顺丰新订购链路取号需要传品牌编码，顺丰速运传SF,顺丰快运传FOP，顺丰丰网传FW。	检查取号接口的brand_code入参
phone of consignee too long	字段长度超过限制	请参见白皮书字段长度限制
consignee_address_detail_too_long	收货地址详细地址信息过长	减少详细地址长度
name of consignee too long	收货人姓名长度超过限制(最长40)	检查参数中收货人姓名长度,缩减长度
name of consignee can not be null	收件人姓名字段不能为空	请检查代码

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

开放平台

电子面单API

taobao.wlb.waybill.i.get (获取物流服务商电子面单号v1.0)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ