文档中心 > API类目 > 旅行用车API

qimen.alitrip.rentcar.addedservice.queryprice (保险加购报价接口)

增值服务加购报价接口，涵盖保险和额外服务。暂只支持结构化的保险报价。整个保险加购接口的正向调用顺序：报价接口 -> 预下单check -> 提交订单逆向：取消订单

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
addedServiceDetailQueryReq	AddedServiceDetailQueryReq	可选			保险加购报价rq
└ orderId Number 可选 13513 飞猪订单号（租金单订单号） └ vendorOrderId String 可选 2315 供应商订单号（租金单订单号）方便商家查询主单对应的车型和保险

响应参数

名称	类型	示例值	描述
addedServiceDetailQueryRsp	AddedServiceDetailQueryRsp		保险加购报价rs
insuranceStructInfo InsuranceStructInfo 保险结构化信息，内层费项部分需与addedServiceList对应。eg：serviceCode需对应，若没对应则影响算价 insurances RentCarInsurance [] 租车保险类型 1-基础服务(基本险-必传) 2-优享服务（不计免赔险） 3-尊享服务, 99-其他保险 └ dailyUnitPrice String 2.00 优惠后保险每日单价，单位元 └ serviceCode String insurance-212 商家增值服务编码 └ originDailyUnitPrice String 2.00 保险每日单价,人民币，单位元 └ insuranceName String 基础服务保险名称 └ insuranceType Number 1 类型 1-基础服务(基本险-必传) 2-优享服务（不计免赔险） 3-尊享服务, 99-其他保险 insuranceItems InsuranceItem [] 此保险包含的项 └ subIncludes Number [] 不同项，包含的值是不一样，如果都有则把多个枚举传入，没有则不传 1:包含玻璃,2:包含车轮 └ include Boolean true 包含此内容项不包含项:null\|\|false 包含项:true └ name String 车损保障标题 └ from Number 1500 已废弃无需承担车损的起始金额,(元) e.g: 无需承担车损1500元-150万元的部分 1500是该字段含义的具体值 └ to Number 1500000 已废弃无需承担车损的金额上限,(元) e.g: 无需承担车损1500元-150万元的部分 150万是该字段含义的具体值特殊的：若商家该保项无上限值，则传1500万作为上限 └ type Number 1 1：车损保障 2：三者保障 3：免折旧费 4：免停运费 5：无需垫付 └ percent Number 30 折旧费比例 e.g: 车损5000元以下，无需承担因车损导致的折旧费；超出部分需要承担维修总额的30%作为折旧费 30% 输入30 └ bounds Number 1500 起赔额或保额上限起赔额：用户自付的部分，保险公司只在超过这个部分时才赔偿。起赔额：保险公司承担的最高赔偿金额，超过这个金额的部分需要用户自负。 └ required Boolean false 是否必选，必选不能取消选择,false-非必选，true-必选 └ sid String 21 飞猪商家增值服务标准编码 11：车辆租金 12：零散小时费 13：手续费 14：商家优惠，传负值 21：基础服务 22：优享服务 23：尊享服务 24：其他保险服务费 31：送车上门服务费 32：上门还车服务费 33：异地还车费 34：夜间服务费 101：婴儿座椅（0~15个月） 102：儿童座椅（9个月~6岁） 103：儿童增高座垫（6~12岁） 111：防滑链 112：雪地胎 201：一口价活动 OTHER：其他费用 addedServiceList AddedService [] 增值服务列表 └ serviceType Number 1 1-基础服务(基本险-必传) 2-优享服务（不计免赔险） 3-尊享服务 └ serviceDesc String 基础服务增值服务描述 └ quantity String 2 增值服务数量 └ serviceCode String insurance-212 增值服务Code └ price String 2.00 增值服务单价 └ isOneWayFee Number 0 是否一口价，0-否，1-是。如果是一口价，即下单时候计算金额不会乘以天数。例如手续费等,价格以增值服务单价为准。 └ listInclude String [] 包含增值服务说明 └ amount String 2.00 增值服务总价 └ serviceName String 基础服务增值服务名称基础服务必填 └ isFixed Boolean true 是否必选服务，必选服务不能取消 └ listExcloud String [] 不包含增值服务说明 └ 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 其他费用（商家传的其他费用，可能为正值或负值）
success	Boolean	true	响应是否成功 true：成功 false：失败
retCode	String	错误码	错误码
retMessage	String	错误信息	错误信息

请求示例

{"addedServiceDetailQueryReq":{"orderId":13513,"vendorOrderId":"2315"}}

响应示例

{
    "addedServiceDetailQueryRsp":{
        "insuranceStructInfo":{
            "insurances":[
                {
                        "dailyUnitPrice":"2.00",
                        "serviceCode":"insurance-212",
                        "originDailyUnitPrice":"2.00",
                        "insuranceName":"基础服务",
                        "insuranceType":1,
                        "insuranceItems":[
                            {,
                                    "include":true,
                                    "name":"车损保障",
                                    "from":1500,
                                    "to":1500000,
                                    "type":1,
                                    "percent":30,
                                    "bounds":1500
                            }
                        ],
                        "required":false,
                        "sid":"21"
                }
            ]
        },
        "addedServiceList":[
            {
                    "serviceType":1,
                    "serviceDesc":"基础服务",
                    "quantity":"2",
                    "serviceCode":"insurance-212",
                    "price":"2.00",
                    "isOneWayFee":0,
                    "amount":"2.00",
                    "serviceName":"基础服务",
                    "isFixed":true,
                    "sid":"21"
            }
        ]
    },
    "success":true,
    "retCode":"错误码",
    "retMessage":"错误信息"
}

验签示例

{"success":"false","retMessage":"Illegal request","retCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

旅行用车API

qimen.alitrip.rentcar.addedservice.queryprice (保险加购报价接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ