红色加力库存API常用FAQ

一、商务侧

 红色加力资源介绍

    国内酒店：30W+以酒店集团为首，对应房型的价格计划（有房态可订的产品数）大概在70W   

     单体酒店：50000+，以三、四、五、线城市单体酒店为主； 

             国内酒店集团：华住、锦江、东呈、亚朵、如家、秋果、格林豪泰、悦容、旅悦、住友、速8集团等

             国际酒店集团：洲际、希尔顿、雅高、香格里拉、凯悦、万豪、温德姆集团等

             红色加力酒店覆盖全国2900个城市，热门城市酒店占比较大。

  星级及占比

          五星级/豪华型：8.71%

          四星级/高档：9.26%

          三星级/舒适：9.41%

          三星以下/经济：72.62%

二、API对接

 我们想先看一下数据，能否先给开一个测试账号？

 您好，待咱们协议签订后，我们会直接开通生产账号&秘钥给到贵司。

 贵司的API接口有频次限制，默认是100/1min，且很多查询的接口都是需要分批查的，比如14万的酒店数据，一次只能查100条，我们一分钟内肯定就超过了100次的接口交互，这个频次可以提升吗？

 不落地库存API查询是在客户有预订需求时实时查询，不用轮询酒店报价。

 按目前的频率，如果出现不够用的情况如何处理？

 频率不是一成不变的，我们有流量监控，会根据流量不定期调整，如果有活动或特殊需求可以沟通申请调整。

 文档里的ratePlanId类型有几处不一致的，是否都为Long类型？

 ratePlanId用String类型，因为我们实时查询的上游，有的ratePlanId是带-的，用long接收会报错。

 我需要自建酒店基础信息库吗？

 一般之前有做过酒店预订的合作商，一般是会沿用他们以前的酒店查询逻辑，把红色加力的酒店ID和他们自己的酒店建立映射关系，在他们查询酒店详情同时会同时请求房仓，丰富酒店的报价；

   页面上实际展示的产品可能包括之前他们自己的产品，和房仓实时返回的产品；

   如果他们原先自有酒店数量比较少，房仓不落地酒店可提供酒店数量比较多，他们之前缺失的酒店，可以按照房仓的酒店信息做新增，并绑定和房仓的酒店关联关系，这样之前没有的酒店也能给客户提供实时的产品报价了。

 酒店图片如果我们不落地的话，直接用贵司的图片地址，如果贵司图片有更新是会删除还是不会删除？

 图片地址是实时获取使用的，无需落地。

 FTP下载账户是否能提供？

 正常情况下图片不用下载，展示的话可以直接使用http。

 房型的窗户信息没有提供？

 基础信息里没有这个字段，一般会在价格计划名称中进行说明，比如特惠（无窗）；

   有些酒店把无窗的房型会独立出来，作为一种房型，这种就是直接在房型名称中体现。所以一种是在价格计划名中展示，一种是在房型名称中展示。

 POI数据（商圈、地标、景点、酒店周边数据）是否能提供？

 我们商业区、行政区信息，主要用于房仓接口查询时参数传递，实际酒店分类查找在房仓系统实现的。如果贵司目前有酒店查询，需要合并多家数据，一般做法是酒店查询逻辑不变，要做酒店映射。

 取了一下国内商圈的数据，发现有几十个商圈CityCode为空，这几个商圈是无效吗？

 这些数据主要是行政区对应的城市编码已经不存在了，建议将返回数据不存在城市编码的过滤掉。另外麻烦将这几个商圈信息发我，我们这边同步维护，谢谢。

 酒店实时产品查询接口中“合作商通过该接口实时查询酒店的售卖信息，最大可查询60天内，自入住日期连续30天的售卖数据”，是否代表用户实际操作中，最多只能预订30天内的房间？

 是的，连续30天内的房间。

 酒店实时产品查询接口-queryProductDetail 返回的早餐，是每日都不同的吗？

 一般情况下，每日早餐数量不同比较少，大部分产品含早和不含早会分开。严密起见，展示时，建议写上首日早；每日详情里提供每天早餐的具体情况。通常情况下，不一样的情况很少，只是我们支持不一样的早餐这种逻辑。

 预订状态 ：2 部分可订， 3 查看 ,请问如何准确界定？3 查看 指定是？

 3 查看，一般是指有预定条款（限制）的，如提前**天可订，但下单时已过预订时限。也就是产品不满足预订条款 ，一般是提前预订或连住这些条件一一查看。

   2 部分可订，表示所选日历期间部分日期可订，部分日期不可订。

 酒店列表页看到的起价为什么在实际售价中看不到？

 针对起价我们每天凌晨会做一次运算，所以有可能会存在起价的房型被订满的情况，或供应商调价等。所以起价仅作为参考。

 我查询11月26日-11月30日的起价和产品实时售价，您这边反馈的是这些天的每日均价还是总价？

 请求多天，返回结果为多天每日价格，页面展示可自己计算均价；详情中可展示具体每天价格。

 售卖信息列表，如果查询的是三天的数据，那返回的数据都会不一样吗？还是只会是日期和价格不一样？

 有可能会不一样，因为我们是多供应商模式。

 售卖信息列表，若查询的是两天的数据，这售卖信息列表对应的应该是两条对吗？会有假如两天这个售卖信息都是一样的，你们只返回一条的可能吗？

 正常来说查几天就有几天的数据，售卖信息一样也会返回两条，如果某天没返回数据就不用展示或者认为这天不可订。

 我们每次刷新页面是只能读取您那边10个酒店吗？

 是的；拉酒店信息每次请求做多10个，但是可以发起多次请求。

 试预订一般有几次？客户提交订单时应该调下单接口还是调试预订接口？

 建议点击“预订”按钮进入预订信息填写页面时进行一次试预订。点提交订单进行下单，客户支付成功调确认支付接口，客户超时未支付调取消订单接口。（建议支付时限设置在15分钟）

 试预订是否代表已经锁定了库存？

 试预订只是询问当前是否可订，不代表锁定了库存（房间），如果支付时间过长，会导致支付后无法确认房间，或变价等场景。

 试预订不代表锁定库存（房间），那回传酒店房态的时效性如何，大概多久？

 一般情况下，试预订时间在6秒内，超过6秒仍未接到试预订返回，建议弹出提示，试预订超时，请重试，这是一种解决方案。客户点重试重新发起试预订。

 在试预订接口里，没有房间的库存数吗？

 是的，只有可订、不可订概念，价格、条款、房态三者，所有数据均是随用随查，实时查询。

   我们的试预订接口，是根据您这边传入的酒店，房型，产品ID，日期和间数，实时查询库存数据的，会判断库存数是否满足传入的条件，并返回可订或者不可订。具体的库存数，会在产品查询接口返回。

 试预订失败原因种的未知异常一般指什么？

 上游涉及各种供应商各种情况，或者我们自己内部上游接口新加了一些异常，未告知下游捕获的，都列为未知。

 CheckBooking返回的数据会不会与queryProductDetail数据不相同？是否会出现上午访问时不能提交订单，而下午就可以提交的情况？

 接口本身没有有效期，但数据是实时在变化的，所以试预订之后不能停留太久才提交订单，建议酒店列表点击预订按钮以及提交订单前都调一次试预订接口。

   比如若用户在酒店列表页面停留超过10分钟没有动作，可以弹窗提示刷新一次页面；

   试预订接口与产品查询接口，会有一定的概率存在不相同的情况，比如直连供应商产品，我们与上游的同步也会有时差，自签产品则不会有。

 我方客人在选择房型后，这边会调用试预订接口，如果不可订，会返回给我们什么信息呢？分为哪几种不可订情况呢？

 试预定接口必接，不可订返回参数参考接口文档。

   即：我们会通过接口返回失败原因，一般情况可根据试预订失败参考原因内容对应展示不同文案，方便用户理解。

 没有返回房态roomStatus的是按无房处理吗？

 房态为空一般按房态待查做相同处理，及客户下单后需要等酒店确认为准。

 如果我调用创建订单接口传的总金额TotalAmount跟所有CreateOrderPriceltem里面的价格总和不一致会出现什么情况？

 会导致下单失败。

 创建订单接口 latestArriveTime最晚到店时间的这个参数，假如是第二天凌晨01:00这个时间的话，直接传入这个01:00 还是怎么处理这种情况？

 latestArriveTime建议传23:00，咱们目前都是预付酒店，预付酒店一般不会取消客户订单；当然若客户预计到店时间超过最晚时间，也可以提前联系酒店告知。

 订单操作推送接口里面的合作商需要向泰坦云提供推送的URL 地址，header 中的requestTyte为orderStatusPush ，这个地址是怎么处理的？

 这个地址是贵司提供的订单确认操作接口地址，我们会调这个接口告知你们订单是否确认，入参和出参要求在接口文档中。

   贵司这个接口开发完成后，请在技术对接群内通知我们，我们会进行配置。

 贵司推送订单状态确认，我们需要线下提供回调地址给到贵司，但是这个接口贵司没有加签名的处理，有一定的安全隐患，有什么处理方式吗？

 订单确认状态推送如果你们要做风险管理可以做IP白名单限制，我们可以提供固定IP。

 提交订单信息后在红色加力这边状态是待支付，支付有时间要求吗，比如要在多长时间内支付才能预订成功？待支付的这段时间里，这个房型是已经锁住的状态吗？

 建议支付时间逻辑设置在30分钟内，超过时长自动取消订单。同时建议前端增加相关提示，以降低订单满房及变价的概率。订单为待支付不代表一定锁住了房间。

 订单支付接口可以给我们想个办法调试吗？我们不能让客户帮忙测。

 这个支付只是贵司通知房仓，这个订单在贵司已经支付了，房仓收到这个通知就会开始处理订单。实际这张订单在贵司那边是否真实给过钱，其实没有影响。

   比如贵司的客户是挂账客户，客户下单不用立刻给钱，下单后就要为客户进行确认，这时贵司也是可以直接通知房仓订单已经支付。

 提交订单时我看API文档里写的是需要合作商预先进行支付，红色加力才会返回是否预订成功的回复。这里面支付是需要合作商垫付吗？还是其他形式？能否帮忙列举一下；

 订单支付接口是合作方确认预订人已付款后，通知红色加力进行订单处理的关键通知节点。

   比如预订人是在线付款的场景，一般客户提交订单时会先生成订单，客户跳转支付页面完成支付后，会调用订单支付接口，通知红色加力订单已支付，开始订单处理。

 贵司确认订单为什么要看我们的支付状态？

 我们需要等贵司确认收到客户款后，即订单调支付接口后才会进行订单确认。

 一般我们调用订单接口的时间大概多久呢，调支付接口时间大概多久呢？

 贵司收款后，即可调订单支付接口通知我司，红色加力获取支付成功结果，才会进行订单的确认操作。

 订单到了支付页面是不是实时回调的？

 贵司调接口，接口实时返回。务必确保贵司订单已经支付，后再调红色加力支付接口通知我们。

 如果提交订单后，超过30分钟未支付，该单在你们平台是否会自动取消,如果这单一直不支付，那会怎么样？

 建议支付时长设为30分钟，超时未支付自动取消订单；时间过长再支付很容易出现满房或变价的情况。

   不会自动取消，这个逻辑在贵司那边设置。首先，一直不支付一直占着这个配额；其次，长时间后客户再支付，满房变价率高。

 订单支付成功后，调用你们下单接口，是否会出现失败的情况？

 会存在失败的可能，比如变价、满房或系统异常情况下。

   变价的情况，看贵司是否接受变价后的价格，可以修改价格后重新下单。满房则表示此房型已经订完，需要更换产品或者其他房型。

   系统异常情况下，可以重试一次，如果再次失败，可以联系我们处理。

 合作商支付成功后红色加力回传是否订单预订成功的时间大概多久？

 我们所有订单都会在支付状态为已支付时进行跟进，一般5分钟内确认率在85%及以上，15分钟内确认旅在95%及以上。

 请问如果这边提交订单后，您系统扣额度的时候，额度不够了，会怎样？预订失败吗？

 额度不够，会影响订单的确认，故建议贵司也同步建立额度预警机制。

 预订失败的可能除了无房之外还有其他的原因吗？

 预订失败原因主要：满房或变价

 系统取消订单后，这个状态会主动回传过来吗，还是需要我们定期调取？订单状态存留多久，比如一周后或一月后还能读到订单状态吗？

 有订单操作推送接口，当房仓确认订单或者拒绝订单时会调用该接口通知贵司，若房仓一定时间未推送，贵司也可主动来拉取。

 房仓的取消政策是什么？如果是提前离店的情况这个钱是怎么扣的？

 不同的产品取消政策不同，

   A. 客人如果要申请取消：

   1）符合取消规则，接口可通过取消，取消成功订单不结算；

   2）不符合取消规则，接口驳回取消申请，可线下联系客服尝试申请取消，结果以客服回复结果为准。

   B. 客人不入住，未申请取消，订单NOSHOW，房费照收不退，订单正常结算。

   客人提前离店，需要来申请。若不申请则默认NOSHOW，房费照收不退的。贵司客服收到客人申请后订单群内同步给红色加力处理，后红色加力会在群里同步订单最终结算金额。

 退改条款是否会出现11.28不退、11.29可退、11.30不退的情况？他们的价格类型是含了退订类型的，要么都是可退，要么都不可退。

 一般很少价格计划一天一个退改政策，大部分产品一个产品的退改政策都是一致的。只是系统支持按日维护退改政策有很特殊的场景会用到，比如旺季的几天不可以退改，平常是可以退改的。

 订单取消会通过订单操作推送接口推送给我们吗？

 A:订单未确认之前，如果取消订单，我们这边会操作拒单后进行推送。

   B:订单确认之后，如果发起取消，满足条款则直接返回取消成功；不满足则不能取消，如有特殊情况需要申请取消只能走线下（双方客服群内）沟通处理。

三、测试流程及规范

 测试要注意哪些规范？

 由于数据在真实环境下，有关所有需要走测试的环节都应遵循以下原则

 （注：如没有按以下规则操作，出现业务风险或产生赔付时，需合作商自行承担相关责任）

 酒店：城市=塔城，酒店名=泰坦塔城测试酒店；

 测试单客户名称一律为中文的“测试”，即客人姓测名试；

 在未得到房仓IT确认同意前（请在工作时间通过微信技术对接群里提前通知房仓IT同事），不允许调用订单支持接口（payorder）；

 只可预订测试当日30天以后或供应商指定日期的房间；

 预定日期非周末法定假期及任何高峰时段；

 下单时间为武汉房仓工作日工作时间内；

 下单申请到取消同日内完成。

 测试一般要测哪些环节？

 所有接口的通畅

   正常业务流程试预订，创建订单，确认订单，取消订单

   支付接口的调用

 确认API订单失败，未知异常，一般是会什么原因？

 建议检查贵司日志或代码逻辑，及是否设置白名单。