淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
creditSupport	String	可选	0		是否信用免押(国内租车专用)，0-不限制，1-免车辆押金，2-免违章押金，3-均支持，4-不支持
ext	String	可选	JSON扩展字段		扩展属性
cardTag	String	可选	2		次卡标记(1:次卡 2:天卡 3:随心租卡)
returnInfo	ReturnInfo	可选			还车地址信息
└ countryEn String 可选 American 国家，英文 └ isServiceOnDoor String 可选 true 是否上门取车（国内租车专用） └ city String 可选 111000 还车城市名称 └ cityId String 可选 111000 取车城市Code └ continentId String 可选 11 所在州id，如亚洲：xxx，欧洲：yyy └ countryCode String 可选 USA 国家代码 └ name String 可选位置名称取车位置名称 └ serviceOnDoorType String 可选 1-免费上门还车 2-收费上门还车 3-自行前往门店还车 1-免费上门取车 2-收费上门取车 3-自行前往门店取车4-店员免费接您至门店取车 └ cityEn String 可选 New York 城市，英文 └ location String 可选 123.11,11.11 取车位置经纬度。格式：经度,维度 └ stateCode String 可选 aa 城市所属州代码 └ airportCode String 可选 LAX 位置机场代码 └ storeCode String 可选 12345 取车门店Code
itemId	String	可选	123456		商品ID
cardValue	String	可选	true		宝贝值 eg:ufennnvd%73@v
rentCarStorePairInfos	RentCarStorePairInfos []	可选		最大列表长度：999999	取还车门店信息租车（包含服务范围）
└ returnStoreCode String 可选 12345 还车门店code └ pickUpStoreCode String 可选 12345 取车门店code └ returnCityCode String 可选 111000 还车城市code └ returnRangeInfos String [] 可选还车门店的服务范围 └ pickUpCityCode String 可选 111000 取车城市code └ pickUpRangeInfos String [] 可选取车门店的服务范围
traceId	String	必须	1223		本次请求的标识
carUseTime	String	可选	2017-05-22 11:11:11		取车时间
carReturnTime	String	可选	2017-05-22 11:11:11		还车时间
pickUpInfo	PickUpInfo	可选			取车地址信息
└ countryEn String 可选 American 国家，英文 └ isServiceOnDoor String 可选 true 是否上门取车（国内租车专用） └ city String 可选北京还车城市名称 └ cityId String 可选 111000 还车城市code └ continentId String 可选 11 所在州id，如亚洲：xxx，欧洲：yyy └ countryCode String 可选 USA 国家代码 └ name String 可选位置名称取车位置名称 └ serviceOnDoorType String 可选 1-免费上门取车 2-收费上门取车 3-自行前往门店取车4-店员免费接您至门店取车 1-免费上门取车 2-收费上门取车 3-自行前往门店取车4-店员免费接您至门店取车 └ cityEn String 可选 New York 城市，英文 └ location String 可选 123.11,11.11 取车位置经纬度。格式：经度,维度 └ stateCode String 可选 aa 城市所属州代码 └ airportCode String 可选 LAX 位置机场代码 └ storeCode String 可选 11111 取车门店Code

名称	类型	示例值	描述
providerId	String	20010	服务商id 7xxxx
providerName	String	测试渠道	服务商名称
rentCarPricesDomestic	RentCarPriceDomestic []		车型报价列表
└ carId String 1111 商家车型id └ stdVehModId String 1022 飞猪B端标准车型id，从飞猪侧获取 └ supplierId String 22221 品牌商id，此处如果是非平台型商家，则需传渠道号，如果是平台型商家，则需要传子商家Id └ supplierName String 测试供应商品牌商名称 └ pickUpStoreId String 1111 取车门店id └ returnStoreId String 11111 还车门店id └ carPreDeposit String 2000 车辆押金，单位元 └ outerPriceId String 123456 （国内租车专用）商家价格标识码，车辆详情接口与订单提交接口会再次传递给商家 └ legalPreDeposit String 1000 违章押金，单位元（如商家传递为空，默认2000元） └ oneWayFeeRMB String 123.11 异地还车费，人民币，单位元 └ oneWayFeePaymode String 1 异地还车费，支付方式：1-在线支付，2-到店支付，预留 └ basicRentFee String 187.00 车辆基本租金，人民币，单位元，必填 └ totalRentFee String 1111.00 包含手续费、基本保障服务等的总费用，人民币，单位元，必填 └ poundageFee String 15.00 手续费(总费用),单位元 └ basicServiceFee String 37.04 总基础服务费,单位元 └ rentFee String 235.00 总租金金额,单位元 └ hourFee String 零散小时费总金额,单位元零散小时费总金额,单位元 eg:38.09 └ onDoorFee String 20.00 上门送取车费用总金额（收费上门送取车时必传）,单位元 └ pickUpOnDoorFee String 10 上门取车费 └ tags String "3,30,32,40,41" 国内租车专用！支持carId+pickUpStoreId维度的标签，标签之间用英文逗号分隔,约束：只允许传以下值tag的数字：新版标签： TAG_3(3,"信用双免"),TTAG_14(14,"配手机支架"),TAG_17(17,"24小时营业"),TAG_18(18,"倒车雷达"),TAG_20(20,"配纸巾"),TAG_21(21,"配饮用水"),TAG_22(22,"配车充"),TAG_25(25,"儿童座椅"),TAG_26(26,"倒车影像"),TAG_27(27,"配行车记录仪"),TAG_30(30,"一车一洗"),TAG_32(32,"一年内新车"),TAG_33(33,"两年内新车"),TAG_34(34,"三年内新车"),TAG_39(39,"半年内新车"),TAG_40(40,"油量保障"),TAG_41(41,"不限里程"),TAG_105(105,"一口价"),TAG_106(106,"送车损无忧")如有需求新增请联系业务运营。注意：以下标签将在新版废弃，请注意按照新版标签返回： TAG_1(1,"信用免押·免车辆押金"),TAG_2(2,"信用免押·免违章押金")//如果有3，就必须将1或2去掉，3表示全免；TAG_4(4,"送车上门"),TAG_5(5,"上门取车"),TAG_6(6,"上门取送"),TAG_7(7,"快速取还"),TAG_8(8,"车况佳"),TAG_9(9,"满油取还"),TAG_10(10,"3万公里内新车"),TAG_11(11,"3公里内免费接送"),TAG_12(12,"支持异点还车"),TAG_13(13,"新款车"),TAG_15(15,"老款车"),TAG_16(16,"免费接至门店取车"),TAG_19(19,"服务专业"),TAG_23(23,"取还便捷"),TAG_24(24,"快速取"),TAG_28(28,"5公里内免费接送"),TAG_29(29,"无需等待"),TAG_31(31,"免费上门取送车"),TAG_35(35,"实时结算"),TAG_36(36,"能源免费"),TAG_37(37,"纯电动"),TAG_38(38,"旅行车"),TAG_43(43,"雪地胎")，TAG_58(58,"支持安心租一口价"),TAG_218(218,"可升级车损免赔") └ extInfos String sellerId%3A%3B1234%3B%3AsellerNick%3A%3B测试商家昵称可选，临时扩展信息字段，以KV对形式存储，key与value之间使用%3A%3B分隔，多个KV间使用%3B%3A分隔，格式：key1%3A%3Bvalue1%3B%3Akey2%3A%3Bvalue2%3B%3A。目前支持的key有：sellerId（卖家id），sellerNick（卖家昵称），wangwang（卖家旺旺），telInland（卖家国内服务电话），telOutland（卖家境外服务电话），rule（退改规则），service（特色服务），serviceRange（服务范围, 1国内, 2国外, 0 两者） └ stockNum Number 3 库存，（国内租车专用,若无库存请传空） └ cancelType String 101 取消类型（必填）101：免费取消-取车时间前可免费取消。 * 102：限时免费取消-取车前X小时可免费取消；取车前X小时-取车时间取消扣订单总金额X%；取车时间后取消扣订单全额。 * 103：有损取消-该订单付款后取消，需扣订单总金额X%。 └ thirdExtInfos String 第三方扩展信息第三方扩展信息 └ pickUpCarType String 2 取车类型 1:免费上门送取车 2:收费上门送取车 3: 自行前往门店取还车 4:店员免费接您至门店取还车 └ returnCarType String 2 取车类型 1:免费上门送取车 2:收费上门送取车 3: 自行前往门店取还车 4:店员免费接您至门店取还车 └ returnOnDoorFee String 10 上门还车费 └ honerServiceFee String 20 尊享服务费(不参与总价计算)，单位元 addedServiceList AddedService [] 增值服务(仅次卡业务对接使用) └ sid String 21 飞猪标准服务ID:SID 费用名称 11 车辆租金 12 零散小时费 13 手续费 14 商家优惠，负值 21 基础服务费 22 尊享服务费 23 车损无忧 24 其他保险服务费 31 送车上门服务费 32 上门还车服务费 33 异地还车费 34 夜间服务费 101 婴儿座椅（0~15个月） 102 儿童座椅（9个月~6岁） 103 儿童增高座垫（6~12岁） 111 防滑链 112 雪地胎，OTHER 其他费用（商家传的其他费用，可能为正值或负值） └ serviceCode String 111 商家增值服务编码 └ serviceName String 车损免赔增值服务名称 └ serviceDesc String 车损免赔增值服务描述 └ servicePrice String 190 增值服务单价,人民币，单位元 └ serviceQuantity String 2 增值服务数量 └ servicePriceAmount String 100 增值服务总价，人民币，单位元 └ isFixed Boolean true 是否必选服务，必选服务不能取消选择,0-非必选，1-必选 └ isOneWayFee Number 1 是否一口价，0-否，1-是。如果是一口价，即下单时候计算金额不会乘以天数 └ listInclude String [] 包含增值服务说明 └ listExcloud String [] 不包含增值服务说明 └ serviceType Number 1 1-基础服务费(基本险-必传) 2-尊享服务费（不计免赔险） 3-其他保险 4-其他服务费 └ carLicenseDesc String 京A牌牌照描述 └ carLicense Number 1 牌照类型，0-不限，1-本地牌，2-外地牌
errorInfo	ErrorInfo		错误信息
└ subMessage String 子错误信息子错误信息 └ subCode String --1 子错误码 └ message String 错误信息自定义错误信息。记录各链路错误详细描述，以“\|”分隔，如：商家接口出现系统异常/业务错误（uac）\|商家具体错误描述。 └ code String 1001 自定义错误码。1001：商家接口系统异常。2001：商家接口业务异常。3001：uac内部系统异常。4001：uac业务校验异常。
success	Boolean	true	接口调用是否成功

{"creditSupport":"0","ext":"JSON扩展字段","returnInfo":{"countryEn":"American","isServiceOnDoor":"true","city":"111000","cityId":"111000","continentId":"11","countryCode":"USA","name":"位置名称","serviceOnDoorType":"1-免费上门还车 2-收费上门还车 3-自行前往门店还车","cityEn":"New York","location":"123.11,11.11","stateCode":"aa","airportCode":"LAX","storeCode":"12345"},"traceId":"1223","carUseTime":"2017-05-22 11:11:11","itemId":"123456","pickUpInfo":{"countryEn":"American","isServiceOnDoor":"true","city":"北京","cityId":"111000","continentId":"11","countryCode":"USA","name":"位置名称","serviceOnDoorType":"1-免费上门取车 2-收费上门取车 3-自行前往门店取车4-店员免费接您至门店取车","cityEn":"New York","location":"123.11,11.11","stateCode":"aa","airportCode":"LAX","storeCode":"11111"},"carReturnTime":"2017-05-22 11:11:11","cardValue":"true","rentCarStorePairInfos":[{"returnStoreCode":"12345","pickUpStoreCode":"12345","returnCityCode":"111000","returnRangeInfos":[""],"pickUpCityCode":"111000","pickUpRangeInfos":[""]}],"cardTag":"2"}

{
    "providerId":"20010",
    "providerName":"测试渠道",
    "rentCarPricesDomestic":[
        {
                "carId":"1111",
                "stdVehModId":"1022",
                "supplierId":"22221",
                "supplierName":"测试供应商",
                "pickUpStoreId":"1111",
                "returnStoreId":"11111",
                "carPreDeposit":"2000",
                "outerPriceId":"123456",
                "legalPreDeposit":"1000",
                "oneWayFeeRMB":"123.11",
                "oneWayFeePaymode":"1",
                "basicRentFee":"187.00",
                "totalRentFee":"1111.00",
                "poundageFee":"15.00",
                "basicServiceFee":"37.04",
                "rentFee":"235.00",
                "hourFee":"零散小时费总金额,单位元",
                "onDoorFee":"20.00",
                "pickUpOnDoorFee":"10",
                "tags":"\"3,30,32,40,41\"",
                "extInfos":"sellerId%3A%3B1234%3B%3AsellerNick%3A%3B测试商家昵称",
                "stockNum":3,
                "cancelType":"101",
                "thirdExtInfos":"第三方扩展信息",
                "pickUpCarType":"2",
                "returnCarType":"2",
                "returnOnDoorFee":"10",
                "honerServiceFee":"20",
                "addedServiceList":[
                    {
                            "sid":"21",
                            "serviceCode":"111",
                            "serviceName":"车损免赔",
                            "serviceDesc":"车损免赔",
                            "servicePrice":"190",
                            "serviceQuantity":"2",
                            "servicePriceAmount":"100",
                            "isFixed":true,
                            "isOneWayFee":1,
                            "serviceType":1
                    }
                ],
                "carLicenseDesc":"京A牌",
                "carLicense":1
        }
    ],
    "errorInfo":{
        "subMessage":"子错误信息",
        "subCode":"--1",
        "message":"错误信息",
        "code":"1001"
    },
    "success":true
}

{"success":"false","errorInfo":{"code":"sign-check-failure","message":"Illegal request"}}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

旅行度假API

qimen.alitrip.rentcar.pricelist.query (新版召回租车报价列表搜索)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ