综合交通-商家对接
租车标准化接口Q&A
报价搜索
1.金额的相关规则
rentFee = 总租金金额，单位元,租金金额(standardPrice)+零散小时费,
standardPrice =标准价,车辆租金总价(standardUnitPrice*整租日)，不包含零散小时费!!!!
standardUnitPrice = 标准价车辆租金单价
零散小时费在 addedServiceList sid=12 零散小时费 ，零散小时费是在增值服务里传，不在外面的价格
总价是这块决定的：standardPrice+poundageFee+增值服务费，会自动计算总价，
增值服务费手动选择的也会自动计算到总价的
2.异地还车我们会给到还车地点信息，您这边自己计算异地还车费
若商家不支持异地（含异店和异城），在买家选择异地还车后，不允许返回可租车辆信息
3.carid值
carid商家不用传飞猪内部的车型id，这个carid商家自定义传Outcarid不用传车型报价列表【rentCarPrices】中的车辆id和门店id与车型信息【rentCars】和门店信息【rentStores】中的id要对应
4.车型报价列表，飞猪这边要求最大响应时间多久？
a：我们是轮询的，最多轮询3次 每次间隔1.5s。1s是保证你这边肯定能漏出的，因为策略我们随时有可能调整
超过1s 有可能用户第一次搜索看不到，但是用户同样条件搜索的话 下次可以看到
搜索我们要求比较严格，其他的3s内 下单可以慢点(后台异步的)。搜索要求快，主要是保证用户体验，也需要兼顾商家的展示率，
5.勾选送车上门服务
客户端检索送车上门的时候，报文请求里是不带什么标识的，
在客户端检索的时候，勾选了送车上门按钮，我们会根据贵司在qimen.alitrip.rentcar.prices.query接口返回的serviceOnDoorType来过滤筛选，展示有送车上门标签的报价
根据您这边返回的type来筛选
serviceOnDoorType您这边要传3或4，就是非送车上门
多传无效，拆报价传也会过滤展示一个，一般情况下，同商家同车型只会保留一个
serviceOnDoorType传1或2，就是送车善根服务的
多传无效，拆报价传也会过滤展示一个，一般情况下，同商家同车型只会保留一个
如果用户搜索页勾选了取还车，serviceOnDoorType=3.4的报价就会过滤掉
6.保险可以用一口价
7.车辆分类枚举值
车辆分类 可以不传，飞猪自己匹配
纯电动是根据排量解析的 , 纯电的排量是0
8.name（showname）车型名称
车型匹配逻辑：按照name（车型名称）、 brandName(autoBrand)（品牌名称）、gearBoxType(transmission)（变速箱）、seatNum(座位 数)、diaplacement(outputVolumn)（排量）5个字段
品牌里有英文的返回时必须小写，例如"Jeep"返回时需要传"jeep"
排量只需要数字对应，不需要传后面的L或T
否则会导致车型不展示
注：GL8如何区分【普通版】和【豪华版】？？
现在平台侧对于GL8车型的处理
name+carName双检验
name+carName中不包含"经典", "舒适"或包含"商务舒适版"listing就会展示豪华版
9.优惠信息这个如果是商家，这个要怎么提供，cardTag 次卡标记(1:次卡 2:天卡 3:随心租卡)这个是什么意思，宝贝卡是什么意思。
商家优惠是在增值服务里面传
举个例子：
{
"serviceType":4,
"serviceDesc":"",
"amount":"-103.99",
"quantity":"1",
"serviceCode":"商家优惠_-103.99",
"price":"-103.99",
"isOneWayFee":1,
"serviceName":"商家优惠",
"isFixed":true,
"sid":"14"
10.租车报价列表搜索，入参的itemId【商品ID】这是什么，
目前奇门请求入参不带itemId【商品ID】
{"carUseTime":"2023-04-18 10:00:00","creditSupport":"0","traceId":"2150437c16817331841545297e79e0","method":"alitrip.rentcar.prices.query","isPressureTest":"false","format":"json","sign":"77C1C24BE70C1FA19D03C7282C34AFB962C04FECFC087C40FF5FD","carReturnTime":"2023-04-20 10:00:00","userId":"0","returnInfo":"{\"cityId\":\"440100\",\"countryCode\":\"CN\",\"isServiceOnDoor\":false,\"location\":\"113.3056550,23.3962210\",\"name\":\"白云国际机场T2\"}","pickUpInfo":"{\"cityId\":\"440100\",\"countryCode\":\"CN\",\"isServiceOnDoor\":false,\"location\":\"113.3056550,23.3962210\",\"name\":\"白云国际机场T2\"}","target_app_key":"34308000","app_key":"23791897","partner_id":"top-sdk-java-20230316","v":"2.0","sign_method":"hmac-sha256","channelId":"70000","timestamp":"2023-04-17 20:06:24"}
11.supplierId可传店铺id，不作校验
12.本地牌，外地牌，我们没有要求商家必须传什么，可以传0无限
比如说用户搜北京,
你传了本地牌:1 就会被翻译成京牌在列表展示在我们的app上,传0不限的话 就不显示京牌
但还是显示报价的
13.
code和id自定义传
下单
1.下单请求时carid和outcarid都会传，
outcarid会默认传carid的值
2.下单时的这个 priceMark 是飞猪自己算的，没有取的商家返回的
下单时间
我们这边是以用户支付时间为标准计算的。商家侧目前不需要感知 是否为15分钟内免费取消，正常取消就可以了 , 支付时间目前没有传给商家。
3. 活动优惠的下单报文 我参考下数据
{ "investor":1, "code":"tripSingleMixPromotion-66373686506_947524608948", "offValue":"20.01", "name":"飞猪优惠", "type":1, "desc":"已减20.01" }
平台和商家 investor不一样，一个1一个2
一个单可以同时参与多个活动
4.订单提交接口 alitrip.rentcar.order.submit 失败会重试，一共五次
5.isPickUpOnDoor isPickOffOnDoor这俩字段目前都没有使用，不用考虑
退款接口
1.取车时间前（用户都是通过退款接口请求你们退款的，商家接口返回同意，结构化退款），取车时间之后，还车前（走售中退，不走接口，走后台rp退款）还车后订单完成（走售后退，不走接口，走后台）
接口会通知一下，但你们必须返回同意，取车后取消反正是收取100%费用
2.取消规则
订单取消时的违约金计算规则
如果是canceltype：1的话，系统会根据你们传的取消规则计算违约金
"cancelStrategyStruct":{"supportCancel":true,"manualCheckTime":0,"cancelType":1,"cancelRules":[{"num":0,"time":0},{"num":100,"time":-999999}],"cancelTips":""}
免押通知接口
信用免押双免，接口金额是指定传最大值（详情接口中传的车损、违章取最大的值）
信用免押标志传值
支持免押要传3
不是你们你们那边控制，我们这边会给用户免押，免押成功后通知你们，你们做好记录就行，qimen.alitrip.rentcar.order.notify
如果用户额度够，就可以多次免押，比如700分可以免12000，第一个订单6000，再下一个6000是可以的，但是第三个订单就不够额度了
其他
1.免押只能支持成功进行授信的用户，授信失败和不使用授信的押金处理全部有商家线下自己承接
2. 授信成功后，出现车损等情况， 提供凭证线下沟通收取，客户不愿承担或主动要求线上可线上发起扣款
3. 还车的时候需要用户支付，比如超期还车费，油费，车损等 ， 目前只能线下收取
4.时间段
飞猪订单：72小时未确认自动结算
飞猪分销订单：最迟7天自动结算
车辆押金解押：还车时间后15天自动解押
违章押金解押：还车时间后30天自动解押
5.租车售后退
1、取车前：商家接口返回同意，按退改规则来，退款后费用退回用户支付账户，违约金直接到账企业支付宝
2、还车后：用户点击售后退款（需要商家同意退款，在商家中心操作）、平台客服操作退款，一般为客户求助，电话核实门店后可直接操作
6.状态推送，最多提前2周，否则会失败
商家推送已还车后，用户要在页面点服务完成这样才会订单结束打钱给商家，不然就要等到超时结束
7.租车钱的单位都是元
8.实付金额 = 应付金额 - 优惠总金额
9.过了取车时间之后 飞猪客户端还可以支持取消
支持的，这个时候商家没推已取车的话，前端有订单取消的入口，走接口根据你们的退改规则来退款
10查询商家订单详情接口怎么测试
这个接口要触发审计才会调用，提供一个单号我这里模拟请求一下
11.如果搜索地点距离取车地点太远就不展示了，具体的限价限距策略
大概大于 15KM
12.过了取车时间 无法联系用户，按照我们上面说的两边客服 核对后各自在平台进行订单取消操作
客服操作关单退款的会同步调用一次商家取消订单接口 能否取消成功是商家决定 我们只是兜底调用一次
13.零散小时费，报价接口零担小时费放hourFee，详请放addedServiceList里
14.价格日历：报价的价格日历传值没有对api渠道开放，saas渠道可以自定义传，页面上的价格日历我们系统有自己展示逻辑（根据贵司传的stranduninprice和hourfee算出来的），续租报价搜索是贵司可以指定传价格日历
15.询价列表和询价详情接口里面包括全量的车型信息carDesc、carName、similarCar、tags、hasAirConditioner这几个非必填
