淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
query_type	Number	必须	4		4: 采购单到货通知 5: 移库单通知 6: 退供单通知 7: 销售出库通知 8: 库存盘亏盈通知
bill_no	String	可选	X0001		单据编号
from	Number	必须	1		来源
wms_bill_no	String	可选	WMS0001	最大长度：30	对应wms仓储编号
sys_no	String	可选	50		系统编号

名称	类型	示例值	描述
is_success	Boolean	true	调用返回是否成功
bill_list	OutStockBO []		单据结果
└ bill_no String X00001 单据编号 └ bill_date Date 2015-01-01 00:00:00 单据操作结果时间 └ bill_type Number 4 4: 采购单到货通知 5: 移库单通知6: 退供单通知 8: 库存盘亏盈通知 └ store_id String S00353 对应的淘系门店ID └ reason String demo 单据操作原因 └ wms_bill_no String WMS00001 WMS仓储对应编号 stock_item_list OutStockDetailBO [] 单据明细 └ sku_id String X00001 外部商品编号(在单据类型为移库单或库存盘盈亏时可能重复) └ operate_number String 200.23 实收数量对应库存单位 └ operate_piece String 200.23 实收件数对应采购单位 └ cargo_area String ZP001 外部系统逻辑仓编号 └ in_cargo_area String IN001 外部系统逻辑仓编号 └ out_cargo_area String OUT0002 外部系统逻辑仓编号 └ check_type Number 1 盘盈亏类型 (1：盘盈；-1：盘亏) └ total_price Number 10020 实际支付订单总金额（分为单位） └ discount_price Number 1000 实际优惠金额（分为单位） └ product_date Date 2015-01-01 00:00:00 商品生产日期 areas_number_list OutAreaNumber [] 此属性仅用于销售出库单据类型 └ stock_no String S0001 外部系统逻辑仓编号 └ pick_number String 10.23 出货数量（库存单位） pallet_list PalletBO [] 托盘联运容器数据结构 └ first_pallet_code String demo └ operate_number String demo └ original_supplier_no String demo └ production_date Date 2016-07-13 19:58:28 └ second_pallet_code String demo └ batch_code String 123123 批次编号 └ sources Number 4 订单来源（各种渠道来源）-- 主要用于销售订单 └ channel Number 1 订单渠道（app 或 pos） └ suppliers_no String x000001 供应商编号

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WdkBillGetRequest req = new WdkBillGetRequest();
req.setQueryType(4L);
req.setBillNo("X0001");
req.setFrom(1L);
req.setWmsBillNo("WMS0001");
req.setSysNo("50");
WdkBillGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
WdkBillGetRequest req = new WdkBillGetRequest();
req.QueryType = 4L;
req.BillNo = "X0001";
req.From = 1L;
req.WmsBillNo = "WMS0001";
req.SysNo = "50";
WdkBillGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new WdkBillGetRequest;
$req->setQueryType("4");
$req->setBillNo("X0001");
$req->setFrom("1");
$req->setWmsBillNo("WMS0001");
$req->setSysNo("50");
$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.wdk.bill.get' \
-d 'partner_id=apidoc' \
-d 'session=87d2d044-5ff0-4e06-a34c-7013c78fb79b' \
-d 'sign=05268CBB279EA041413339D18B5D3EAF' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-19+10%3A16%3A29' \
-d 'v=2.0' \
-d 'bill_no=X0001' \
-d 'from=1' \
-d 'query_type=4' \
-d 'sys_no=50' \
-d 'wms_bill_no=WMS0001'

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

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

req.query_type=4
req.bill_no="X0001"
req._from=1
req.wms_bill_no="WMS0001"
req.sys_no="50"
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.wdk.bill.get");
add_param(pRequest,"query_type","4");
add_param(pRequest,"bill_no","X0001");
add_param(pRequest,"from","1");
add_param(pRequest,"wms_bill_no","WMS0001");
add_param(pRequest,"sys_no","50");
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.wdk.bill.get', {
	'query_type':'4',
	'bill_no':'X0001',
	'from':'1',
	'wms_bill_no':'WMS0001',
	'sys_no':'50'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<wdk_bill_get_response>
    <is_success>true</is_success>
    <bill_list>
        <out_stock_b_o>
            <bill_no>X00001</bill_no>
            <bill_date>2015-01-01 00:00:00</bill_date>
            <bill_type>4</bill_type>
            <store_id>S00353</store_id>
            <reason>demo</reason>
            <wms_bill_no>WMS00001</wms_bill_no>
            <stock_item_list>
                <out_stock_detail_b_o>
                    <sku_id>X00001</sku_id>
                    <operate_number>200.23</operate_number>
                    <operate_piece>200.23</operate_piece>
                    <cargo_area>ZP001</cargo_area>
                    <in_cargo_area>IN001</in_cargo_area>
                    <out_cargo_area>OUT0002</out_cargo_area>
                    <check_type>1</check_type>
                    <total_price>10020</total_price>
                    <discount_price>1000</discount_price>
                    <product_date>2015-01-01 00:00:00</product_date>
                    <areas_number_list>
                        <out_area_number>
                            <stock_no>S0001</stock_no>
                            <pick_number>10.23</pick_number>
                        </out_area_number>
                    </areas_number_list>
                    <pallet_list>
                        <pallet_b_o>
                            <first_pallet_code>demo</first_pallet_code>
                            <operate_number>demo</operate_number>
                            <original_supplier_no>demo</original_supplier_no>
                            <production_date>2016-07-13 19:58:28</production_date>
                            <second_pallet_code>demo</second_pallet_code>
                            <batch_code>123123</batch_code>
                        </pallet_b_o>
                    </pallet_list>
                </out_stock_detail_b_o>
            </stock_item_list>
            <sources>4</sources>
            <channel>1</channel>
            <suppliers_no>x000001</suppliers_no>
        </out_stock_b_o>
    </bill_list>
</wdk_bill_get_response>

{
    "wdk_bill_get_response":{
        "is_success":true,
        "bill_list":{
            "out_stock_b_o":[
                {
                    "bill_no":"X00001",
                    "bill_date":"2015-01-01 00:00:00",
                    "bill_type":4,
                    "store_id":"S00353",
                    "reason":"demo",
                    "wms_bill_no":"WMS00001",
                    "stock_item_list":{
                        "out_stock_detail_b_o":[
                            {
                                "sku_id":"X00001",
                                "operate_number":"200.23",
                                "operate_piece":"200.23",
                                "cargo_area":"ZP001",
                                "in_cargo_area":"IN001",
                                "out_cargo_area":"OUT0002",
                                "check_type":1,
                                "total_price":10020,
                                "discount_price":1000,
                                "product_date":"2015-01-01 00:00:00",
                                "areas_number_list":{
                                    "out_area_number":[
                                        {
                                            "stock_no":"S0001",
                                            "pick_number":"10.23"
                                        }
                                    ]
                                },
                                "pallet_list":{
                                    "pallet_b_o":[
                                        {
                                            "first_pallet_code":"demo",
                                            "operate_number":"demo",
                                            "original_supplier_no":"demo",
                                            "production_date":"2016-07-13 19:58:28",
                                            "second_pallet_code":"demo",
                                            "batch_code":"123123"
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "sources":4,
                    "channel":1,
                    "suppliers_no":"x000001"
                }
            ]
        }
    }
}

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

错误码	错误描述	解决方案
isp.001	无效调用来源	from 值为空，请补全
isp.005	无效的单据类型	queryType为空，请检查
isp.300	查询异常	请稍后再试

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

五道口API

taobao.wdk.bill.get (查询商品库存单据信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ