开放文档

红色加力库存API常用FAQ

 

一、商务侧


箭头.png 红色加力资源介绍

 星星20+20.png国内酒店:30W+以酒店集团为首,对应房型的价格计划(有房态可订的产品数)大概在70W

 星星20+20.png已对接的连锁酒店资源分别有:锦江、华住、铂涛、亚朵、如家、维也纳、格林豪泰、住友、速8集团等

 星星20+20.png红色加力酒店覆盖全国2000个城市,热门城市酒店占比较大。

 星星20+20.png星级及占比

   五星级/豪华型:8.71%

   四星级/高档:9.26%

   三星级/舒适:9.41%

   三星以下/经济:72.62%

 

 

二、API对接


箭头.png 我们想先看一下数据,能否先给开一个测试账号?

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

 

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

勾勾20+20.png 不落地库存API查询是在客户有预订需求时实时查询,不用轮询酒店报价。

 

箭头.png 按目前的频率,如果出现不够用的情况如何处理?

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

 

箭头.png 文档里的ratePlanId类型有几处不一致的,是否都为Long类型?

勾勾20+20.png ratePlanId用String类型,因为我们实时查询的上游,有的ratePlanId是带-的,用long接收会报错。

 

箭头.png 我需要自建酒店基础信息库吗?

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

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

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

 

箭头20+20.png 酒店图片如果我们不落地的话,直接用贵司的图片地址,如果贵司图片有更新是会删除还是不会删除?

勾勾20+20.png 图片地址是实时获取使用的,无需落地。

 

箭头.png FTP下载账户是否能提供?

勾勾20+20.png 正常情况下图片不用下载,展示的话可以直接使用http。

 

箭头.png 房型的窗户信息没有提供?

勾勾20+20.png 基础信息里没有这个字段,一般会在价格计划名称中进行说明,比如特惠(无窗);

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

 

箭头.png POI数据(商圈、地标、景点、酒店周边数据)是否能提供?

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

 

箭头.png 取了一下国内商圈的数据,发现有几十个商圈CityCode为空,这几个商圈是无效吗?

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

 

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

勾勾20+20.png 是的,连续30天内的房间。

 

箭头.png 酒店实时产品查询接口-queryProductDetail 返回的早餐,是每日都不同的吗?

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

 

箭头.png 预订状态 2 部分可订, 3 查看 ,请问如何准确界定?3 查看 指定是?

勾勾20+20.png 3 查看,一般是指有预定条款(限制)的,如提前**天可订,但下单时已过预订时限。也就是产品不满足预订条款 ,一般是提前预订或连住这些条件一一查看

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

 

箭头.png 酒店列表页看到的起价为什么在实际售价中看不到?

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

 

箭头.png 我查询11月26日-11月30日的起价和产品实时售价,您这边反馈的是这些天的每日均价还是总价?

勾勾20+20.png 请求多天,返回结果为多天每日价格,页面展示可自己计算均价;详情中可展示具体每天价格。

 

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

勾勾20+20.png 有可能会不一样,因为我们是多供应商模式。

 

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

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

 

箭头.png 我们每次刷新页面只能读取您那边10个酒店

勾勾20+20.png 是的;拉酒店信息每次请求做多10个,但是可以发起多次请求。

 

箭头.png 试预订一般有几次?客户提交订单时应该调下单接口还是调试预订接口?

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

 

箭头.png 试预订是否代表已经锁定了库存?

勾勾20+20.png 试预订只是询问当前是否可订,不代表锁定了库存(房间),如果支付时间过长,会导致支付后无法确认房间,或变价等场景。

 

箭头.png 试预订不代表锁定库存(房间),那回传酒店房态的时效性如何,大概多久?

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

 

箭头.png 在试预订接口里,没有房间的库存数吗?

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

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

 

箭头.png 试预订失败原因种的未知异常一般指什么?

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

 

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

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

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

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

 

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

勾勾20+20.png 试预定接口必接,不可订返回参数参考接口文档。

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

 

箭头.png 没有返回房态roomStatus的是按无房处理吗?

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

 

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

勾勾20+20.png 会导致下单失败。

 

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

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

 

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

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

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

 

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

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

 

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

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

 

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

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

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

 

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

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

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

 

箭头.png 贵司确认订单为什么要看我们的支付状态?

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

 

箭头.png 一般我们调用订单接口的时间大概多久呢,调支付接口时间大概多久呢?

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

 

箭头.png 订单到了支付页面是不是实时回调的?

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

 

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

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

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

 

箭头.png 订单支付成功后,调用你们下单接口,是否会出现失败的情况?

勾勾20+20.png 会存在失败的可能,比如变价、满房或系统异常情况下。

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

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

 

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

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

 

箭头.png 请问如果这边提交订单后,您系统扣额度的时候,额度不够了,会怎样?预订失败吗?

勾勾20+20.png 额度不够,会影响订单的确认,故建议贵司也同步建立额度预警机制。

 

箭头.png 预订失败的可能除了无房之外还有其他的原因吗?

勾勾20+20.png 预订失败原因主要:满房或变价

 

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

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

 

箭头.png 房仓的取消政策是什么?如果是提前离店的情况这个钱是怎么扣的?

勾勾20+20.png 不同的产品取消政策不同,

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

   1)符合取消规则,接口可通过取消,取消成功订单不结算;

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

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

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

 

箭头.png 退改条款是否会出现11.28不退、11.29可退、11.30不退的情况?他们的价格类型是含了退订类型的,要么都是可退,要么都不可退。

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

 

箭头.png 订单取消会通过订单操作推送接口推送给我们吗?

勾勾20+20.png A:订单未确认之前,如果取消订单,我们这边会操作拒单后进行推送。

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

 

 

 

三、测试流程及规范


箭头.png 测试要注意哪些规范?

勾勾20+20.png 由于数据在真实环境下,有关所有需要走测试的环节都应遵循以下原则

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

黑点20+20.png 酒店:城市=塔城,酒店名=泰坦塔城测试酒店;

黑点20+20.png 测试单客户名称一律为中文的“测试”,即客人姓测名试;

黑点20+20.png 在未得到房仓IT确认同意前(请在工作时间通过微信技术对接群里提前通知房仓IT同事),不允许调用订单支持接口(payorder);

黑点20+20.png 只可预订测试当日30天以后或供应商指定日期的房间;

黑点20+20.png 预定日期非周末法定假期及任何高峰时段;

黑点20+20.png 下单时间为武汉房仓工作日工作时间内;

黑点20+20.png 下单申请到取消同日内完成。

 

箭头.png 测试一般要测哪些环节?

勾勾20+20.png 所有接口的通畅

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

   支付接口的调用

 

箭头.png 确认API订单失败,未知异常,一般是会什么原因?

勾勾20+20.png 建议检查贵司日志或代码逻辑,及是否设置白名单。


商务合作
18221139396 许壮
13911276325 王薇
18601214155 刘国俊
13413166062 刘剑程
18200427511 蒋雨晗
zhuang.xu@fangcang.com
tracy.wang@fangcang.com
guojun.liu@fangcang.com
jiancheng.liu@fangcang.com
yuhan.jiang@fangcang.com
深圳 | 龙华新区创业花园188栋向荣商务大厦1302
上海 | 杨浦区霍山路398号光大安石中心T2栋3楼
武汉 | 青山区工业一路印力中心12楼1209-1210
北京 | 朝阳区望京科技园E座一层
技术支持
13543309695 王峰
feng.wang@fangcang.com
电话
客服
027-59760846
结算
027-86513066
HR
0755-2100 9650
微信
微信小程序
微信公众号
版权所有Copyright © 2020 红色加力 鄂ICP备18020199号