文档中心 > API类目 > ICBU－交易

alibaba.seller.order.get (订单查询接口)

国际站订单查询接口

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	描述
e_trade_id	String	必须	xxxxxxxx	订单号
data_select	String	可选	draft_role	数据选择器都参数英文,分隔 statusAction,draft_role,snapshot_product
language	String	可选	en_US或zh_CN	多语言

响应参数

名称	类型	示例值	描述
value	TradeEcologyOrder	order	订单(order info)
buyer BuyerParticipant buyer 买家信息(buyer info) └ country String US 国家(buyer's country name) └ full_name String jack ma 全名(buyer's full name) └ e_account_id String fsfds3124 加密accountId └ immutable_eid String sdfbgfewvdcs 同一买家账号不变的加密id create_date DateVo 2018-10-10 00:00:00 the create date of order └ timestamp Number 123456789 timestamp └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间(平台会按PDT或PST格式化) (Formatted time by PDT or PST ) └ export_service_type String onetouch_service 出口方式(一达通出口onetouch_service,非一达通出口self_run_service), export Service (export by onetouch called onetouch_service, export by not onetouch called self_run_service) inspection_service_amount Price inspection_service_amount 验货费(inspection service amount object) └ amount String 123.00 金额(amount) └ currency String USD 币种(currency) order_products TradeEcologyOrderProduct [] order_products 产品信息(product info List Object) └ name String test 产品名称(the name of product) └ product_image String //fsfffs.jpg 产品图片(the image url of product) └ quantity String 12.0000 产品数量(the quantity of product) sku_attributes SkuAttribute [] sku_attributes sku信息列表(the sku attribute List) └ key String color sku属性名称(attribute key) └ value String red sku属性值(attribute value) └ sku_id String 33 sku编号(the id of sku) └ unit String piece 产品单位(the unit of product) unit_price Price unit_price 产品单价(the unit price of product ) └ amount String 12.0000 产品单价金额(amount) └ currency String USD 币种(currency) └ product_id String 123423 商品id(the Id of product) └ sku_code String T14234 用户自定义skucode(Seller's custom sku code ) └ model_number String RS3434 型号(model number) └ id String dadadadada 唯一主键 product_total_amount Price product_total_amount 产品总价(the total amount of product) └ amount String 12.00 金额(amount) └ currency String USD 币种(currency) └ remark String hello 订单备注(order remark) seller SellerParticipant seller 卖家信息(seller info) └ full_name String test lee 全名(the full name of seller) └ login_id String xxx 登录账号(the login id of seller) └ is_admin Boolean true 是否是主账号 └ email String 12343@test.com 卖家邮箱 └ e_account_id String fsfs312 加密accountId └ immutable_eid String fsdfssdfsfs 同一卖家账号不变的加密id shipment_fee Price shipment_fee 运费(the fee of shipment) └ amount String 1 金额(amount) └ currency String USD 币种(currency) └ shipment_method String air 运输方式 the shipment method( 空运 air, 海运 sea, 快递express, 陆运land, 邮政小包 postal, 空运到港 air_to_port, 空运到门 air_to_door, 海运到港 sea_to_port, 海运到门 sea_to_door) shipping_address Address shipping_address 收货地址(the shipping address ) └ address String xx 具体地址(Detailed address) └ alternate_address String xx 备用地址(Alternate address) └ city String xx 城市(city) └ contact_person String xx 联系人(Contact name) └ country String xx 国家(country) fax Phone fax 传真(the fax ) └ area String xx 区号(area) └ country String xx 国家 (country) └ number String xx 号码(fax number) mobile Phone mobile 移动电话(mobile) └ area String xx 区号(area) └ country String xx 国家(country) └ number String xx 号码(mobile number) └ port String 1233 港口(port) └ province String xx 省份地址(province) telephone Phone telephone 电话(telephone) └ area String xx 区号(area) └ country String xx 国家(country) └ number String 1233 号码(telephone number) └ zip String 3000015 邮编(zip) └ country_code String xxx 国家code └ port_code String xxx 港口code └ province_code String xxx 省份编号 └ city_code String xxx cityCode total_amount Price total 订单总价(the total amount oforder ) └ amount String 2345.00 金额(amount) └ currency String USD 币种(currency) └ trade_id String 12345 订单号(Clear text order number) └ trade_status String trade_success 订单状态： to_be_audited:待审核 unpay:待付预付款(wait buyer to pay), paying:买家支付中,主要是包含验证的过程(buyer has payed but need to verify) paid:买家支付完成(Buyer payment success), relating:关联中(buyer use TT , seller relate the amount), captured:请款完成，到这步就代表资金会到账(The payment is completed, and at this step, the funds will arrive.), undeliver:待卖家发货(Waiting for seller to ship), delivering:发货中(Seller shipping), wait_confirm_receipt:待确认收货(Waiting for the buyer to confirm the receipt), intention_processing:意向订单，待起草订单(Waiting for the seller to draft an order), trade_close:交易关闭，取消(Trading closed), trade_success:交易成功，完成(Order completed), wait_confirm_modify:待确认修改合同(Waiting for the buyer to confirm the modification of the contract), trade_unavailable: 交易不可用(trade unavailable) , charge_back:拒付(charge back), frozen:冻结中(frozen) 1.ERP 如何判断订单能否发货？取 undeliver ，此状态下订单肯定是已经支付成功了的。 2.unpay状态下如果判断订单需要支付预付款还是尾款？通过 pay_step来判断。 3.ERP 如果做订单拦截？需要拦截的情况主要有买家发起退款和信用卡拒付，分别对应 frozen 和 charge_back。退款结束后,订单状态可能会处于 trade_close 和也有可能买家是部分退款,然后订单恢复退款前的状态。信用卡拒付后,订单状态肯定是 trade_close └ contract_version String 12345432 合同版本号 status_action StatusAction {} 实时状态和 action actions Action [] {} 行动点 └ value String http://xxxxxxx 值 └ name String view_payment_link 名字: view_payment_link: 查看支付链接 └ render_name String 查看支付链接渲染后的文案 └ status String trade_success 参考 trade_status 字段注释 shipment_insurance_fee Price {} 物流保险费 └ currency String USD 币种 └ amount String 1100 金额 └ trade_term String FOB 贸易术语 shipment_date ShipmentDate {} 合同约定的发货时间，不是实际的发货时间 └ type String relative 相对预付款relative，相对尾款 relative_balance，绝对时间absolute 如果type=relative 或 relative_balance，则取 duration 的值，它是一个相对值。如果type=absolute，则取 date 的值，他是商家指定的一个具体时间 └ duration Number 2 时间间隔天 date DateVo {} 绝对时间 └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间 └ timestamp Number 213453 时间戳 advance_amount Price {} 预付款 └ currency String USD 币种 └ amount String 2343 金额 balance_amount Price {} 尾款 └ currency String USD 币种 └ amount String 2343 金额 └ fulfillment_channel String TAD 履约通道 └ list_remark String xxx 列表上的备注 carrier Carrier {} 承运商 └ code String FEDEX code 是粗粒度的 └ name String Express FedEx IP(WTD) 名称，不一定能和订单详情匹配 └ pay_step String ADVANCE 支付阶段：预付款ADVANCE，尾款BALANCE，FULL 全款(就预付款等于全款的意思，尾款为0的那种订单) trade_status =unpay ,pay_step=ADVANCE 代表预付款未支付 trade_status =unpay , pay_step=FULL 代表全款未支付 adjust_amount Price {} 调整价 └ currency String USD 币种 └ amount String 10.00 金额 discount_amount Price {} 折扣金额(非负值) └ currency String USD 币种 └ amount String 15.00 币种 └ biz_code String 1020203和1020206，属于RFP类业务身份 └ channel_refer_id String 12345 开放场景来源id └ draft_role String seller 或 buyer 订单起草角色 seller 或 buyer └ item_status String normal / delete normal,//正常使用中 delete; //列表中删除 └ source String 42432 订单来源 └ dropshipping Boolean true true 是，false 不是 └ semi_manage Boolean true true 半托管订单，false费半托管订单

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSellerOrderGetRequest req = new AlibabaSellerOrderGetRequest();
req.setETradeId("xxxxxxxx");
req.setDataSelect("draft_role");
req.setLanguage("en_US或zh_CN");
AlibabaSellerOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaSellerOrderGetRequest req = new AlibabaSellerOrderGetRequest();
req.ETradeId = "xxxxxxxx";
req.DataSelect = "draft_role";
req.Language = "en_US或zh_CN";
AlibabaSellerOrderGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaSellerOrderGetRequest;
$req->setETradeId("xxxxxxxx");
$req->setDataSelect("draft_role");
$req->setLanguage("en_US或zh_CN");
$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.order.get' \
-d 'partner_id=apidoc' \
-d 'session=9c927ade-2f79-4990-b1f1-7f4b964a4acb' \
-d 'sign=829FFB89390E6D227A30BCCCA3CB6362' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-31+16%3A06%3A54' \
-d 'v=2.0' \
-d 'data_select=draft_role' \
-d 'e_trade_id=xxxxxxxx' \
-d 'language=en_US%E6%88%96zh_CN'

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

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

req.e_trade_id="xxxxxxxx"
req.data_select="draft_role"
req.language="en_US或zh_CN"
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.order.get");
add_param(pRequest,"e_trade_id","xxxxxxxx");
add_param(pRequest,"data_select","draft_role");
add_param(pRequest,"language","en_US或zh_CN");
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.order.get', {
	'e_trade_id':'xxxxxxxx',
	'data_select':'draft_role',
	'language':'en_US或zh_CN'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<alibaba_seller_order_get_response>
    <value>
        <buyer>
            <country>US</country>
            <full_name>jack ma</full_name>
            <e_account_id>fsfds3124</e_account_id>
            <immutable_eid>sdfbgfewvdcs</immutable_eid>
        </buyer>
        <create_date>
            <timestamp>123456789</timestamp>
            <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
        </create_date>
        <export_service_type>onetouch_service</export_service_type>
        <inspection_service_amount>
            <amount>123.00</amount>
            <currency>USD</currency>
        </inspection_service_amount>
        <order_products>
            <trade_ecology_order_product>
                <name>test</name>
                <product_image>//fsfffs.jpg</product_image>
                <quantity>12.0000</quantity>
                <sku_attributes>
                    <sku_attribute>
                        <key>color</key>
                        <value>red</value>
                    </sku_attribute>
                </sku_attributes>
                <sku_id>33</sku_id>
                <unit>piece</unit>
                <unit_price>
                    <amount>12.0000</amount>
                    <currency>USD</currency>
                </unit_price>
                <product_id>123423</product_id>
                <sku_code>T14234</sku_code>
                <model_number>RS3434</model_number>
                <id>dadadadada</id>
            </trade_ecology_order_product>
        </order_products>
        <product_total_amount>
            <amount>12.00</amount>
            <currency>USD</currency>
        </product_total_amount>
        <remark>hello</remark>
        <seller>
            <full_name>test lee</full_name>
            <login_id>xxx</login_id>
            <is_admin>true</is_admin>
            <email>12343@test.com</email>
            <e_account_id>fsfs312</e_account_id>
            <immutable_eid>fsdfssdfsfs</immutable_eid>
        </seller>
        <shipment_fee>
            <amount>1</amount>
            <currency>USD</currency>
        </shipment_fee>
        <shipment_method>air</shipment_method>
        <shipping_address>
            <address>xx</address>
            <alternate_address>xx</alternate_address>
            <city>xx</city>
            <contact_person>xx</contact_person>
            <country>xx</country>
            <fax>
                <area>xx</area>
                <country>xx</country>
                <number>xx</number>
            </fax>
            <mobile>
                <area>xx</area>
                <country>xx</country>
                <number>xx</number>
            </mobile>
            <port>1233</port>
            <province>xx</province>
            <telephone>
                <area>xx</area>
                <country>xx</country>
                <number>1233</number>
            </telephone>
            <zip>3000015</zip>
            <country_code>xxx</country_code>
            <port_code>xxx</port_code>
            <province_code>xxx</province_code>
            <city_code>xxx</city_code>
        </shipping_address>
        <total_amount>
            <amount>2345.00</amount>
            <currency>USD</currency>
        </total_amount>
        <trade_id>12345</trade_id>
        <trade_status>trade_success</trade_status>
        <contract_version>12345432</contract_version>
        <status_action>
            <actions>
                <action>
                    <value>http://xxxxxxx</value>
                    <name>view_payment_link</name>
                    <render_name>查看支付链接</render_name>
                </action>
            </actions>
            <status>trade_success</status>
        </status_action>
        <shipment_insurance_fee>
            <currency>USD</currency>
            <amount>1100</amount>
        </shipment_insurance_fee>
        <trade_term>FOB</trade_term>
        <shipment_date>
            <type>relative</type>
            <duration>2</duration>
            <date>
                <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                <timestamp>213453</timestamp>
            </date>
        </shipment_date>
        <advance_amount>
            <currency>USD</currency>
            <amount>2343</amount>
        </advance_amount>
        <balance_amount>
            <currency>USD</currency>
            <amount>2343</amount>
        </balance_amount>
        <fulfillment_channel>TAD</fulfillment_channel>
        <list_remark>xxx</list_remark>
        <carrier>
            <code>FEDEX</code>
            <name>Express FedEx IP(WTD)</name>
        </carrier>
        <pay_step>ADVANCE</pay_step>
        <adjust_amount>
            <currency>USD</currency>
            <amount>10.00</amount>
        </adjust_amount>
        <discount_amount>
            <currency>USD</currency>
            <amount>15.00</amount>
        </discount_amount>
        <biz_code>1020203和1020206，属于RFP类</biz_code>
        <channel_refer_id>12345</channel_refer_id>
        <draft_role>seller 或 buyer</draft_role>
        <item_status>normal / delete</item_status>
        <source>42432</source>
        <dropshipping>true</dropshipping>
        <semi_manage>true</semi_manage>
    </value>
</alibaba_seller_order_get_response>

{
    "alibaba_seller_order_get_response":{
        "value":{
            "buyer":{
                "country":"US",
                "full_name":"jack ma",
                "e_account_id":"fsfds3124",
                "immutable_eid":"sdfbgfewvdcs"
            },
            "create_date":{
                "timestamp":123456789,
                "format_date":"MMM. d, yyyy, HH:mm:ss z."
            },
            "export_service_type":"onetouch_service",
            "inspection_service_amount":{
                "amount":"123.00",
                "currency":"USD"
            },
            "order_products":{
                "trade_ecology_order_product":[
                    {
                        "name":"test",
                        "product_image":"\/\/fsfffs.jpg",
                        "quantity":"12.0000",
                        "sku_attributes":{
                            "sku_attribute":[
                                {
                                    "key":"color",
                                    "value":"red"
                                }
                            ]
                        },
                        "sku_id":"33",
                        "unit":"piece",
                        "unit_price":{
                            "amount":"12.0000",
                            "currency":"USD"
                        },
                        "product_id":"123423",
                        "sku_code":"T14234",
                        "model_number":"RS3434",
                        "id":"dadadadada"
                    }
                ]
            },
            "product_total_amount":{
                "amount":"12.00",
                "currency":"USD"
            },
            "remark":"hello",
            "seller":{
                "full_name":"test lee",
                "login_id":"xxx",
                "is_admin":true,
                "email":"12343@test.com",
                "e_account_id":"fsfs312",
                "immutable_eid":"fsdfssdfsfs"
            },
            "shipment_fee":{
                "amount":"1",
                "currency":"USD"
            },
            "shipment_method":"air",
            "shipping_address":{
                "address":"xx",
                "alternate_address":"xx",
                "city":"xx",
                "contact_person":"xx",
                "country":"xx",
                "fax":{
                    "area":"xx",
                    "country":"xx",
                    "number":"xx"
                },
                "mobile":{
                    "area":"xx",
                    "country":"xx",
                    "number":"xx"
                },
                "port":"1233",
                "province":"xx",
                "telephone":{
                    "area":"xx",
                    "country":"xx",
                    "number":"1233"
                },
                "zip":"3000015",
                "country_code":"xxx",
                "port_code":"xxx",
                "province_code":"xxx",
                "city_code":"xxx"
            },
            "total_amount":{
                "amount":"2345.00",
                "currency":"USD"
            },
            "trade_id":"12345",
            "trade_status":"trade_success",
            "contract_version":"12345432",
            "status_action":{
                "actions":{
                    "action":[
                        {
                            "value":"http:\/\/xxxxxxx",
                            "name":"view_payment_link",
                            "render_name":"查看支付链接"
                        }
                    ]
                },
                "status":"trade_success"
            },
            "shipment_insurance_fee":{
                "currency":"USD",
                "amount":"1100"
            },
            "trade_term":"FOB",
            "shipment_date":{
                "type":"relative",
                "duration":2,
                "date":{
                    "format_date":"MMM. d, yyyy, HH:mm:ss z.",
                    "timestamp":213453
                }
            },
            "advance_amount":{
                "currency":"USD",
                "amount":"2343"
            },
            "balance_amount":{
                "currency":"USD",
                "amount":"2343"
            },
            "fulfillment_channel":"TAD",
            "list_remark":"xxx",
            "carrier":{
                "code":"FEDEX",
                "name":"Express FedEx IP(WTD)"
            },
            "pay_step":"ADVANCE",
            "adjust_amount":{
                "currency":"USD",
                "amount":"10.00"
            },
            "discount_amount":{
                "currency":"USD",
                "amount":"15.00"
            },
            "biz_code":"1020203和1020206，属于RFP类",
            "channel_refer_id":"12345",
            "draft_role":"seller 或 buyer",
            "item_status":"normal \/ delete",
            "source":"42432",
            "dropshipping":true,
            "semi_manage":true
        }
    }
}

异常示例

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工具

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

如何获得此API

FAQ

我要提问

返回
顶部

ICBU－交易

alibaba.seller.order.get (订单查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈