淘宝开放平台

请求地址：

环境	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_mode	String	必须	mainOrder	查询模式；mainOrder：采购单(可传purchaseOrderId、vendorId参数)；distDetailOrder：代发单（可传sellingStatusList、tbOrderId、tbItemId、vendorId、stallId参数）
page_size	Number	必须	20	页面大小
selling_status_list	String	可选	1,2	分销状态列表（1、待采购，2、已采购，3、已发货，4、暂不处理，5、已取消，6、售后中，7、交易完成，8、售后成功，9、售后失败）
current_page	Number	必须	1	页码
purchase_order_id	Number	可选	5404041065	采购单号
vendor_id	Number	可选	7	服务商id
tb_order_id	Number	可选	54041065	淘宝子订单号
tb_item_id	Number	可选	54041065	淘宝商品id
stall_id	Number	可选	723	档口 id

名称	类型	示例值	描述
result	ImPurchaseOrderResponse		结果对象
content_list ImPurchaseOrderVO [] 返回结果 purchase_order_meta ImPurchaseOrderMeta 元信息 └ distribution_order_id String 13332289 代发订单 id └ gmt_create_ts Number 1692063624000 创建时间 └ gmt_modified_ts Number 1692063624000 修改时间 └ item_id Number 733906882956 货品 id └ purchase_order_id Number 4798019626 采购单 id └ purchase_order_usage_type Number 1 使用场景类型 └ selling_status Number 1 销售状态 └ tb_main_order_id String 1951936070174222188 淘宝主订单 id └ tb_order_id String 1851936070174222188 淘宝订单 id └ alipay_order_id String 100 支付宝订单id └ buying_status Number 2 购买状态 └ total_fee BigDecimal 32.01 总金额 └ total_quantity Number 2 总数量 └ vendor_order_id String 3432 服务商订单 id sku_info ImItemSkuInfoVO sku 信息 sku_list ImItemSkuDetailVO [] sku 信息列表 └ id Number 5246165230521 sku id └ quantity Number 1 数量 logistics_info ImLogisticsInfoVO 物流信息 order_list LogisticsOrderVO [] 物流订单列表 └ order_id String YT74353412689123 订单 id └ cp_code String SF 快递公司代码 └ cp_name String 顺丰快递公司名称 sub_order_meta_list ImPurchaseOrderMeta [] 子单元信息 └ distribution_order_id String 8270613 代发订单 id └ gmt_create_ts Number 1679986457000 代发时间 └ gmt_modified_ts Number 1679986457000 修改时间 └ item_id Number 708922760759 货品 id └ parent_id Number 1672059626 主单id └ purchase_order_id Number 922059626 采购单id └ purchase_order_id_str String "922059626" 采购单id └ purchase_order_usage_type Number 1 使用场景类型 └ selling_status Number 6 销售状态 └ tb_order_id String 3281931151330476851 淘宝订单 id sku_info ImItemSkuInfoVO sku 信息 sku_list ImItemSkuDetailVO [] sku 信息 └ id Number 515053627708 sku id └ quantity Number 1 数量 third_item_cards ImThirdItemCard [] 货品信息（采购主单列表使用） └ id Number 718922760759 货品在货源的 id └ pict_url String https://img.com/img.png 封面图 └ stall_id Number 607 档口 id └ title String 测试夏季Polo衫1001-21-1短货品标题 third_stall ImThirdStallVO 档口信息 └ id Number 1278352 档口 id └ name String 1000001-1 名称 └ secret_phone_no String 170347525389 隐私号 └ status Number 2 状态 └ third_market_id Number 45 批发市场 id └ mobile_path_url String https://taobao.com 移动端跳转链接 └ pc_path_url String https://taobao.com pc端跳转链接
call_sub_code	String	501	错误子码
call_success	Boolean	true	api调用是否成功
call_error_code	String	error	错误码
call_error_msg	String	系统错误	错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemmarketPurchaseDistributorQueryRequest req = new ItemmarketPurchaseDistributorQueryRequest();
req.setQueryMode("mainOrder");
req.setPageSize(20L);
req.setSellingStatusList("1,2");
req.setCurrentPage(1L);
req.setPurchaseOrderId(5404041065L);
req.setVendorId(7L);
req.setTbOrderId(54041065L);
req.setTbItemId(54041065L);
req.setStallId(723L);
ItemmarketPurchaseDistributorQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
ItemmarketPurchaseDistributorQueryRequest req = new ItemmarketPurchaseDistributorQueryRequest();
req.QueryMode = "mainOrder";
req.PageSize = 20L;
req.SellingStatusList = "1,2";
req.CurrentPage = 1L;
req.PurchaseOrderId = 5404041065L;
req.VendorId = 7L;
req.TbOrderId = 54041065L;
req.TbItemId = 54041065L;
req.StallId = 723L;
ItemmarketPurchaseDistributorQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new ItemmarketPurchaseDistributorQueryRequest;
$req->setQueryMode("mainOrder");
$req->setPageSize("20");
$req->setSellingStatusList("1,2");
$req->setCurrentPage("1");
$req->setPurchaseOrderId("5404041065");
$req->setVendorId("7");
$req->setTbOrderId("54041065");
$req->setTbItemId("54041065");
$req->setStallId("723");
$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=taobao.itemmarket.purchase.distributor.query' \
-d 'partner_id=apidoc' \
-d 'session=7af786cc-6f25-4036-a4ed-fd405f122a98' \
-d 'sign=1CFFD0432EF23246E7E75DAD50FACB70' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-22+01%3A51%3A23' \
-d 'v=2.0' \
-d 'current_page=1' \
-d 'page_size=20' \
-d 'purchase_order_id=5404041065' \
-d 'query_mode=mainOrder' \
-d 'selling_status_list=1%2C2' \
-d 'stall_id=723' \
-d 'tb_item_id=54041065' \
-d 'tb_order_id=54041065' \
-d 'vendor_id=7'

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

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

req.query_mode="mainOrder"
req.page_size=20
req.selling_status_list="1,2"
req.current_page=1
req.purchase_order_id=5404041065
req.vendor_id=7
req.tb_order_id=54041065
req.tb_item_id=54041065
req.stall_id=723
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,"taobao.itemmarket.purchase.distributor.query");
add_param(pRequest,"query_mode","mainOrder");
add_param(pRequest,"page_size","20");
add_param(pRequest,"selling_status_list","1,2");
add_param(pRequest,"current_page","1");
add_param(pRequest,"purchase_order_id","5404041065");
add_param(pRequest,"vendor_id","7");
add_param(pRequest,"tb_order_id","54041065");
add_param(pRequest,"tb_item_id","54041065");
add_param(pRequest,"stall_id","723");
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('taobao.itemmarket.purchase.distributor.query', {
	'query_mode':'mainOrder',
	'page_size':'20',
	'selling_status_list':'1,2',
	'current_page':'1',
	'purchase_order_id':'5404041065',
	'vendor_id':'7',
	'tb_order_id':'54041065',
	'tb_item_id':'54041065',
	'stall_id':'723'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<itemmarket_purchase_distributor_query_response>
    <result>
        <content_list>
            <im_purchase_order_v_o>
                <purchase_order_meta>
                    <distribution_order_id>13332289</distribution_order_id>
                    <gmt_create_ts>1692063624000</gmt_create_ts>
                    <gmt_modified_ts>1692063624000</gmt_modified_ts>
                    <item_id>733906882956</item_id>
                    <purchase_order_id>4798019626</purchase_order_id>
                    <purchase_order_usage_type>1</purchase_order_usage_type>
                    <selling_status>1</selling_status>
                    <tb_main_order_id>1951936070174222188</tb_main_order_id>
                    <tb_order_id>1851936070174222188</tb_order_id>
                    <alipay_order_id>100</alipay_order_id>
                    <buying_status>2</buying_status>
                    <total_fee>32.01</total_fee>
                    <total_quantity>2</total_quantity>
                    <vendor_order_id>3432</vendor_order_id>
                    <sku_info>
                        <sku_list>
                            <im_item_sku_detail_v_o>
                                <id>5246165230521</id>
                                <quantity>1</quantity>
                            </im_item_sku_detail_v_o>
                        </sku_list>
                    </sku_info>
                    <logistics_info>
                        <order_list>
                            <logistics_order_v_o>
                                <order_id>YT74353412689123</order_id>
                                <cp_code>SF</cp_code>
                                <cp_name>顺丰</cp_name>
                            </logistics_order_v_o>
                        </order_list>
                    </logistics_info>
                </purchase_order_meta>
                <sub_order_meta_list>
                    <im_purchase_order_meta>
                        <distribution_order_id>8270613</distribution_order_id>
                        <gmt_create_ts>1679986457000</gmt_create_ts>
                        <gmt_modified_ts>1679986457000</gmt_modified_ts>
                        <item_id>708922760759</item_id>
                        <parent_id>1672059626</parent_id>
                        <purchase_order_id>922059626</purchase_order_id>
                        <purchase_order_id_str>&quot;922059626&quot;</purchase_order_id_str>
                        <purchase_order_usage_type>1</purchase_order_usage_type>
                        <selling_status>6</selling_status>
                        <tb_order_id>3281931151330476851</tb_order_id>
                        <sku_info>
                            <sku_list>
                                <im_item_sku_detail_v_o>
                                    <id>515053627708</id>
                                    <quantity>1</quantity>
                                </im_item_sku_detail_v_o>
                            </sku_list>
                        </sku_info>
                    </im_purchase_order_meta>
                </sub_order_meta_list>
                <third_item_cards>
                    <im_third_item_card>
                        <id>718922760759</id>
                        <pict_url>https://img.com/img.png</pict_url>
                        <stall_id>607</stall_id>
                        <title>测试夏季Polo衫1001-21-1短</title>
                    </im_third_item_card>
                </third_item_cards>
                <third_stall>
                    <id>1278352</id>
                    <name>1000001-1</name>
                    <secret_phone_no>170347525389</secret_phone_no>
                    <status>2</status>
                    <third_market_id>45</third_market_id>
                </third_stall>
                <mobile_path_url>https://taobao.com</mobile_path_url>
                <pc_path_url>https://taobao.com</pc_path_url>
            </im_purchase_order_v_o>
        </content_list>
    </result>
    <call_sub_code>501</call_sub_code>
    <call_success>true</call_success>
    <call_error_code>error</call_error_code>
    <call_error_msg>系统错误</call_error_msg>
</itemmarket_purchase_distributor_query_response>

{
    "itemmarket_purchase_distributor_query_response":{
        "result":{
            "content_list":{
                "im_purchase_order_v_o":[
                    {
                        "purchase_order_meta":{
                            "distribution_order_id":"13332289",
                            "gmt_create_ts":1692063624000,
                            "gmt_modified_ts":1692063624000,
                            "item_id":733906882956,
                            "purchase_order_id":4798019626,
                            "purchase_order_usage_type":1,
                            "selling_status":1,
                            "tb_main_order_id":"1951936070174222188",
                            "tb_order_id":"1851936070174222188",
                            "alipay_order_id":"100",
                            "buying_status":2,
                            "total_fee":"32.01",
                            "total_quantity":2,
                            "vendor_order_id":"3432",
                            "sku_info":{
                                "sku_list":{
                                    "im_item_sku_detail_v_o":[
                                        {
                                            "id":5246165230521,
                                            "quantity":1
                                        }
                                    ]
                                }
                            },
                            "logistics_info":{
                                "order_list":{
                                    "logistics_order_v_o":[
                                        {
                                            "order_id":"YT74353412689123",
                                            "cp_code":"SF",
                                            "cp_name":"顺丰"
                                        }
                                    ]
                                }
                            }
                        },
                        "sub_order_meta_list":{
                            "im_purchase_order_meta":[
                                {
                                    "distribution_order_id":"8270613",
                                    "gmt_create_ts":1679986457000,
                                    "gmt_modified_ts":1679986457000,
                                    "item_id":708922760759,
                                    "parent_id":1672059626,
                                    "purchase_order_id":922059626,
                                    "purchase_order_id_str":"\"922059626\"",
                                    "purchase_order_usage_type":1,
                                    "selling_status":6,
                                    "tb_order_id":"3281931151330476851",
                                    "sku_info":{
                                        "sku_list":{
                                            "im_item_sku_detail_v_o":[
                                                {
                                                    "id":515053627708,
                                                    "quantity":1
                                                }
                                            ]
                                        }
                                    }
                                }
                            ]
                        },
                        "third_item_cards":{
                            "im_third_item_card":[
                                {
                                    "id":718922760759,
                                    "pict_url":"https:\/\/img.com\/img.png",
                                    "stall_id":607,
                                    "title":"测试夏季Polo衫1001-21-1短"
                                }
                            ]
                        },
                        "third_stall":{
                            "id":1278352,
                            "name":"1000001-1",
                            "secret_phone_no":"170347525389",
                            "status":2,
                            "third_market_id":45
                        },
                        "mobile_path_url":"https:\/\/taobao.com",
                        "pc_path_url":"https:\/\/taobao.com"
                    }
                ]
            }
        },
        "call_sub_code":"501",
        "call_success":true,
        "call_error_code":"error",
        "call_error_msg":"系统错误"
    }
}

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

taobao.itemmarket.purchase.distributor.query (查询采购单)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ