淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param0	OrderQuery	可选			param
└ create_date_end String 可选 2017-10-12 12:12:12 create date end time.It's US pacific time └ create_date_start String 可选 2017-10-12 12:12:12 create date start time.It's US pacific time └ modified_date_start String 可选 2017-10-12 12:12:12 modified date start time.It's US pacific time └ order_status_list String [] 可选 SELLER_PART_SEND_GOODS Query order information in multiple order status. For specific order status, see order_status description. └ buyer_login_id String 可选 test buyer login id └ page_size Number 必须 20 Number of pages per page └ modified_date_end String 可选 2017-10-12 12:12:12 modified date end time.It's US pacific time └ current_page Number 必须 1 the current page └ order_status String 可选 SELLER_PART_SEND_GOODS Order status: PLACE_ORDER_SUCCESS: Waiting for buyer to pay; IN_CANCEL: Buyer request cancellation; WAIT_SELLER_SEND_GOODS: Waiting for your shipment; SELLER_PART_SEND_GOODS: Partial delivery; WAIT_BUYER_ACCEPT_GOODS: Waiting for buyer to receive goods; FUND_PROCESSING: Buyers agree, funds processing; IN_ISSUE : Orders in disputes; IN_FROZEN: Orders in freeze; WAIT_SELLER_EXAMINE_MONEY: Waiting for your confirmation amount; RISK_CONTROL: Orders are in 24 hours of risk control, starting 24 hours after the buyer's online payment is completed. The above status query can be separately queried separately, and the order status information is not included in the order status. (FINISH, closed order status) FINISH: The completed order needs to be queried separately.

名称	类型	示例值	描述
result	PaginationResult	1	result
└ error_message String 1 error massage └ total_count Number 1 total count(SC order is not include the result） target_list OrderDto [] 1 target list └ timeout_left_time Number 120340569 The remain time of the current status (negative number indicates the timeout period) └ seller_signer_fullname String cn1234 seller fuller name └ seller_operator_login_id String cn1234 seller operator login id └ seller_login_id String cn1234 seller login id product_list OrderProductDto [] object product list total_product_amount SimpleMoney object total product amount └ currency_code String USD currency code └ amount String 1.01 amount └ son_order_status String PLACE_ORDER_SUCCESS child order status └ sku_code String 12 sku code └ show_status String PLACE_ORDER_SUCCESS order show status └ send_goods_time String 2017-10-12 12:12:12 Last delivery time └ send_goods_operator String WAREHOUSE_SEND_GOODS Shipper type. "SELLER_SEND_GOODS": seller shipping; "WAREHOUSE_SEND_GOODS": warehouse delivery product_unit_price SimpleMoney object product unit price └ currency_code String USD currency code └ amount String 1.01 amount └ product_unit String piece product unit └ product_standard String product standard └ product_snap_url String http://www.aliexpress.com:1080/snapshot/null.html?orderId\u003d1160045860056286 product snap Url └ product_name String mobile product name └ product_img_url String http://g03.a.alicdn.com/kf/images/eng/no_photo.gif product main image url └ product_id Number 2356980 product id └ product_count Number 1 product count └ order_id Number 222222 order ID └ money_back3x Boolean false fake one compensate three flag └ memo String 1 buyer memo └ logistics_type String EMS logistics service name( key) └ logistics_service_name String EMS logistics service show name logistics_amount SimpleMoney object Logistics amount(sub-orders have no shipping costs, please ignore) └ currency_code String USD currency code └ amount String 1.01 amount └ issue_status String END_ISSUE issue status (NO_ISSUE; IN_ISSUE; END_ISSUE) └ issue_mode String w issue mode └ goods_prepare_time Number 3 goods prepare days └ fund_status String WAIT_SELLER_CHECK fund status (NOT_PAY; PAY_SUCCESS; WAIT_SELLER_CHECK) └ freight_commit_day String 27 Limited time └ escrow_fee_rate String 0.01 escrow fee rate └ delivery_time String 5-10 delivery time └ child_id Number 23457890 child order id └ can_submit_issue Boolean false Whether child orders can submit disputes └ buyer_signer_last_name String 1 buyer last name └ buyer_signer_first_name String 1 buyer first name └ afflicate_fee_rate String 0.03 afflicate fee rate └ phone Boolean false Whether mobile phone orders └ payment_type String ebanx101 pay type: migs: Credit card payments go through the RMB channel; migs: 102MasterCard pays and takes the RMB channel; migs101:Visa Pay and take the RMB channel; pp101: PayPal; mb: MoneyBooker channel; tt101: Bank Transfer payment; wu101: West Union payment; wp101: Visa pays for the US dollar channel; wp102: Mastercard to pay for the US dollar channel; qw101: QIWI payment; cybs101: Visa takes the payment of the CYBS channel; cybs102: Mastercard to pay for CYBS channels; wm101: WebMoney payment; ebanx101: Brazilian Beloto payment; pay_amount SimpleMoney object pay amount └ currency_code String USD currency code └ amount String 1.01 amount └ order_status String PLACE_ORDER_SUCCESS order status └ order_id Number 1160045860056286 order ID └ order_detail_url String http order detail url └ logistics_status String NO_LOGISTICS logistics status。logistics status。(WAIT_SELLER_SEND_GOODS: Waiting for seller to ship; SELLER_SEND_PART_GOODS: Partial delivery by seller; SELLER_SEND_GOODS: Seller has shipped; BUYER_ACCEPT_GOODS: Buyer has confirmed receipt; NO_LOGISTICS: No logistics transfer) └ logisitcs_escrow_fee_rate String 1 logistics escrow fee rate loan_amount SimpleMoney object loan amount details └ currency_code String USD currency code └ amount String 1.01 amount └ left_send_good_min String 1 Remaining delivery time (minute) └ left_send_good_hour String 1 Remaining delivery time (hour） └ left_send_good_day String 1 Remaining delivery time (days) └ issue_status String END_ISSUE issue status (NO_ISSUE; IN_ISSUE; END_ISSUE) └ has_request_loan Boolean false Have you requested a loan? └ gmt_update String 2017-10-12 12:12:12 Last order update time └ gmt_send_goods_time String 2017-10-12 12:12:12 Last order delivery time └ gmt_pay_time String 2017-10-12 12:12:12 order pay time (The gmtPaysuccess field has the same meaning in the order details.)it's US Pacific time └ gmt_create String 2017-10-12 12:12:12 order create time,it's US Pacific time └ fund_status String WAIT_SELLER_CHECK fund status (NOT_PAY; PAY_SUCCESS; WAIT_SELLER_CHECK) └ frozen_status String IN_FROZEN frozen status。(NO_FROZEN:no frozen; IN_FROZEN:in frozen) └ escrow_fee_rate Number 1 escrow fee rate escrow_fee SimpleMoney 1 escrow fee └ currency_code String USD currency code └ amount String 1.01 amount └ end_reason String buyer_confirm_goods order finished reason └ buyer_signer_fullname String test buyer full name └ buyer_login_id String test buyer login id └ biz_type String AE_RECHARGE order type。（AE_COMMON:common type,AE_TRIAL:trial type;AE_RECHARGE:recharge order) └ offline_pickup_type String RU_OFFLINE_SELF_PICK_UP_EXPRESSION pickup type of order └ page_size Number 1 the number of each page └ error_code String 1 error code └ current_page Number 1 current page └ total_page Number 1 total page └ success Boolean true success or not └ time_stamp Date 1 timeStamp

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressSolutionOrderGetRequest req = new AliexpressSolutionOrderGetRequest();
AliexpressSolutionOrderGetRequest.OrderQuery obj1 = new AliexpressSolutionOrderGetRequest.OrderQuery();
obj1.setCreateDateEnd("2017-10-12 12:12:12");
obj1.setCreateDateStart("2017-10-12 12:12:12");
obj1.setModifiedDateStart("2017-10-12 12:12:12");
obj1.setOrderStatusList("SELLER_PART_SEND_GOODS");
obj1.setBuyerLoginId("test");
obj1.setPageSize(20L);
obj1.setModifiedDateEnd("2017-10-12 12:12:12");
obj1.setCurrentPage(1L);
obj1.setOrderStatus("SELLER_PART_SEND_GOODS");
req.setParam0(obj1);
AliexpressSolutionOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressSolutionOrderGetRequest req = new AliexpressSolutionOrderGetRequest();
AliexpressSolutionOrderGetRequest.OrderQueryDomain obj1 = new AliexpressSolutionOrderGetRequest.OrderQueryDomain();
obj1.CreateDateEnd = "2017-10-12 12:12:12";
obj1.CreateDateStart = "2017-10-12 12:12:12";
obj1.ModifiedDateStart = "2017-10-12 12:12:12";
obj1.OrderStatusList = "SELLER_PART_SEND_GOODS";
obj1.BuyerLoginId = "test";
obj1.PageSize = 20L;
obj1.ModifiedDateEnd = "2017-10-12 12:12:12";
obj1.CurrentPage = 1L;
obj1.OrderStatus = "SELLER_PART_SEND_GOODS";
req.Param0_ = obj1;
AliexpressSolutionOrderGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressSolutionOrderGetRequest;
$param0 = new OrderQuery;
$param0->create_date_end="2017-10-12 12:12:12";
$param0->create_date_start="2017-10-12 12:12:12";
$param0->modified_date_start="2017-10-12 12:12:12";
$param0->order_status_list="SELLER_PART_SEND_GOODS";
$param0->buyer_login_id="test";
$param0->page_size="20";
$param0->modified_date_end="2017-10-12 12:12:12";
$param0->current_page="1";
$param0->order_status="SELLER_PART_SEND_GOODS";
$req->setParam0(json_encode($param0));
$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=aliexpress.solution.order.get' \
-d 'partner_id=apidoc' \
-d 'session=36122583-335e-4dc7-a814-ffdd384a34ff' \
-d 'sign=D35BF2E7057A531190758C93B397651D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-31+11%3A03%3A09' \
-d 'v=2.0' \
-d 'param0=null'

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

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

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

XML示例
JSON示例

<aliexpress_solution_order_get_response>
    <result>
        <error_message>1</error_message>
        <total_count>1</total_count>
        <target_list>
            <order_dto>
                <timeout_left_time>120340569</timeout_left_time>
                <seller_signer_fullname>cn1234</seller_signer_fullname>
                <seller_operator_login_id>cn1234</seller_operator_login_id>
                <seller_login_id>cn1234</seller_login_id>
                <product_list>
                    <order_product_dto>
                        <total_product_amount>
                            <currency_code>USD</currency_code>
                            <amount>1.01</amount>
                        </total_product_amount>
                        <son_order_status>PLACE_ORDER_SUCCESS</son_order_status>
                        <sku_code>12</sku_code>
                        <show_status>PLACE_ORDER_SUCCESS</show_status>
                        <send_goods_time>2017-10-12 12:12:12</send_goods_time>
                        <send_goods_operator>WAREHOUSE_SEND_GOODS</send_goods_operator>
                        <product_unit_price>
                            <currency_code>USD</currency_code>
                            <amount>1.01</amount>
                        </product_unit_price>
                        <product_unit>piece</product_unit>
                        <product_standard></product_standard>
                        <product_snap_url>http://www.aliexpress.com:1080/snapshot/null.html?orderId\u003d1160045860056286</product_snap_url>
                        <product_name>mobile</product_name>
                        <product_img_url>http://g03.a.alicdn.com/kf/images/eng/no_photo.gif</product_img_url>
                        <product_id>2356980</product_id>
                        <product_count>1</product_count>
                        <order_id>222222</order_id>
                        <money_back3x>false</money_back3x>
                        <memo>1</memo>
                        <logistics_type>EMS</logistics_type>
                        <logistics_service_name>EMS</logistics_service_name>
                        <logistics_amount>
                            <currency_code>USD</currency_code>
                            <amount>1.01</amount>
                        </logistics_amount>
                        <issue_status>END_ISSUE</issue_status>
                        <issue_mode>w</issue_mode>
                        <goods_prepare_time>3</goods_prepare_time>
                        <fund_status>WAIT_SELLER_CHECK</fund_status>
                        <freight_commit_day>27</freight_commit_day>
                        <escrow_fee_rate>0.01</escrow_fee_rate>
                        <delivery_time>5-10</delivery_time>
                        <child_id>23457890</child_id>
                        <can_submit_issue>false</can_submit_issue>
                        <buyer_signer_last_name>1</buyer_signer_last_name>
                        <buyer_signer_first_name>1</buyer_signer_first_name>
                        <afflicate_fee_rate>0.03</afflicate_fee_rate>
                    </order_product_dto>
                </product_list>
                <phone>false</phone>
                <payment_type>ebanx101</payment_type>
                <pay_amount>
                    <currency_code>USD</currency_code>
                    <amount>1.01</amount>
                </pay_amount>
                <order_status>PLACE_ORDER_SUCCESS</order_status>
                <order_id>1160045860056286</order_id>
                <order_detail_url>http</order_detail_url>
                <logistics_status>NO_LOGISTICS</logistics_status>
                <logisitcs_escrow_fee_rate>1</logisitcs_escrow_fee_rate>
                <loan_amount>
                    <currency_code>USD</currency_code>
                    <amount>1.01</amount>
                </loan_amount>
                <left_send_good_min>1</left_send_good_min>
                <left_send_good_hour>1</left_send_good_hour>
                <left_send_good_day>1</left_send_good_day>
                <issue_status>END_ISSUE</issue_status>
                <has_request_loan>false</has_request_loan>
                <gmt_update>2017-10-12 12:12:12</gmt_update>
                <gmt_send_goods_time>2017-10-12 12:12:12</gmt_send_goods_time>
                <gmt_pay_time>2017-10-12 12:12:12</gmt_pay_time>
                <gmt_create>2017-10-12 12:12:12</gmt_create>
                <fund_status>WAIT_SELLER_CHECK</fund_status>
                <frozen_status>IN_FROZEN</frozen_status>
                <escrow_fee_rate>1</escrow_fee_rate>
                <escrow_fee>
                    <currency_code>USD</currency_code>
                    <amount>1.01</amount>
                </escrow_fee>
                <end_reason>buyer_confirm_goods</end_reason>
                <buyer_signer_fullname>test</buyer_signer_fullname>
                <buyer_login_id>test</buyer_login_id>
                <biz_type>AE_RECHARGE</biz_type>
                <offline_pickup_type>RU_OFFLINE_SELF_PICK_UP_EXPRESSION</offline_pickup_type>
            </order_dto>
        </target_list>
        <page_size>1</page_size>
        <error_code>1</error_code>
        <current_page>1</current_page>
        <total_page>1</total_page>
        <success>true</success>
        <time_stamp>1</time_stamp>
    </result>
</aliexpress_solution_order_get_response>

{
    "aliexpress_solution_order_get_response":{
        "result":{
            "error_message":"1",
            "total_count":1,
            "target_list":{
                "order_dto":[
                    {
                        "timeout_left_time":120340569,
                        "seller_signer_fullname":"cn1234",
                        "seller_operator_login_id":"cn1234",
                        "seller_login_id":"cn1234",
                        "product_list":{
                            "order_product_dto":[
                                {
                                    "total_product_amount":{
                                        "currency_code":"USD",
                                        "amount":"1.01"
                                    },
                                    "son_order_status":"PLACE_ORDER_SUCCESS",
                                    "sku_code":"12",
                                    "show_status":"PLACE_ORDER_SUCCESS",
                                    "send_goods_time":"2017-10-12 12:12:12",
                                    "send_goods_operator":"WAREHOUSE_SEND_GOODS",
                                    "product_unit_price":{
                                        "currency_code":"USD",
                                        "amount":"1.01"
                                    },
                                    "product_unit":"piece",
                                    "product_standard":"",
                                    "product_snap_url":"http:\/\/www.aliexpress.com:1080\/snapshot\/null.html?orderId\\u003d1160045860056286",
                                    "product_name":"mobile",
                                    "product_img_url":"http:\/\/g03.a.alicdn.com\/kf\/images\/eng\/no_photo.gif",
                                    "product_id":2356980,
                                    "product_count":1,
                                    "order_id":222222,
                                    "money_back3x":false,
                                    "memo":"1",
                                    "logistics_type":"EMS",
                                    "logistics_service_name":"EMS",
                                    "logistics_amount":{
                                        "currency_code":"USD",
                                        "amount":"1.01"
                                    },
                                    "issue_status":"END_ISSUE",
                                    "issue_mode":"w",
                                    "goods_prepare_time":3,
                                    "fund_status":"WAIT_SELLER_CHECK",
                                    "freight_commit_day":"27",
                                    "escrow_fee_rate":"0.01",
                                    "delivery_time":"5-10",
                                    "child_id":23457890,
                                    "can_submit_issue":false,
                                    "buyer_signer_last_name":"1",
                                    "buyer_signer_first_name":"1",
                                    "afflicate_fee_rate":"0.03"
                                }
                            ]
                        },
                        "phone":false,
                        "payment_type":"ebanx101",
                        "pay_amount":{
                            "currency_code":"USD",
                            "amount":"1.01"
                        },
                        "order_status":"PLACE_ORDER_SUCCESS",
                        "order_id":1160045860056286,
                        "order_detail_url":"http",
                        "logistics_status":"NO_LOGISTICS",
                        "logisitcs_escrow_fee_rate":"1",
                        "loan_amount":{
                            "currency_code":"USD",
                            "amount":"1.01"
                        },
                        "left_send_good_min":"1",
                        "left_send_good_hour":"1",
                        "left_send_good_day":"1",
                        "issue_status":"END_ISSUE",
                        "has_request_loan":false,
                        "gmt_update":"2017-10-12 12:12:12",
                        "gmt_send_goods_time":"2017-10-12 12:12:12",
                        "gmt_pay_time":"2017-10-12 12:12:12",
                        "gmt_create":"2017-10-12 12:12:12",
                        "fund_status":"WAIT_SELLER_CHECK",
                        "frozen_status":"IN_FROZEN",
                        "escrow_fee_rate":1,
                        "escrow_fee":{
                            "currency_code":"USD",
                            "amount":"1.01"
                        },
                        "end_reason":"buyer_confirm_goods",
                        "buyer_signer_fullname":"test",
                        "buyer_login_id":"test",
                        "biz_type":"AE_RECHARGE",
                        "offline_pickup_type":"RU_OFFLINE_SELF_PICK_UP_EXPRESSION"
                    }
                ]
            },
            "page_size":1,
            "error_code":"1",
            "current_page":1,
            "total_page":1,
            "success":true,
            "time_stamp":"1"
        }
    }
}

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

开放平台

Developing documentation（已废弃）

aliexpress.solution.order.get (get order list)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ