淘宝开放平台

请求地址：

环境	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_trade_dto	QueryTradeDto	可选			查询参数
└ fire_time_start Date 可选 2020-03-09 14:04:34 交易单状态变更起始时间 └ service_code String [] 可选 ISVXX87F3AE 服务code列表 └ off_set Number 可选 23 起始值 └ create_time_end Date 可选 2020-03-09 14:04:34 交易单创建结束时间 └ length Number 可选 30 结束值 └ create_time_start Date 可选 2020-03-09 14:04:34 交易单创建起始时间 └ is_display Boolean 可选 true 是否展示 └ fire_time_end Date 可选 2020-03-09 14:04:34 交易单状态变更结束时间 └ buyer_ali_id Number 可选 123123 买家aliid └ trade_ids Number [] 可选 12 交易id号列表 └ order_nos String [] 可选 W20030940706300 订单号列表 └ status [] 可选 approved 状态列表 └ page Number 可选 1 页码 └ page_size Number 可选 20 每页显示数量

名称	类型	示例值	描述
result	Result	接口返回	接口返回
└ exec_description String 接口返回接口返回 └ return_code Number 0 返回码 └ success Boolean true 是否成功 page_dto PageDto 分页对象分页对象 └ total_item Number 0 总数据量 └ total_page Number 0 总页数 └ page_size Number 10 每页显示数量 └ current_page Number 0 当前页码 dtos Dto [] 返回对象集合 └ order_type String online 订单类型 └ order_no String FW170410000002 订单编号 └ quantity Number 1 购买数量 └ current_status String delivered 订单状态 └ service_code String ISVXX95CF47 服务编码 └ fire_time Date 1583401560000 状态更新时间 └ transaction_price String 1 成交价格 └ create_time Date 1491824798000 创建时间 └ transaction_unit_price String 1 成交单价 └ pay_channel String Martini 支付通道 └ currency String CNY 订单货币类型 └ refund_price String demo 退款金额 └ order_title String 123 订单标题 └ sku_code String ISVXX95CF47 规格编码 └ buyer_ali_id Number 3692130262 购买者阿里id └ buyer_login_id String lxpaliyuntest06 购买者登陆账号 └ service_category_id Number 123 服务分类id └ service_category String 机械电子服务分类名称 └ service_sku_label String {"skuValue":"2","specItemIds":["vas"]} 用户购买sku

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSellerVendorOrderListRequest req = new AlibabaSellerVendorOrderListRequest();
AlibabaSellerVendorOrderListRequest.QueryTradeDto obj1 = new AlibabaSellerVendorOrderListRequest.QueryTradeDto();
obj1.setFireTimeStart(StringUtils.parseDateTime("2020-03-09 14:04:34"));
obj1.setServiceCode("ISVXX87F3AE");
obj1.setOffSet(23L);
obj1.setCreateTimeEnd(StringUtils.parseDateTime("2020-03-09 14:04:34"));
obj1.setLength(30L);
obj1.setCreateTimeStart(StringUtils.parseDateTime("2020-03-09 14:04:34"));
obj1.setIsDisplay(true);
obj1.setFireTimeEnd(StringUtils.parseDateTime("2020-03-09 14:04:34"));
obj1.setBuyerAliId(123123L);
obj1.setTradeIds(new Long[] { 12 };
);
obj1.setOrderNos("W20030940706300");
obj1.setPage(1L);
obj1.setPageSize(20L);
req.setQueryTradeDto(obj1);
AlibabaSellerVendorOrderListResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaSellerVendorOrderListRequest req = new AlibabaSellerVendorOrderListRequest();
AlibabaSellerVendorOrderListRequest.QueryTradeDtoDomain obj1 = new AlibabaSellerVendorOrderListRequest.QueryTradeDtoDomain();
obj1.FireTimeStart = DateTime.Parse(2020-03-09 14:04:34");
obj1.ServiceCode = "ISVXX87F3AE";
obj1.OffSet = 23L;
obj1.CreateTimeEnd = DateTime.Parse(2020-03-09 14:04:34");
obj1.Length = 30L;
obj1.CreateTimeStart = DateTime.Parse(2020-03-09 14:04:34");
obj1.IsDisplay = true;
obj1.FireTimeEnd = DateTime.Parse(2020-03-09 14:04:34");
obj1.BuyerAliId = 123123L;
obj1.TradeIds = new long[] { 12 };
;
obj1.OrderNos = "W20030940706300";
obj1.Page = 1L;
obj1.PageSize = 20L;
req.QueryTradeDto_ = obj1;
AlibabaSellerVendorOrderListResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaSellerVendorOrderListRequest;
$query_trade_dto = new QueryTradeDto;
$query_trade_dto->fire_time_start="2020-03-09 14:04:34";
$query_trade_dto->service_code="ISVXX87F3AE";
$query_trade_dto->off_set="23";
$query_trade_dto->create_time_end="2020-03-09 14:04:34";
$query_trade_dto->length="30";
$query_trade_dto->create_time_start="2020-03-09 14:04:34";
$query_trade_dto->is_display="true";
$query_trade_dto->fire_time_end="2020-03-09 14:04:34";
$query_trade_dto->buyer_ali_id="123123";
$query_trade_dto->trade_ids="12";
$query_trade_dto->order_nos="W20030940706300";
$query_trade_dto->page="1";
$query_trade_dto->page_size="20";
$req->setQueryTradeDto(json_encode($query_trade_dto));
$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.seller.vendor.order.list' \
-d 'partner_id=apidoc' \
-d 'session=d05f05db-2cbb-49cc-be8d-62f60312c3de' \
-d 'sign=0C5E00338B1594FFBAF1ADD6EE980687' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+17%3A18%3A12' \
-d 'v=2.0' \
-d 'query_trade_dto=null'

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

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

req.query_trade_dto=""
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.seller.vendor.order.list");
add_param(pRequest,"query_trade_dto","数据结构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('alibaba.seller.vendor.order.list', {
	'query_trade_dto':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_seller_vendor_order_list_response>
    <result>
        <exec_description>接口返回</exec_description>
        <return_code>0</return_code>
        <success>true</success>
        <page_dto>
            <total_item>0</total_item>
            <total_page>0</total_page>
            <page_size>10</page_size>
            <current_page>0</current_page>
        </page_dto>
        <dtos>
            <dto>
                <order_type>online</order_type>
                <order_no>FW170410000002</order_no>
                <quantity>1</quantity>
                <current_status>delivered</current_status>
                <service_code>ISVXX95CF47</service_code>
                <fire_time>1583401560000</fire_time>
                <transaction_price>1</transaction_price>
                <create_time>1491824798000</create_time>
                <transaction_unit_price>1</transaction_unit_price>
                <pay_channel>Martini</pay_channel>
                <currency>CNY</currency>
                <refund_price>demo</refund_price>
                <order_title>123</order_title>
                <sku_code>ISVXX95CF47</sku_code>
                <buyer_ali_id>3692130262</buyer_ali_id>
                <buyer_login_id>lxpaliyuntest06</buyer_login_id>
                <service_category_id>123</service_category_id>
                <service_category>机械电子</service_category>
                <service_sku_label>{&quot;skuValue&quot;:&quot;2&quot;,&quot;specItemIds&quot;:[&quot;vas&quot;]}</service_sku_label>
            </dto>
        </dtos>
    </result>
</alibaba_seller_vendor_order_list_response>

{
    "alibaba_seller_vendor_order_list_response":{
        "result":{
            "exec_description":"接口返回",
            "return_code":0,
            "success":true,
            "page_dto":{
                "total_item":0,
                "total_page":0,
                "page_size":10,
                "current_page":0
            },
            "dtos":{
                "dto":[
                    {
                        "order_type":"online",
                        "order_no":"FW170410000002",
                        "quantity":1,
                        "current_status":"delivered",
                        "service_code":"ISVXX95CF47",
                        "fire_time":"1583401560000",
                        "transaction_price":"1",
                        "create_time":"1491824798000",
                        "transaction_unit_price":"1",
                        "pay_channel":"Martini",
                        "currency":"CNY",
                        "refund_price":"demo",
                        "order_title":"123",
                        "sku_code":"ISVXX95CF47",
                        "buyer_ali_id":3692130262,
                        "buyer_login_id":"lxpaliyuntest06",
                        "service_category_id":123,
                        "service_category":"机械电子",
                        "service_sku_label":"{\"skuValue\":\"2\",\"specItemIds\":[\"vas\"]}"
                    }
                ]
            }
        }
    }
}

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下载

ICBU卖家API

alibaba.seller.vendor.order.list (国际站服务市场订单列表接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ