淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
biz_order_id	Number	必须	12354		orderId

名称	类型	示例值	描述
result	Result		result
└ err_code String 0 errCode └ err_msg String 当前订单不归属appkey errMsg module AppraiseOrderInfoDto 订单信息 └ ac2buyer_mail_no String 0468705725 鉴定商发货给买家的单号主状态>=7，验货中心已发货时填写 └ ac2seller_mail_no String 675366256789 逆向流程鉴定商发货给卖家的单号逆向流程中，主状态>=103卖家已发货后发起逆向时填写 └ app_key String 23455243 服务商appkey └ appraise_from_new_publisher Boolean true 是否是经主发发布/编辑的验货宝商品 └ biz_order_id String 347876534 订单号 └ brand_id String 0 品牌Id └ buyer_address String 浙江省杭州市滨江XX小区买家收货地址。主状态>=6，买家确认购买时填写 └ buyer_alipay_user_id String 1635724563 买家支付宝ID，用于卖家责任时赔付买家逆向流程中，主状态105鉴定为赝品时填写 └ buyer_area String 滨江区买家区 └ buyer_city String 杭州市买家城市 └ buyer_close_reason String 联系不到用户买家关闭原因 └ buyer_country String 长河街道买家村庄 └ buyer_phone String 13512345678 买家手机号。主状态>=6，买家确认购买时有值 └ buyer_province String 浙江省买家省份 └ buyer_receipt_name String sam 买家收货姓名。主状态>=6，买家确认购买时有值 └ cate_agg_scene String YHB_3C 类目聚合场景,如"YHB_3C" └ channel String idle 渠道 └ channel_data String {} 预留 JSON 格式渠道业务数据 └ compensation2buyer Number 4400 需付给买家的赔付金额，单位分。状态为：已付款后发货超时（101-1 101-2）、卖家取消订单（101-3 101-4）、鉴定为赝品（主状态105）时有值。 └ env String online 订单环境 'online'：线上环境；'pre'：测试环境 └ gmt_create String 2020-04-01 17:39:35 订单创建时间 └ idle_appraise_checkpoints String [{\"keyId\":\"1001\",\"valueId\":\"1\",\"valueName\":\"64G\"},{\"keyId\":\"1002\",\"valueId\":\"2\",\"valueName\":\"蓝色\"},{\"keyId\":\"9999\",\"valueId\":\"5\",\"valueName\":\"含包装\"},{\"keyId\":\"9999\",\"valueId\":\"6\",\"valueName\":\"含发票\"}] 二手卖家承诺验货项。数组，每条记录的keyId代表验货项id，比如1001可能代表内存。valueId和valueName分别代表验货项值的id和描述。keyId、valueId的取值参考对接文档 └ idle_appraise_scene String 2 鉴定场景：1表示新品鉴定，2表示旧品鉴定 └ item_detail_info String https://www.taobao.com/ 商品详情页 └ order_status String 2 订单主状态。(主状态,子状态,状态说明)示例如下： ("1", "1", "买家拍下未付款") ("2", "1", "买家拍下已付款") ("3", "1", "卖家已发货") 等。详情参考对接文档 └ order_sub_status String 4 订单子状态，说明见order_status └ seller2ac_mail_no String 3145789024522 卖家发货给验货中心的单号。主状态>=3，卖家已发货时有值 └ seller_area String 滨江区卖家区 └ seller_city String 杭州市卖家城市 └ seller_close_reason String 突然不想卖了卖家关闭原因 └ seller_country String 长河街道卖家村庄 └ seller_phone String 12334321343 卖家手机号码。逆向流程中，主状态>=102卖家已发货后发起逆向时有值 └ seller_province String 浙江省卖家省份 └ seller_receipt_address String 浙江省杭州市滨江XX小区逆向流程卖家收货地址。逆向流程中，主状态>=102卖家已发货后发起逆向时有值 └ seller_receipt_name String jack 卖家收货姓名，逆向退货用。逆向流程中，主状态>=102卖家已发货后发起逆向时有值 └ spu_id String 0 spuId └ spu_info String "{\"id\": \"主键\",\"name\": \"标品名称\",\"aliasName\": \"别名\",\"itemNbr\": \"货号\",\"categoryId\": \"类目ID\",\"categoryName\": \"类目名称\",\"industryId\": \"行业\",\"industryName\": \"行业名称\",\"colorName\": \"配色名称\",\"brandId\": \"品牌ID\",\"brandName\": \"品牌名称\",\"seriesId\": \"系列（类别）ID\",\"seriesName\": \"系列（类别）名称\",\"description\": \"文字描叙\",\"property\": \"标品属性，本身相关一般信息，如颜色，尺码，吊牌价，上市时间，发货地等；\",\"feature\": \"标品特征：关联的外在属性，比如物流方式，特征属性，退换货服务\",\"subSeriesId\": \"款式ID(子系列ID)\",\"subSeriesName\": \"款式名称(子系列名称)\",\"cateSecondId\": \"二级类目ID\",\"cateSecondName\": \"二级类目名称\"}" spu信息jsonStr └ supplier_charge_fee_cent Number 35 服务商应收实时分账金额，分。仅当交易成功或者卖家无责买家不买这两个状态有效，其余为0。当保证金被罚没的状态时，不会实时分账而是线下结算，所以只有上述两个状态有值。 └ actual_paid_fee_cent Number 150000 买家实付金额，单位：分 └ buyer_confirm_receipt_timeout String 买家自动确认收货时间 2022-10-01 00:00:00 └ seller_confirm_back_address_time String 卖家确认退回地址时间（包含主动确认和超时自动确认） 2022-10-01 00:00:00 └ yhb_version String V3 验货宝订单流程版本 └ buyer_inspection_fee Number 3900 确定买家验货费金额，单位：分 └ seller_inspection_fee Number 0 确定买家验货费金额，单位：分 └ buyer_inspection_zfb_id String 1232112234455521145677 买家验货费支付宝流水单号（仅在买家需要承担时有效） └ buyer_inspection_order_id String 1233123344445 买家验货费支付单号 └ seller_inspection_zfb_id String 1232112234455521145677 卖家验货费支付宝流水单号（仅在卖家需要承担时有效） └ seller_inspection_order_id String 12341232321112 卖家验货费支付单号 └ dispute_conclusion String SELLER_PAY 纠纷单判责结论，只在产生纠纷单并在判责结论出具后有效 └ seller_alipay_pid String 2088111111111111 卖家支付宝 pid └ ac_storage_id String HSB-1 仓库 id └ inspection_coupon_fee String 100 有值代表使用了验货费券，表示金额 └ trade_success_seller_assume Boolean true true 表示交易成功卖家包验货费模式 └ supplier_receive_fee Number 2990 本订单服务商应收服务费金额 └ buyer_real_inspection_fee Number 995 本订单买方实际支出服务费 └ seller_real_inspection_fee Number 1995 本订单卖方实际支出服务费 └ success Boolean true 是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleAppraiseOrderQueryRequest req = new AlibabaIdleAppraiseOrderQueryRequest();
req.setBizOrderId(12354L);
AlibabaIdleAppraiseOrderQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIdleAppraiseOrderQueryRequest req = new AlibabaIdleAppraiseOrderQueryRequest();
req.BizOrderId = 12354L;
AlibabaIdleAppraiseOrderQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIdleAppraiseOrderQueryRequest;
$req->setBizOrderId("12354");
$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.idle.appraise.order.query' \
-d 'partner_id=apidoc' \
-d 'session=2e01f7a8-ad98-4cf1-a1d1-7d1e80d1ce22' \
-d 'sign=B9E6256495CDA58CC90712A14946B0C0' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+11%3A15%3A59' \
-d 'v=2.0' \
-d 'biz_order_id=12354'

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

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

req.biz_order_id=12354
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.idle.appraise.order.query");
add_param(pRequest,"biz_order_id","12354");
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.idle.appraise.order.query', {
	'biz_order_id':'12354'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_idle_appraise_order_query_response>
    <result>
        <err_code>0</err_code>
        <err_msg>当前订单不归属appkey</err_msg>
        <module>
            <ac2buyer_mail_no>0468705725</ac2buyer_mail_no>
            <ac2seller_mail_no>675366256789</ac2seller_mail_no>
            <app_key>23455243</app_key>
            <appraise_from_new_publisher>true</appraise_from_new_publisher>
            <biz_order_id>347876534</biz_order_id>
            <brand_id>0</brand_id>
            <buyer_address>浙江省杭州市滨江XX小区</buyer_address>
            <buyer_alipay_user_id>1635724563</buyer_alipay_user_id>
            <buyer_area>滨江区</buyer_area>
            <buyer_city>杭州市</buyer_city>
            <buyer_close_reason>联系不到用户</buyer_close_reason>
            <buyer_country>长河街道</buyer_country>
            <buyer_phone>13512345678</buyer_phone>
            <buyer_province>浙江省</buyer_province>
            <buyer_receipt_name>sam</buyer_receipt_name>
            <cate_agg_scene>YHB_3C</cate_agg_scene>
            <channel>idle</channel>
            <channel_data>{}</channel_data>
            <compensation2buyer>4400</compensation2buyer>
            <env>online</env>
            <gmt_create>2020-04-01 17:39:35</gmt_create>
            <idle_appraise_checkpoints>[{\&quot;keyId\&quot;:\&quot;1001\&quot;,\&quot;valueId\&quot;:\&quot;1\&quot;,\&quot;valueName\&quot;:\&quot;64G\&quot;},{\&quot;keyId\&quot;:\&quot;1002\&quot;,\&quot;valueId\&quot;:\&quot;2\&quot;,\&quot;valueName\&quot;:\&quot;蓝色\&quot;},{\&quot;keyId\&quot;:\&quot;9999\&quot;,\&quot;valueId\&quot;:\&quot;5\&quot;,\&quot;valueName\&quot;:\&quot;含包装\&quot;},{\&quot;keyId\&quot;:\&quot;9999\&quot;,\&quot;valueId\&quot;:\&quot;6\&quot;,\&quot;valueName\&quot;:\&quot;含发票\&quot;}]</idle_appraise_checkpoints>
            <idle_appraise_scene>2</idle_appraise_scene>
            <item_detail_info>https://www.taobao.com/</item_detail_info>
            <order_status>2</order_status>
            <order_sub_status>4</order_sub_status>
            <seller2ac_mail_no>3145789024522</seller2ac_mail_no>
            <seller_area>滨江区</seller_area>
            <seller_city>杭州市</seller_city>
            <seller_close_reason>突然不想卖了</seller_close_reason>
            <seller_country>长河街道</seller_country>
            <seller_phone>12334321343</seller_phone>
            <seller_province>浙江省</seller_province>
            <seller_receipt_address>浙江省杭州市滨江XX小区</seller_receipt_address>
            <seller_receipt_name>jack</seller_receipt_name>
            <spu_id>0</spu_id>
            <spu_info>&quot;{\&quot;id\&quot;: \&quot;主键\&quot;,\&quot;name\&quot;: \&quot;标品名称\&quot;,\&quot;aliasName\&quot;: \&quot;别名\&quot;,\&quot;itemNbr\&quot;: \&quot;货号\&quot;,\&quot;categoryId\&quot;: \&quot;类目ID\&quot;,\&quot;categoryName\&quot;: \&quot;类目名称\&quot;,\&quot;industryId\&quot;: \&quot;行业\&quot;,\&quot;industryName\&quot;: \&quot;行业名称\&quot;,\&quot;colorName\&quot;: \&quot;配色名称\&quot;,\&quot;brandId\&quot;: \&quot;品牌ID\&quot;,\&quot;brandName\&quot;: \&quot;品牌名称\&quot;,\&quot;seriesId\&quot;: \&quot;系列（类别）ID\&quot;,\&quot;seriesName\&quot;: \&quot;系列（类别）名称\&quot;,\&quot;description\&quot;: \&quot;文字描叙\&quot;,\&quot;property\&quot;: \&quot;标品属性，本身相关一般信息，如颜色，尺码，吊牌价，上市时间，发货地等；\&quot;,\&quot;feature\&quot;: \&quot;标品特征：关联的外在属性，比如物流方式，特征属性，退换货服务\&quot;,\&quot;subSeriesId\&quot;: \&quot;款式ID(子系列ID)\&quot;,\&quot;subSeriesName\&quot;: \&quot;款式名称(子系列名称)\&quot;,\&quot;cateSecondId\&quot;: \&quot;二级类目ID\&quot;,\&quot;cateSecondName\&quot;: \&quot;二级类目名称\&quot;}&quot;</spu_info>
            <supplier_charge_fee_cent>35</supplier_charge_fee_cent>
            <actual_paid_fee_cent>150000</actual_paid_fee_cent>
            <buyer_confirm_receipt_timeout>买家自动确认收货时间</buyer_confirm_receipt_timeout>
            <seller_confirm_back_address_time>卖家确认退回地址时间（包含主动确认和超时自动确认）</seller_confirm_back_address_time>
            <yhb_version>V3</yhb_version>
            <buyer_inspection_fee>3900</buyer_inspection_fee>
            <seller_inspection_fee>0</seller_inspection_fee>
            <buyer_inspection_zfb_id>1232112234455521145677</buyer_inspection_zfb_id>
            <buyer_inspection_order_id>1233123344445</buyer_inspection_order_id>
            <seller_inspection_zfb_id>1232112234455521145677</seller_inspection_zfb_id>
            <seller_inspection_order_id>12341232321112</seller_inspection_order_id>
            <dispute_conclusion>SELLER_PAY</dispute_conclusion>
            <seller_alipay_pid>2088111111111111</seller_alipay_pid>
            <ac_storage_id>HSB-1</ac_storage_id>
            <inspection_coupon_fee>100</inspection_coupon_fee>
            <trade_success_seller_assume>true</trade_success_seller_assume>
            <supplier_receive_fee>2990</supplier_receive_fee>
            <buyer_real_inspection_fee>995</buyer_real_inspection_fee>
            <seller_real_inspection_fee>1995</seller_real_inspection_fee>
        </module>
        <success>true</success>
    </result>
</alibaba_idle_appraise_order_query_response>

{
    "alibaba_idle_appraise_order_query_response":{
        "result":{
            "err_code":"0",
            "err_msg":"当前订单不归属appkey",
            "module":{
                "ac2buyer_mail_no":"0468705725",
                "ac2seller_mail_no":"675366256789",
                "app_key":"23455243",
                "appraise_from_new_publisher":true,
                "biz_order_id":"347876534",
                "brand_id":"0",
                "buyer_address":"浙江省杭州市滨江XX小区",
                "buyer_alipay_user_id":"1635724563",
                "buyer_area":"滨江区",
                "buyer_city":"杭州市",
                "buyer_close_reason":"联系不到用户",
                "buyer_country":"长河街道",
                "buyer_phone":"13512345678",
                "buyer_province":"浙江省",
                "buyer_receipt_name":"sam",
                "cate_agg_scene":"YHB_3C",
                "channel":"idle",
                "channel_data":"{}",
                "compensation2buyer":4400,
                "env":"online",
                "gmt_create":"2020-04-01 17:39:35",
                "idle_appraise_checkpoints":"[{\\\"keyId\\\":\\\"1001\\\",\\\"valueId\\\":\\\"1\\\",\\\"valueName\\\":\\\"64G\\\"},{\\\"keyId\\\":\\\"1002\\\",\\\"valueId\\\":\\\"2\\\",\\\"valueName\\\":\\\"蓝色\\\"},{\\\"keyId\\\":\\\"9999\\\",\\\"valueId\\\":\\\"5\\\",\\\"valueName\\\":\\\"含包装\\\"},{\\\"keyId\\\":\\\"9999\\\",\\\"valueId\\\":\\\"6\\\",\\\"valueName\\\":\\\"含发票\\\"}]",
                "idle_appraise_scene":"2",
                "item_detail_info":"https:\/\/www.taobao.com\/",
                "order_status":"2",
                "order_sub_status":"4",
                "seller2ac_mail_no":"3145789024522",
                "seller_area":"滨江区",
                "seller_city":"杭州市",
                "seller_close_reason":"突然不想卖了",
                "seller_country":"长河街道",
                "seller_phone":"12334321343",
                "seller_province":"浙江省",
                "seller_receipt_address":"浙江省杭州市滨江XX小区",
                "seller_receipt_name":"jack",
                "spu_id":"0",
                "spu_info":"\"{\\\"id\\\": \\\"主键\\\",\\\"name\\\": \\\"标品名称\\\",\\\"aliasName\\\": \\\"别名\\\",\\\"itemNbr\\\": \\\"货号\\\",\\\"categoryId\\\": \\\"类目ID\\\",\\\"categoryName\\\": \\\"类目名称\\\",\\\"industryId\\\": \\\"行业\\\",\\\"industryName\\\": \\\"行业名称\\\",\\\"colorName\\\": \\\"配色名称\\\",\\\"brandId\\\": \\\"品牌ID\\\",\\\"brandName\\\": \\\"品牌名称\\\",\\\"seriesId\\\": \\\"系列（类别）ID\\\",\\\"seriesName\\\": \\\"系列（类别）名称\\\",\\\"description\\\": \\\"文字描叙\\\",\\\"property\\\": \\\"标品属性，本身相关一般信息，如颜色，尺码，吊牌价，上市时间，发货地等；\\\",\\\"feature\\\": \\\"标品特征：关联的外在属性，比如物流方式，特征属性，退换货服务\\\",\\\"subSeriesId\\\": \\\"款式ID(子系列ID)\\\",\\\"subSeriesName\\\": \\\"款式名称(子系列名称)\\\",\\\"cateSecondId\\\": \\\"二级类目ID\\\",\\\"cateSecondName\\\": \\\"二级类目名称\\\"}\"",
                "supplier_charge_fee_cent":35,
                "actual_paid_fee_cent":150000,
                "buyer_confirm_receipt_timeout":"买家自动确认收货时间",
                "seller_confirm_back_address_time":"卖家确认退回地址时间（包含主动确认和超时自动确认）",
                "yhb_version":"V3",
                "buyer_inspection_fee":3900,
                "seller_inspection_fee":0,
                "buyer_inspection_zfb_id":"1232112234455521145677",
                "buyer_inspection_order_id":"1233123344445",
                "seller_inspection_zfb_id":"1232112234455521145677",
                "seller_inspection_order_id":"12341232321112",
                "dispute_conclusion":"SELLER_PAY",
                "seller_alipay_pid":"2088111111111111",
                "ac_storage_id":"HSB-1",
                "inspection_coupon_fee":"100",
                "trade_success_seller_assume":true,
                "supplier_receive_fee":2990,
                "buyer_real_inspection_fee":995,
                "seller_real_inspection_fee":1995
            },
            "success":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测试工具错误码查询工具 SDK下载

闲鱼

alibaba.idle.appraise.order.query (闲鱼验货宝订单详情查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ