酒店客栈-线上预订
酒店常见问题汇总
问题1: 你们目前是只支持1间房吗
A: hoteldetail接口只支持1间房，roomavailiable接口支持多间房
问题2：RateCode如何定义
A: 是唯一值，这个值是由商家定义的；
问题3：ratekey如何定义
A：建议和ratecode定义一致，roomavailiable接口请求和返回的ratekey需要保持一致
问题4：ratekey可以是动态的吗
A：当rate不可用时，我们会根据ratekey回收库存（搜索这边会自动回刷库存），所以如果ratekey是动态的，这个动作可能就会失败，会导致roomAvailability API的失败率很高。
问题5：ResponseTimestamp这个时间必须是实时的吗？可以是过去的某个时间点吗？因为我可能会调用数据库保存的时间点
A:是实时的，精确到秒
问题6：服务地址是否可以提供多个
A： 只支持配置一个地址http://{vendor's host}，请求飞猪会自动拼上接口名http://{vendor's host}/hotelRooms
问题7：关于top接口传的房型code与hoteldetail返回的房型code是否可以不一致
A：必须保持一致，飞猪会校验top接口传的房型，最终外网只会展示top接口传的有报价库存的房型
问题8：关于hotelist接口
A：目前飞猪不会调商家hotelist接口计算最低价，飞猪会通过hoteldetail的价格去计算最低价，该接口非必须开发的。
问题9：CreateOrder request中TotalPrice 与PaidPrice 的区别
A:TotalPrice 包含卖家优惠
问题10：下单、查单、取消接口有响应时间要求吗？
A:文档上没有对返回时间做特殊要求，一般10s内返回结果即可
问题11：使用接口计算出来的city如果与表格http://hotel.alitrip.com/area.htm?tbpm=3&domestic=1&enName=&page=1中的不一致的话，以哪个为准
A：以接口计算出来的为准
问题12：调用商家接口的频率是多少？How frequently you will call those api
A：调用频率不一定，不同接口不一样，不会超过商家设置的QPS. It may change sometimes,and each api could be different.Generally,it won't exceed the QPS you have set.
问题13：如果飞猪调用我们的Room Availability接口时，房型已经关房了（而且我们不返回价格），飞猪会在自己系统里关房吗？
A: 商家系统没有价库/关房的话，返回相应的错误码即可，这个就是试单失败，失败后飞猪会回刷库存，正常前端就不会再展示这个报价了
问题14 ：国际城市码、下载飞猪国际城市结果
A:商家可以通过以下接口上传地理位置、下载城市结果：
https://open.taobao.com/api.htm?docId=32070&docType=2&source=search
使用这两个方法计算出来的city如果与在线表格http://hotel.alitrip.com/area.htm?tbpm=3&domestic=1&enName=&page=1中的不一致的话，以计算出来的为准
?
若需要离线Excel数据的话，
请联系BD进入下述链接申请权限，导出数据给商家
问题15：商家要切acm直连 需要打什么标
A: 1924 打在酒店上 1799和1735打在商家推的基础rp上
问题16：想要发布非直连特殊rp，需要如何操作
A:如果只是需要发布非直连rp，门店帮助商家打标900和28420即可
问题17：房型匹配问题
A:https://open.taobao.com/api.htm?docId=42711&docType=2&scopeId=16043
可以先通过这个alitrip.hotel.hstdf.shotel.matchsroomself接口进行测试房型匹配的结果。
需要先在淘宝开发平台后台申请权限
问题18： taobao.xhotel.rateplan.add 报 Invalid arguments:name
A: 1. 检查字段名称与接口文档是否一致
2.确认name 长度是否超过了60
问题19： 更新价库时报当前卖家无权新增特殊ebk直连的价格计划相关的报价
A: 1. 一般情况下对于基础rp不允许更新其rate上的价库，需要让其联系对于的业务同学确认，如果需要更新的那么需要业务提交工单給商品同学按照卖家维度配置
问题20：如何删除卖家酒店/卖家房型
A: 需要商家自行调用taobao.xhotel.delete 删除酒店/taobao.xhotel.roomtype.delete.public 删除房型
问题21:线下支付费用要怎么传参
A:国内接口没有支持线下支付费用的字段，tax和fee是一起的；不落库接口有hotelfee（resortfee是hotelfee的一种），可以支持线下付给门店，hotelfee是本身就不包含在房费里面的
问题22：酒店侧推送限流
A:飞猪酒店侧限流目前有以下几种，请按照如下排查
- accesscontrol.limited-by-app-access-count ，该限流为该应用（appkey）调用流量达到当天限制，平台提供了紧急流量重置功能，每天可以刷新三次，流量重置后会清零重新统计，步骤：登录 开放平台控制台--应用管理--选择对应应用管理--APP证书-- 点击 重置流量控制 ，就可以触发流量刷新。如果需要提高流量登记，需要联系bd给开放平台睿柏，亦雀，邮件模版：业务背景说明，因为XXX，需要申请appkey：XXXXXXX，进行流量调整，从XXX万/天->XXX万/天，请审批操作，感谢
- accesscontrol.limited-seller-api-access-count，该限流为飞猪侧卖家维度限流，需要让BD联系对应的运营同学看是否可以申请提高限流
- accesscontrol.limited-by-api-access-count，该限流为对单接口（api）调用总频率的达到限制，该限制是平台针对所有isv应用同时访问某个api接口每分钟或每秒钟调用总量的限制。是api级别的限制，与单个isv应用（appkey）无关，api级别流量限制目的是防止短时间内请求量过大影响后端服务的稳定性。api限流报错，一般无法进行调整，只能稍后重试。此种错误一般还伴有“This ban will last for ** more seconds” 的信息，意思是等待**秒钟以后再调用。建议ISV调整降低该接口调用频率，错开高峰期调用。或者使用其他可接口进行分流。
- rate接口返回-132，该限流为商家是批量推送时，然后飞猪侧处理的时候是单条更新的，有两层限流，TOP层和底层服务处理层，服务处理的时候按照单条做了限流，所以部分成功部分失败 ，此类问题目前商家侧只能重试那些失败的限流
问题23：推送报价失败--提示价格和库存json构建rate信息参数失败
A::报错提示"sub_code": "isv.invalid-parameter: PARSE_RATES_FAILED", "sub_msg": "价格和库存json构建rate信息参数失败,请检查传入的rp_code以及"
请按如下步骤排查
- 请核对你传入的ratePlanCode是否已经推送到 飞猪侧，可通过查询rp接口查询 https://fliggy.open.taobao.com/doc.htm?docId=22667&docType=2 ，如未推送请先完成推送
- 请检查你的vendor指是否有传入，复杂价格推送时，已有飞猪侧提供的vendor指请填入对应的vendor值、否则填写taobao
问题24：taobao.xhotel.roomtype.add--参数不正确报错
A:请按如下步骤排查
- https://fliggy.open.taobao.com/doc.htm?docId=22662&docType=2 根据文档确认检查你的参数信息
- 请核查name 字段是否传入了敏感词，例如拼房、双拼等，敏感词校验不通过，返回的也是参数不正确
问题25：非转直直转非
A: 非转直及直转非问题请移步非转直直转非工具内常见问题：https://fliggy.open.taobao.com/doc.htm?docId=121581&docType=1
