淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
rent_car_b2b_query_order_req	RentCarB2bQueryOrderReq	可选			入参
└ trace_id String 可选 2147b72e16691938918672871ef815 排查问题 └ order_id String 可选 523412312 飞猪订单ID └ out_order_id String 可选 6543234 分销商订单ID └ exts String 可选 {"key":"value"} 扩展字段 └ channel_id String 必须 80001 渠道id,新渠道接入联系运营

名称	类型	示例值	描述
successful	Boolean	true	请求是否成功
booking_info	OrderDetailBookingInfo		预订信息
└ car_use_time String 2022-11-24 10:00:00 取车时间 └ output_type Number 1 排量类型，1-T，2-L 3:电动 └ car_return_time String 2022-11-24 10:00:00 还车时间 └ car_seat_num Number 5 座位数 └ car_brand_name String 日产轩逸车品牌，e.g:日产轩逸 └ license_type Number 1 车牌照类型 1：本地牌 2：外地牌 └ license String 鲁A231212 牌照显示名称 └ door_num Number 4 门数量 └ car_type Number 10 车辆分类国内租车：10-经济型,9-舒适型,3-SUV,6-商务车,5-跑车,7-其他.11-豪华型,12房车 └ output_volumn String 2.0 排量值电动车可不传 rent_store_address_info OrderDetailStoreAddressInfo [] 取还车门店集合，取车门店：1-免费上门取车 2-收费上门取车 3-自行前往门店取车4-店员免费接您至门店取车；还车门店：1-免费上门还车 2-收费上门还车 3-自行前往门店还车 └ store_type Number 1 门店类型，1-门店，2-提车点 └ address String 北京市昌平区东小口文化路100号门店详细地址 └ code String asd11 门店代码 └ coordinate_source Number 1 坐标来源（1-高德，2-百度，3-Google） └ latitude String 33.534642 门店纬度 └ type Number 1 1.取车 2.还车 └ use_vehicle_type String 送车上门取还车方式 └ store_pic String xxx.png 门店图片,多张图片以英文逗号分隔 └ address_list String [] 详细地址列表，支持换行（eg:门店地址：AAA 汇合地址：BBB） └ name String 纵横租车门店名称 └ service_on_door_type Number 4 取车门店：1-免费上门取车 2-收费上门取车 3-自行前往门店取车4-店员免费接您至门店取车(免费接送)还车门店：1-免费上门还车 2-收费上门还车 3-自行前往门店还车4-店员免费送您至取车点(免费接送) └ service_on_door_fee_desc String 5公里10块钱收费上门取送车收费规则 └ longitude String 33.123634 门店经度 └ car_image String xxx.png 车型图片 └ days String 3 租车天数 └ transmission_type Number 2 变速箱类型，枚举值。详见tripcenter中Transmission枚举定义，国际租车：1-手动，2-自动。国内租车：1-手动，2-自动，3-手自一体 └ days_description String 1天2小时用车时间描述 eg:1天2小时 user_rent_address_info OrderDetailUserRentCarAddress [] 用户搜索取还车地址信息对象 └ position_name String 文化广场地点名称 └ position_type String dropOff 位置类型用车位置：pickUp 还车位置：dropOff └ latitude String 34.475863 纬度 └ city_id String 460200 区域id 代表城市或者区域的唯一id，全国通用 └ type Number 1 1.取车 2.还车 └ store_id String 6151 门店id └ longitude String 38.274958 经度
order_info	OrderDetailOrderInfo		订单相关信息
└ platform_discount String 50.1 平台优惠 └ pay_time Date 2022-11-24 10:00:00 支付时间 └ alipay_trade_no String hd21312312313 支付宝交易号 └ order_status_desc String 订单描述行业订单描述中文 └ order_status Number 2 行业订单状态 └ business_discount String 58.1 商家优惠 └ seller_receive_money String 500.1 商家应收(商家实收金额=用户应付金额+平台优惠) └ payable String 69.1 用户应付(用户应付金额:¥5) └ create_time Date 2022-11-24 10:00:00 创建时间 └ user_real_pay String 100.1 户实付(用户实付金额=用户应付金额-优惠金额) └ total_fee String 1000.1 订单总额 └ total_discount String 900.1 优惠总额(平台优惠+商家优惠) added_service_list OrderDetailAddServiceInfo [] 保存了增值服务详情 └ sid String 1 飞猪商家增值服务标准编码 └ service_desc String 增值服务描述增值服务描述 └ service_quantity String 5 增值服务数量 └ service_code String aa529 商家增值服务编码 └ third_ext_infos String {"name":"xxx"} 商家扩展 └ list_include String [] 包含增值服务说明 └ service_price_amount String 500 增值服务总价，人民币，单位元 └ service_name String 升级保险增值服务名称 └ set_negative Boolean true 是否设置负数用于区分优惠金额拼接时前面要加负号 └ sort_key Number 2 排序优先级 └ detail_msg String 这一款服务非常好描述文案详情（兼容旧接口字段） └ service_price String 200 增值服务单价,人民币，单位元 └ is_one_way_fee Number 1 是否一口价，0-否，1-是。如果是一口价，即下单时候计算金额不会乘以天数。例如手续费等,价格以增值服务单价为准。 └ is_fixed Number 1 是否必选服务，必选服务不能取消选择,0-非必选，1-必选 └ list_excloud String [] 不包含增值服务说明 └ pay_status Number 1 支付状态 1-未冻结/未付款 2-已冻结/已付款 4-已退款 6-已转交易 7-没有创建外部交易 8-交易被淘宝关闭 9-不可付款 └ refund_id String tk123 只有申请退款才有refundId └ service_type String [] 支持的服务类型 1-修改驾驶人 2-修改取还车信息 3-支持订单续租
ret_code	String	012	错误码
exts	Json	{"key":"value"}	预留扩展信息，KV对形式
ret_msg	String	orderId为空	错误信息
deposit_info	RentCarDepositInfo		信用免押信息
└ car_deposit_expire_time Number 15 车损解押时间,单位:天 └ legal_deposit_expire_time Number 45 违章解押时间,单位:天 └ enable_deposit Boolean true true:已经信用免押,false未信用免押

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripRentcarBtbOrderQueryRequest req = new AlitripRentcarBtbOrderQueryRequest();
AlitripRentcarBtbOrderQueryRequest.RentCarB2bQueryOrderReq obj1 = new AlitripRentcarBtbOrderQueryRequest.RentCarB2bQueryOrderReq();
obj1.setTraceId("2147b72e16691938918672871ef815");
obj1.setOrderId("523412312");
obj1.setOutOrderId("6543234");
obj1.setExts("{\"key\":\"value\"}");
obj1.setChannelId("80001");
req.setRentCarB2bQueryOrderReq(obj1);
AlitripRentcarBtbOrderQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripRentcarBtbOrderQueryRequest req = new AlitripRentcarBtbOrderQueryRequest();
AlitripRentcarBtbOrderQueryRequest.RentCarB2bQueryOrderReqDomain obj1 = new AlitripRentcarBtbOrderQueryRequest.RentCarB2bQueryOrderReqDomain();
obj1.TraceId = "2147b72e16691938918672871ef815";
obj1.OrderId = "523412312";
obj1.OutOrderId = "6543234";
obj1.Exts = "{\"key\":\"value\"}";
obj1.ChannelId = "80001";
req.RentCarB2bQueryOrderReq_ = obj1;
AlitripRentcarBtbOrderQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripRentcarBtbOrderQueryRequest;
$rent_car_b2b_query_order_req = new RentCarB2bQueryOrderReq;
$rent_car_b2b_query_order_req->trace_id="2147b72e16691938918672871ef815";
$rent_car_b2b_query_order_req->order_id="523412312";
$rent_car_b2b_query_order_req->out_order_id="6543234";
$rent_car_b2b_query_order_req->exts="{\"key\":\"value\"}";
$rent_car_b2b_query_order_req->channel_id="80001";
$req->setRentCarB2bQueryOrderReq(json_encode($rent_car_b2b_query_order_req));
$resp = $c->execute($req);

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=alitrip.rentcar.btb.order.query' \
-d 'partner_id=apidoc' \
-d 'sign=687D97A3BAE3D3C15B0EDE1F04DCB3DF' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+17%3A04%3A30' \
-d 'v=2.0' \
-d 'rent_car_b2b_query_order_req=null'

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

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

req.rent_car_b2b_query_order_req="数据结构示例JSON格式"
try:
	resp= req.getResponse()
	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,"alitrip.rentcar.btb.order.query");
add_param(pRequest,"rent_car_b2b_query_order_req","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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('alitrip.rentcar.btb.order.query', {
	'rent_car_b2b_query_order_req':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_rentcar_btb_order_query_response>
    <successful>true</successful>
    <booking_info>
        <car_use_time>2022-11-24 10:00:00</car_use_time>
        <output_type>1</output_type>
        <car_return_time>2022-11-24 10:00:00</car_return_time>
        <car_seat_num>5</car_seat_num>
        <car_brand_name>日产轩逸</car_brand_name>
        <license_type>1</license_type>
        <license>鲁A231212</license>
        <door_num>4</door_num>
        <car_type>10</car_type>
        <output_volumn>2.0</output_volumn>
        <rent_store_address_info>
            <order_detail_store_address_info>
                <store_type>1</store_type>
                <address>北京市昌平区东小口文化路100号</address>
                <code>asd11</code>
                <coordinate_source>1</coordinate_source>
                <latitude>33.534642</latitude>
                <type>1</type>
                <use_vehicle_type>送车上门</use_vehicle_type>
                <store_pic>xxx.png</store_pic>
                <name>纵横租车</name>
                <service_on_door_type>4</service_on_door_type>
                <service_on_door_fee_desc>5公里10块钱</service_on_door_fee_desc>
                <longitude>33.123634</longitude>
            </order_detail_store_address_info>
        </rent_store_address_info>
        <car_image>xxx.png</car_image>
        <days>3</days>
        <transmission_type>2</transmission_type>
        <days_description>1天2小时</days_description>
        <user_rent_address_info>
            <order_detail_user_rent_car_address>
                <position_name>文化广场</position_name>
                <position_type>dropOff</position_type>
                <latitude>34.475863</latitude>
                <city_id>460200</city_id>
                <type>1</type>
                <store_id>6151</store_id>
                <longitude>38.274958</longitude>
            </order_detail_user_rent_car_address>
        </user_rent_address_info>
    </booking_info>
    <order_info>
        <platform_discount>50.1</platform_discount>
        <pay_time>2022-11-24 10:00:00</pay_time>
        <alipay_trade_no>hd21312312313</alipay_trade_no>
        <order_status_desc>订单描述</order_status_desc>
        <order_status>2</order_status>
        <business_discount>58.1</business_discount>
        <seller_receive_money>500.1</seller_receive_money>
        <payable>69.1</payable>
        <create_time>2022-11-24 10:00:00</create_time>
        <user_real_pay>100.1</user_real_pay>
        <total_fee>1000.1</total_fee>
        <total_discount>900.1</total_discount>
        <added_service_list>
            <order_detail_add_service_info>
                <sid>1</sid>
                <service_desc>增值服务描述</service_desc>
                <service_quantity>5</service_quantity>
                <service_code>aa529</service_code>
                <third_ext_infos>{&quot;name&quot;:&quot;xxx&quot;}</third_ext_infos>
                <service_price_amount>500</service_price_amount>
                <service_name>升级保险</service_name>
                <set_negative>true</set_negative>
                <sort_key>2</sort_key>
                <detail_msg>这一款服务非常好</detail_msg>
                <service_price>200</service_price>
                <is_one_way_fee>1</is_one_way_fee>
                <is_fixed>1</is_fixed>
            </order_detail_add_service_info>
        </added_service_list>
        <pay_status>1</pay_status>
        <refund_id>tk123</refund_id>
    </order_info>
    <ret_code>012</ret_code>
    <exts>{&quot;key&quot;:&quot;value&quot;}</exts>
    <ret_msg>orderId为空</ret_msg>
    <deposit_info>
        <car_deposit_expire_time>15</car_deposit_expire_time>
        <legal_deposit_expire_time>45</legal_deposit_expire_time>
        <enable_deposit>true</enable_deposit>
    </deposit_info>
</alitrip_rentcar_btb_order_query_response>

{
    "alitrip_rentcar_btb_order_query_response":{
        "successful":true,
        "booking_info":{
            "car_use_time":"2022-11-24 10:00:00",
            "output_type":1,
            "car_return_time":"2022-11-24 10:00:00",
            "car_seat_num":5,
            "car_brand_name":"日产轩逸",
            "license_type":1,
            "license":"鲁A231212",
            "door_num":4,
            "car_type":10,
            "output_volumn":"2.0",
            "rent_store_address_info":{
                "order_detail_store_address_info":[
                    {
                        "store_type":1,
                        "address":"北京市昌平区东小口文化路100号",
                        "code":"asd11",
                        "coordinate_source":1,
                        "latitude":"33.534642",
                        "type":1,
                        "use_vehicle_type":"送车上门",
                        "store_pic":"xxx.png",
                        "name":"纵横租车",
                        "service_on_door_type":4,
                        "service_on_door_fee_desc":"5公里10块钱",
                        "longitude":"33.123634"
                    }
                ]
            },
            "car_image":"xxx.png",
            "days":"3",
            "transmission_type":2,
            "days_description":"1天2小时",
            "user_rent_address_info":{
                "order_detail_user_rent_car_address":[
                    {
                        "position_name":"文化广场",
                        "position_type":"dropOff",
                        "latitude":"34.475863",
                        "city_id":"460200",
                        "type":1,
                        "store_id":"6151",
                        "longitude":"38.274958"
                    }
                ]
            }
        },
        "order_info":{
            "platform_discount":"50.1",
            "pay_time":"2022-11-24 10:00:00",
            "alipay_trade_no":"hd21312312313",
            "order_status_desc":"订单描述",
            "order_status":2,
            "business_discount":"58.1",
            "seller_receive_money":"500.1",
            "payable":"69.1",
            "create_time":"2022-11-24 10:00:00",
            "user_real_pay":"100.1",
            "total_fee":"1000.1",
            "total_discount":"900.1",
            "added_service_list":{
                "order_detail_add_service_info":[
                    {
                        "sid":"1",
                        "service_desc":"增值服务描述",
                        "service_quantity":"5",
                        "service_code":"aa529",
                        "third_ext_infos":"{\"name\":\"xxx\"}",
                        "service_price_amount":"500",
                        "service_name":"升级保险",
                        "set_negative":true,
                        "sort_key":2,
                        "detail_msg":"这一款服务非常好",
                        "service_price":"200",
                        "is_one_way_fee":1,
                        "is_fixed":1
                    }
                ]
            },
            "pay_status":1,
            "refund_id":"tk123"
        },
        "ret_code":"012",
        "exts":"{\"key\":\"value\"}",
        "ret_msg":"orderId为空",
        "deposit_info":{
            "car_deposit_expire_time":15,
            "legal_deposit_expire_time":45,
            "enable_deposit":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下载

开放平台

旅行用车API

alitrip.rentcar.btb.order.query (租车分销查询订单信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ