淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
warehouse_record_query_request	WarehouseRecordQueryRequest	可选			入参
└ biz_activity_type_list String [] 可选 ["SO0"] 业务活动编码 PO0(普通采购),TSF0(调拨),SO4(TOC补发),SO0(TOC销售),ADJ1(盘点调整),TSF5(退仓),RTV0(普通采购退货),RSO0(TOC销售退货) └ gmt_create_start String 必须 2026-6-18 12:00:00 开始时间 └ merchant_code String 必须 majorappliances 租户code sdigit(平台-小电数码),CSSDIGIT(测试平台-小电数码),CSMAJORAPPLIANCES(测试平台-大家电),majorappliances(平台-大家电) └ page_index Number 必须 1 当前页数 └ sc_item_id_list String [] 必须 ["1057269761503"] 货品ID列表 └ gmt_create_end String 必须 2026-6-20 12:00:00 结束时间 └ wh_order_code_list String [] 可选 ["LBX03262724554434141"] 仓内单据号列表

名称	类型	示例值	描述
result	Result		result
└ msg String msg msg data PageModel data └ total Number 6 总数 └ page_index Number 1 当前页 └ page_size Number 200 每页数量 data_source WarehouseRecordDTO [] dataSource └ store_type String 1 仓类型 └ inventory_type Number 1 库存类型 └ operation_detail_order_id String 5120128154287005418 操作子单号 └ sc_item_code String WanJian1781058679652 货品编码 └ sc_item_id String 1057269761503 后端货品ID └ owner_id String 3002085627 供应链货主ID └ gmt_create String 2026-06-23 13:18:04 创建时间 └ wh_order_code String LBX03262724606250827 仓内单据号 └ biz_activity_type String SO0 业务活动类型 └ biz_trade_id String 5120128154287005418 交易单号 └ owner_name String ownerName 货主名称 └ sc_item_name String 万剑测试货品请不要拍货品名称 └ biz_sub_trade_id String 5120128154287005418 交易子单号 └ operation_order_id String 5120128154287005418#5120128154287005418 操作单号 └ change_quantity BigDecimal -1 库存变化数量 └ store_name String [测试]线上自动化测试仓-大件/大电仓名称 └ store_code String STORE_11212615 仓编码 └ result_quantity BigDecimal 11 库存变化后的数量 └ user_id String 3002085627 物流货主ID └ success Boolean true success └ error_code String errorCode errorCode └ error_msg String errorMsg errorMsg

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIndustryWarehouseAccountQueryRequest req = new AlibabaIndustryWarehouseAccountQueryRequest();
AlibabaIndustryWarehouseAccountQueryRequest.WarehouseRecordQueryRequest obj1 = new AlibabaIndustryWarehouseAccountQueryRequest.WarehouseRecordQueryRequest();
obj1.setBizActivityTypeList(""SO0"");
obj1.setGmtCreateStart("2026-6-18 12:00:00");
obj1.setMerchantCode("majorappliances");
obj1.setPageIndex(1L);
obj1.setScItemIdList(""1057269761503"");
obj1.setGmtCreateEnd("2026-6-20 12:00:00");
obj1.setWhOrderCodeList(""LBX03262724554434141"");
req.setWarehouseRecordQueryRequest(obj1);
AlibabaIndustryWarehouseAccountQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIndustryWarehouseAccountQueryRequest req = new AlibabaIndustryWarehouseAccountQueryRequest();
AlibabaIndustryWarehouseAccountQueryRequest.WarehouseRecordQueryRequestDomain obj1 = new AlibabaIndustryWarehouseAccountQueryRequest.WarehouseRecordQueryRequestDomain();
obj1.BizActivityTypeList = ""SO0"";
obj1.GmtCreateStart = "2026-6-18 12:00:00";
obj1.MerchantCode = "majorappliances";
obj1.PageIndex = 1L;
obj1.ScItemIdList = ""1057269761503"";
obj1.GmtCreateEnd = "2026-6-20 12:00:00";
obj1.WhOrderCodeList = ""LBX03262724554434141"";
req.WarehouseRecordQueryRequest_ = obj1;
AlibabaIndustryWarehouseAccountQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIndustryWarehouseAccountQueryRequest;
$warehouse_record_query_request = new WarehouseRecordQueryRequest;
$warehouse_record_query_request->biz_activity_type_list="[\"SO0\"]";
$warehouse_record_query_request->gmt_create_start="2026-6-18 12:00:00";
$warehouse_record_query_request->merchant_code="majorappliances";
$warehouse_record_query_request->page_index="1";
$warehouse_record_query_request->sc_item_id_list="[\"1057269761503\"]";
$warehouse_record_query_request->gmt_create_end="2026-6-20 12:00:00";
$warehouse_record_query_request->wh_order_code_list="[\"LBX03262724554434141\"]";
$req->setWarehouseRecordQueryRequest(json_encode($warehouse_record_query_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=alibaba.industry.warehouse.account.query' \
-d 'partner_id=apidoc' \
-d 'session=a2bce683-9d21-4723-a61b-86c74587dda4' \
-d 'sign=58A98FD16A7025E5801F44CAD9CD1B3E' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-09-09+23%3A22%3A47' \
-d 'v=2.0' \
-d 'warehouse_record_query_request=null'

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

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

req.warehouse_record_query_request="数据结构示例JSON格式"
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,"alibaba.industry.warehouse.account.query");
add_param(pRequest,"warehouse_record_query_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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.industry.warehouse.account.query', {
	'warehouse_record_query_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_industry_warehouse_account_query_response>
    <result>
        <msg>msg</msg>
        <data>
            <total>6</total>
            <page_index>1</page_index>
            <page_size>200</page_size>
            <data_source>
                <warehouse_record_d_t_o>
                    <store_type>1</store_type>
                    <inventory_type>1</inventory_type>
                    <operation_detail_order_id>5120128154287005418</operation_detail_order_id>
                    <sc_item_code>WanJian1781058679652</sc_item_code>
                    <sc_item_id>1057269761503</sc_item_id>
                    <owner_id>3002085627</owner_id>
                    <gmt_create>2026-06-23 13:18:04</gmt_create>
                    <wh_order_code>LBX03262724606250827</wh_order_code>
                    <biz_activity_type>SO0</biz_activity_type>
                    <biz_trade_id>5120128154287005418</biz_trade_id>
                    <owner_name>ownerName</owner_name>
                    <sc_item_name>万剑测试货品请不要拍</sc_item_name>
                    <biz_sub_trade_id>5120128154287005418</biz_sub_trade_id>
                    <operation_order_id>5120128154287005418#5120128154287005418</operation_order_id>
                    <change_quantity>-1</change_quantity>
                    <store_name>[测试]线上自动化测试仓-大件/大电</store_name>
                    <store_code>STORE_11212615</store_code>
                    <result_quantity>11</result_quantity>
                    <user_id>3002085627</user_id>
                </warehouse_record_d_t_o>
            </data_source>
        </data>
        <success>true</success>
        <error_code>errorCode</error_code>
        <error_msg>errorMsg</error_msg>
    </result>
</alibaba_industry_warehouse_account_query_response>

{
    "alibaba_industry_warehouse_account_query_response":{
        "result":{
            "msg":"msg",
            "data":{
                "total":6,
                "page_index":1,
                "page_size":200,
                "data_source":{
                    "warehouse_record_d_t_o":[
                        {
                            "store_type":"1",
                            "inventory_type":1,
                            "operation_detail_order_id":"5120128154287005418",
                            "sc_item_code":"WanJian1781058679652",
                            "sc_item_id":"1057269761503",
                            "owner_id":"3002085627",
                            "gmt_create":"2026-06-23 13:18:04",
                            "wh_order_code":"LBX03262724606250827",
                            "biz_activity_type":"SO0",
                            "biz_trade_id":"5120128154287005418",
                            "owner_name":"ownerName",
                            "sc_item_name":"万剑测试货品请不要拍",
                            "biz_sub_trade_id":"5120128154287005418",
                            "operation_order_id":"5120128154287005418#5120128154287005418",
                            "change_quantity":"-1",
                            "store_name":"[测试]线上自动化测试仓-大件\/大电",
                            "store_code":"STORE_11212615",
                            "result_quantity":"11",
                            "user_id":"3002085627"
                        }
                    ]
                }
            },
            "success":true,
            "error_code":"errorCode",
            "error_msg":"errorMsg"
        }
    }
}

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

alibaba.industry.warehouse.account.query (家享出入库流水接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ