综合交通-商家对接
租车次卡商家接口改造文档
更新时间：2024/07/11
访问次数：641
背景
- 国内租车支持飞猪次卡、商家次卡等玩法升级奇门接口。
升级说明
- 需要升级的接口包括：
- 租车报价列表搜索接口
- 租车车辆报价详情查询接口
- 租车订单提交接口
- 升级说明：
- 列表搜索接口和车辆报价详情接口飞猪传是否租车次卡搜索标记和次卡id给商家。如果商家有根据不同类型玩法卡片过滤不同报价需求可以根据次卡id进行区分（注意：有返回时必须返回总租金、总手续费、总基础服务费三个字段）。
- 下单接口飞猪会传给商家当前订单是否是次卡订单标记。如果是次卡订单会传rentCardAttrMap字段。里面包含次卡宝贝ID、宝贝订单号、宝贝卡卡号、减免的总租金金额、减免的总基础服务费金额、减免的总手续费金额。商家需要存储这些信息用于将来跟飞猪对账结算。
报价列表搜索接口
qimen.alitrip.rentcar.prices.query( 租车报价列表搜索 )
- 实现逻辑
- 商家需要返回总基础服务费、总手续费、总租金金额对应的值。飞猪根据次卡规则配置减去对应的需要减免项后展示用户需要支付金额
- eg:订单总价170元 ，总租金金额=100 总手续费=20 总基础服务费=50
如果次卡配置了减免租金和手续费 则订单展示的用户需支付金额=170-100-20=50元
如果次卡配置了减免租金、手续费、基础服务费 则订单展示的用户需支付金额=170-20-100-50=0元
- 注意不要判断是否是次卡请求，是所有的请求都要返回这三个字段。普通的搜索接口也要返回！！！
- 改动点
- 入参
- cardValue （String）宝贝值 eg:ufennnvd%73@v
- cardTag (String) 次卡标记(1:次卡 2:天卡 3:随心租卡) eg:2
- 出参
- rentCarPrices结构体重添加
- basicServiceFee (String) 总基础服务费,单位元 eg:38.09
- poundageFee (String) 总手续费,单位元 eg:15.00
- rentFee(String) 总租金金额 eg:235.00
商品详情接口
qimen.alitrip.rentcar.cardetail.query( 租车车辆报价详情查询 )
- 价格计算逻辑同报价列表搜索接口
- 改动点
- 入参
- cardValue （String）宝贝值 eg:ufennnvd%73@v
- cardTag (String) 次卡标记(1:次卡 2:天卡 3:随心租卡) eg:2
- 出参
- priceInfo结构体重添加
- basicServiceFee (String) 总基础服务费,单位元 eg:38.09
- poundageFee (String) 总手续费,单位元 eg:15.00
- rentFee(String) 总租金金额 eg:35.00
下单接口
qimen.alitrip.rentcar.order.submit( 租车订单提交接口 )
- 实现逻辑
- 商家根据飞猪下单接口传的cardTag判断是否是次卡订单。存在飞猪传的rentCardAttrMap中的数据用来跟飞猪对账使用（对账时主要通过宝贝订单号才匹配，金额明细通过rentCardAttrMap中金额字段获取）。
- 改动点
- 入参
- cardTag (String) 次卡标记(1:次卡 2:天卡 3:随心租卡) eg:2
- rentCardAttrMap (String) 宝贝扩展字段map，kv结构
- cardId 宝贝ID（既商品skuId）
- cardOrderId 宝贝订单号
- cardTradeNo 宝贝卡卡号
- basicRentFee 减免的总租金金额（如无减免，返回0）
- basicServiceFee 减免的总基础服务费金额（如无减免，返回0）
- poundageFee 减免的总手续费金额（如无减免，返回0）
- eg：{"cardOrderId":"2108999268452098839","basicRentFee":"138.38","cardId":"16316885607258400","cardTradeNo":"202109152200","basicServiceFee":"50","poundageFee":"20.01"}
sdk参考
登录奇门后台，更新最新sdk即可
