淘宝开放平台

请求地址：

环境	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_order_req	QueryOrderReq	必须			查询参数
└ out_order_id String 必须 EPP20231213104 采购单外部ID └ ex_param String 可选 {"xxx":123} 扩展字段可为空

名称	类型	示例值	描述
result	Result		result
└ code String 200 code data BaseOrderRes 成功的数据 └ out_order_id String EPP20231213104 采购单外部ID tb_order_list TbOrderList [] 采购单订单列表 tb_sub_order_list TbSubOrderList [] 子订单集合 └ sku_title String 容量:1L sku名称 └ item_title String 仕仁测试，请不要拍商品名称 └ tb_sub_order_logistics_status String 1 物流状态 1=未发货 -> 等待卖家发货 2=已发货 -> 等待买家确认收货 3=已收货 -> 交易成功 4=已经退货 -> 交易失败 5=部分收货 -> 交易成功 6=部分发货中 8=还未创建物流订单 └ tb_sub_order_id String 3667030632380297000 tb子订单id └ mail_number String 3667030632380297404 物流单号 └ pic_url String img.alicdn.com/imgextra/i4/263168616/O1CN01inLPEY2DWBOcplKM9_!!0-item_pic.jpg 商品图片 └ epp_item_id String EA086199749310 商品Id └ tb_sub_order_price Number 0 子订单应付单价 └ buy_amount Number 1 数量 └ sku_id String 123123 skuId └ tb_order_id String 3667030632380297000 tb主订单id └ tb_order_status Number 2 订单状态 1=待支付，2=已支付，4=已退款关闭，6=交易成功，8=已关闭 └ tb_order_price Number 0 订单总金额（分） └ tb_order_create_time String 2023-12-08 11:01:57 创建时间 └ tb_logistics_status Number 1 物流状态 1=未发货 -> 等待卖家发货 2=已发货 -> 等待买家确认收货 3=已收货 -> 交易成功 4=已经退货 -> 交易失败 5=部分收货 -> 交易成功 6=部分发货中 8=还未创建物流订单 └ success Boolean true 调用是否成功 └ message String 成功消息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
EppTradeQueryRequest req = new EppTradeQueryRequest();
EppTradeQueryRequest.QueryOrderReq obj1 = new EppTradeQueryRequest.QueryOrderReq();
obj1.setOutOrderId("EPP20231213104");
obj1.setExParam("{\"xxx\":123}");
req.setQueryOrderReq(obj1);
EppTradeQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<epp_trade_query_response>
    <result>
        <code>200</code>
        <data>
            <out_order_id>EPP20231213104</out_order_id>
            <tb_order_list>
                <tb_order_list>
                    <tb_sub_order_list>
                        <tb_sub_order_list>
                            <sku_title>容量:1L</sku_title>
                            <item_title>仕仁测试，请不要拍</item_title>
                            <tb_sub_order_logistics_status>1</tb_sub_order_logistics_status>
                            <tb_sub_order_id>3667030632380297000</tb_sub_order_id>
                            <mail_number>3667030632380297404</mail_number>
                            <pic_url>img.alicdn.com/imgextra/i4/263168616/O1CN01inLPEY2DWBOcplKM9_!!0-item_pic.jpg</pic_url>
                            <epp_item_id>EA086199749310</epp_item_id>
                            <tb_sub_order_price>0</tb_sub_order_price>
                            <buy_amount>1</buy_amount>
                            <sku_id>123123</sku_id>
                        </tb_sub_order_list>
                    </tb_sub_order_list>
                    <tb_order_id>3667030632380297000</tb_order_id>
                    <tb_order_status>2</tb_order_status>
                    <tb_order_price>0</tb_order_price>
                    <tb_order_create_time>2023-12-08 11:01:57</tb_order_create_time>
                    <tb_logistics_status>1</tb_logistics_status>
                </tb_order_list>
            </tb_order_list>
        </data>
        <success>true</success>
        <message>成功</message>
    </result>
</epp_trade_query_response>

{
    "epp_trade_query_response":{
        "result":{
            "code":"200",
            "data":{
                "out_order_id":"EPP20231213104",
                "tb_order_list":{
                    "tb_order_list":[
                        {
                            "tb_sub_order_list":{
                                "tb_sub_order_list":[
                                    {
                                        "sku_title":"容量:1L",
                                        "item_title":"仕仁测试，请不要拍",
                                        "tb_sub_order_logistics_status":"1",
                                        "tb_sub_order_id":"3667030632380297000",
                                        "mail_number":"3667030632380297404",
                                        "pic_url":"img.alicdn.com\/imgextra\/i4\/263168616\/O1CN01inLPEY2DWBOcplKM9_!!0-item_pic.jpg",
                                        "epp_item_id":"EA086199749310",
                                        "tb_sub_order_price":0,
                                        "buy_amount":1,
                                        "sku_id":"123123"
                                    }
                                ]
                            },
                            "tb_order_id":"3667030632380297000",
                            "tb_order_status":2,
                            "tb_order_price":0,
                            "tb_order_create_time":"2023-12-08 11:01:57",
                            "tb_logistics_status":1
                        }
                    ]
                }
            },
            "success":true,
            "message":"成功"
        }
    }
}

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>

错误码	错误描述	解决方案

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

阿里通信API

taobao.epp.trade.query (采购单查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ