淘宝开放平台

请求地址：

环境	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_print_check_request	WaybillApplyPrintCheckRequest	必须			打印请求
└ cp_code String 必须 HTKY 物流服务商Code print_check_info_cols PrintCheckInfo [] 必须面单详情信息 consignee_address WaybillAddress 必须收\发货地址 └ address_detail String 必须朝阳路高井，财满街，财经中心9号楼21单元6013 详细地址 └ area String 可选朝阳区区名称（三级地址） └ city String 可选北京市市名称（二级地址） └ division_id Number 可选 123 末级地址 └ province String 必须北京省名称（一级地址） └ town String 可选八里庄街道\镇名称（四级地址） └ consignee_branch_code String 可选 12321 收货网点编码 └ consignee_branch_name String 可选一网点收货网点信息 └ consignee_name String 必须张三收件人姓名 └ consignee_phone String 必须 13264528362 consigneePhone logistics_service_list LogisticsService [] 可选物流服务能力集合 └ service_code String 可选 SVC-DELIVERY-ENV 服务编码 └ service_value4_json String 可选 { "value": "100.00","currency": "CNY","ensure_type": "0"} 服务类型值，json格式表示 └ package_center_code String 可选 123456 集包地、目的地中心代码。打印时根据该 code 生成目的地中心的条码，条码生成的算法与对应的电子面单条码一致 └ package_center_name String 可选浙江杭州集包地、目的地中心名称 └ print_config String 可选 DSFASFDASFDSAFDSAFA 打标设置字段，直接传给ali-lodop。不用管具体含义。 └ product_type String 可选 STANDARD_EXPRESS 快递服务产品类型编码 └ send_name String 可选李四发件人姓名 └ send_phone String 可选 12312312311 发件人联系方式 shipping_address WaybillAddress 必须收\发货地址 └ address_detail String 必须朝阳路高井，财满街，财经中心9号楼21单元6013 详细地址 └ area String 可选朝阳区区名称（三级地址） └ city String 可选北京市市名称（二级地址） └ division_id Number 可选 123 末级地址 └ province String 必须北京省名称（一级地址） └ town String 可选八里庄街道\镇名称（四级地址） └ shipping_branch_code String 可选 2323 发货网点编码 └ shipping_branch_name String 可选二网点发货网点信息 └ short_address String 可选余杭拣货规则（大头笔信息） └ real_user_id Number 可选 123 使用者ID └ volume Number 可选 123 包裹体积单位为ML(毫升)或立方厘米 └ waybill_code String 必须 132121 电子面单单号 └ weight Number 可选 123 包裹重量单位为G(克)

名称	类型	示例值	描述
waybill_apply_print_check_infos	WaybillApplyPrintCheckInfo []		面单打印信息
└ notice_code String detail status picked up or signed 打印提示信息编码 └ notice_message String 面单已经揽收或揽收，此面单属于重复打印打印提示信息 └ print_quantity Number 123 打印次数 └ waybill_code String 123123213 电子面单号

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WlbWaybillIPrintRequest req = new WlbWaybillIPrintRequest();
WlbWaybillIPrintRequest.WaybillApplyPrintCheckRequest obj1 = new WlbWaybillIPrintRequest.WaybillApplyPrintCheckRequest();
obj1.setCpCode("HTKY");
List<WlbWaybillIPrintRequest.PrintCheckInfo> list3 = new ArrayList<WlbWaybillIPrintRequest.PrintCheckInfo>();
WlbWaybillIPrintRequest.PrintCheckInfo obj4 = new WlbWaybillIPrintRequest.PrintCheckInfo();
list3.add(obj4);
WlbWaybillIPrintRequest.WaybillAddress obj6 = new WlbWaybillIPrintRequest.WaybillAddress();
obj6.setAddressDetail("朝阳路高井，财满街，财经中心9号楼21单元6013");
obj6.setArea("朝阳区");
obj6.setCity("北京市");
obj6.setDivisionId(123L);
obj6.setProvince("北京");
obj6.setTown("八里庄");
list5.setConsigneeAddress(obj6);
obj4.setConsigneeBranchCode("12321");
obj4.setConsigneeBranchName("一网点");
obj4.setConsigneeName("张三");
obj4.setConsigneePhone("13264528362");
List<WlbWaybillIPrintRequest.LogisticsService> list9 = new ArrayList<WlbWaybillIPrintRequest.LogisticsService>();
WlbWaybillIPrintRequest.LogisticsService obj10 = new WlbWaybillIPrintRequest.LogisticsService();
list9.add(obj10);
obj10.setServiceCode("SVC-DELIVERY-ENV");
obj10.setServiceValue4Json("{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}");
list7.setLogisticsServiceList(list9);
obj4.setPackageCenterCode("123456");
obj4.setPackageCenterName("浙江杭州");
obj4.setPrintConfig("DSFASFDASFDSAFDSAFA");
obj4.setProductType("STANDARD_EXPRESS");
obj4.setSendName("李四");
obj4.setSendPhone("12312312311");
WlbWaybillIPrintRequest.WaybillAddress obj12 = new WlbWaybillIPrintRequest.WaybillAddress();
obj12.setAddressDetail("朝阳路高井，财满街，财经中心9号楼21单元6013");
obj12.setArea("朝阳区");
obj12.setCity("北京市");
obj12.setDivisionId(123L);
obj12.setProvince("北京");
obj12.setTown("八里庄");
list11.setShippingAddress(obj12);
obj4.setShippingBranchCode("2323");
obj4.setShippingBranchName("二网点");
obj4.setShortAddress("余杭");
obj4.setRealUserId(123L);
obj4.setVolume(123L);
obj4.setWaybillCode("132121");
obj4.setWeight(123L);
obj1.setPrintCheckInfoCols(list3);
req.setWaybillApplyPrintCheckRequest(obj1);
WlbWaybillIPrintResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
WlbWaybillIPrintRequest req = new WlbWaybillIPrintRequest();
WlbWaybillIPrintRequest.WaybillApplyPrintCheckRequestDomain obj1 = new WlbWaybillIPrintRequest.WaybillApplyPrintCheckRequestDomain();
obj1.CpCode = "HTKY";
List<WlbWaybillIPrintRequest.PrintCheckInfoDomain> list3 = new List<WlbWaybillIPrintRequest.PrintCheckInfoDomain>();
WlbWaybillIPrintRequest.PrintCheckInfoDomain obj4 = new WlbWaybillIPrintRequest.PrintCheckInfoDomain();
list3.Add(obj4);
WlbWaybillIPrintRequest.WaybillAddressDomain obj5 = new WlbWaybillIPrintRequest.WaybillAddressDomain();
obj5.AddressDetail = "朝阳路高井，财满街，财经中心9号楼21单元6013";
obj5.Area = "朝阳区";
obj5.City = "北京市";
obj5.DivisionId = 123L;
obj5.Province = "北京";
obj5.Town = "八里庄";
obj4.ConsigneeAddress= obj5;
obj4.ConsigneeBranchCode = "12321";
obj4.ConsigneeBranchName = "一网点";
obj4.ConsigneeName = "张三";
obj4.ConsigneePhone = "13264528362";
List<WlbWaybillIPrintRequest.LogisticsServiceDomain> list7 = new List<WlbWaybillIPrintRequest.LogisticsServiceDomain>();
WlbWaybillIPrintRequest.LogisticsServiceDomain obj8 = new WlbWaybillIPrintRequest.LogisticsServiceDomain();
list7.Add(obj8);
obj8.ServiceCode = "SVC-DELIVERY-ENV";
obj8.ServiceValue4Json = "{ \"value\": \"100.00\",\"currency\": \"CNY\",\"ensure_type\": \"0\"}";
obj4.LogisticsServiceList= list7;
obj4.PackageCenterCode = "123456";
obj4.PackageCenterName = "浙江杭州";
obj4.PrintConfig = "DSFASFDASFDSAFDSAFA";
obj4.ProductType = "STANDARD_EXPRESS";
obj4.SendName = "李四";
obj4.SendPhone = "12312312311";
WlbWaybillIPrintRequest.WaybillAddressDomain obj9 = new WlbWaybillIPrintRequest.WaybillAddressDomain();
obj9.AddressDetail = "朝阳路高井，财满街，财经中心9号楼21单元6013";
obj9.Area = "朝阳区";
obj9.City = "北京市";
obj9.DivisionId = 123L;
obj9.Province = "北京";
obj9.Town = "八里庄";
obj4.ShippingAddress= obj9;
obj4.ShippingBranchCode = "2323";
obj4.ShippingBranchName = "二网点";
obj4.ShortAddress = "余杭";
obj4.RealUserId = 123L;
obj4.Volume = 123L;
obj4.WaybillCode = "132121";
obj4.Weight = 123L;
obj1.PrintCheckInfoCols= list3;
req.WaybillApplyPrintCheckRequest_ = obj1;
WlbWaybillIPrintResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new WlbWaybillIPrintRequest;
$waybill_apply_print_check_request = new WaybillApplyPrintCheckRequest;
$waybill_apply_print_check_request->cp_code="HTKY";
$print_check_info_cols = new PrintCheckInfo;
$consignee_address = new WaybillAddress;
$consignee_address->address_detail="朝阳路高井，财满街，财经中心9号楼21单元6013";
$consignee_address->area="朝阳区";
$consignee_address->city="北京市";
$consignee_address->division_id="123";
$consignee_address->province="北京";
$consignee_address->town="八里庄";
$print_check_info_cols->consignee_address = $consignee_address;
$print_check_info_cols->consignee_branch_code="12321";
$print_check_info_cols->consignee_branch_name="一网点";
$print_check_info_cols->consignee_name="张三";
$print_check_info_cols->consignee_phone="13264528362";
$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\"}";
$print_check_info_cols->logistics_service_list = $logistics_service_list;
$print_check_info_cols->package_center_code="123456";
$print_check_info_cols->package_center_name="浙江杭州";
$print_check_info_cols->print_config="DSFASFDASFDSAFDSAFA";
$print_check_info_cols->product_type="STANDARD_EXPRESS";
$print_check_info_cols->send_name="李四";
$print_check_info_cols->send_phone="12312312311";
$shipping_address = new WaybillAddress;
$shipping_address->address_detail="朝阳路高井，财满街，财经中心9号楼21单元6013";
$shipping_address->area="朝阳区";
$shipping_address->city="北京市";
$shipping_address->division_id="123";
$shipping_address->province="北京";
$shipping_address->town="八里庄";
$print_check_info_cols->shipping_address = $shipping_address;
$print_check_info_cols->shipping_branch_code="2323";
$print_check_info_cols->shipping_branch_name="二网点";
$print_check_info_cols->short_address="余杭";
$print_check_info_cols->real_user_id="123";
$print_check_info_cols->volume="123";
$print_check_info_cols->waybill_code="132121";
$print_check_info_cols->weight="123";
$waybill_apply_print_check_request->print_check_info_cols = $print_check_info_cols;
$req->setWaybillApplyPrintCheckRequest(json_encode($waybill_apply_print_check_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.print' \
-d 'partner_id=apidoc' \
-d 'session=1ada94b9-3f36-4378-a0a6-cbbfd27cc57b' \
-d 'sign=55CFBB19A0BC09CFEAEA249CABB6D690' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+16%3A40%3A47' \
-d 'v=2.0' \
-d 'waybill_apply_print_check_request=null'

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

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

req.waybill_apply_print_check_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.print");
add_param(pRequest,"waybill_apply_print_check_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.print', {
	'waybill_apply_print_check_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<wlb_waybill_i_print_response>
    <waybill_apply_print_check_infos>
        <waybill_apply_print_check_info>
            <notice_code>detail status picked up or signed</notice_code>
            <notice_message>面单已经揽收或揽收，此面单属于重复打印</notice_message>
            <print_quantity>123</print_quantity>
            <waybill_code>123123213</waybill_code>
        </waybill_apply_print_check_info>
    </waybill_apply_print_check_infos>
</wlb_waybill_i_print_response>

{
    "wlb_waybill_i_print_response":{
        "waybill_apply_print_check_infos":{
            "waybill_apply_print_check_info":[
                {
                    "notice_code":"detail status picked up or signed",
                    "notice_message":"面单已经揽收或揽收，此面单属于重复打印",
                    "print_quantity":123,
                    "waybill_code":"123123213"
                }
            ]
        }
    }
}

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

错误码	错误描述	解决方案

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

电子面单API

taobao.wlb.waybill.i.print (打印确认接口v1.0)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ