【2017年整理】调用hotelBE推荐方案.docVIP

调用HotelBE推荐方案 中国民航信息网络股份有限公司 2010年11月 目录 TOC \o 1-3 \h \z \u HYPERLINK \l _Toc291147261 一 HotelBE查询预订交易流程 PAGEREF _Toc291147261 \h 3 HYPERLINK \l _Toc291147262 二 说明 PAGEREF _Toc291147262 \h 3 HYPERLINK \l _Toc291147263 三 交易环节关键步骤的推荐方案： PAGEREF _Toc291147263 \h 4 HYPERLINK \l _Toc291147264 1、多酒店查询： PAGEREF _Toc291147264 \h 4 HYPERLINK \l _Toc291147265 2、单酒店查询： PAGEREF _Toc291147265 \h 4 HYPERLINK \l _Toc291147266 3、带供应商信息的单酒店查询： PAGEREF _Toc291147266 \h 5 HYPERLINK \l _Toc291147267 4、预订： PAGEREF _Toc291147267 \h 5 HYPERLINK \l _Toc291147268 5、修改： PAGEREF _Toc291147268 \h 5 HYPERLINK \l _Toc291147269 6、其他： PAGEREF _Toc291147269 \h 6 一 HotelBE查询预订交易流程 6.向上游发单渠道TravelHub平台的HotelBE接口上游系统1.多酒店查询：获取酒店信息2 6.向上游发单 渠道 TravelHub平台的HotelBE接口 上游系统 1.多酒店查询：获取酒店信息 2.单酒店查询：获取价格房态等信息 3.含供应商的单酒店查询：获取准确信息 4.去上游查询，获取准确价格房态信息 收集客人信息商的单酒店查询：获取准确信息 5.预订 二 说明 请务必注意:HotelBE是交易接口，我们建议渠道在本地建立自己的酒店信息缓存数据，初步的查询和定位在本地组织，方便进行业务逻辑的控制。在需要获取准确价格、房态等信息时（上图第3步及以后步骤），再通过hotelBE接口进行访问平台。当然我们也支持从第一步开始调用平台接口，但该方式必须遵循平台的数据结构和逻辑，无法订制，并且效率并不高。 由于TravelHub平台上有外部上游直连系统等连接供应商或者酒店集团，所以查询时部分数据将以上游直连返回的数据为准，并且下单时订单价格等敏感信息也将以上游直连系统返回的数据为准。所以我们推荐下面的查询步骤和一些查询条件的设置，以供渠道获取最真实准确的数据，也避免出现查询结果和订单的一些关键数据有不一致的现象。 由于房态、订单特殊要求等问题，可能下单时订单状态为“申请”等。供应商或酒店处理后，订单状态有可能变为“订妥”（房态、特殊要求能够满足等情况）或者“取消”（房态、特殊要求无法满足等情况）。这时需要渠道提供一个通知接口，平台的订单状态更新等，将通过通知接口推送到渠道的系统中。具体内容，请参考通知接口（参考《中国航信酒店平台接口开发指南》2.2.3中描述）。其他一些异步信息也将通过通知接口下推到渠道系统中。 三 交易环节关键步骤的推荐方案： 1、多酒店查询： 根据一些可以确定的查询条件，如目的地城市、入住离店时间、酒店星级等条件，调用多酒店查询指令【TH_ HotelMultiAvailRQ /RS】，获取满足条件的酒店信息列表，信息里含具体的酒店名称、星级、位置、开业时间、最小价格等信息。需要注意的是：请求中的RoomTypeDetailShowed字段，如果置位为Y，则也会返回酒店的具体房型价格等信息，但是该功能必须配合设置分页参数来使用（每页设置的酒店数最好保持在20以内），同时该功能对查询效率影响较大，出于性能考虑，强烈不建议该字段置为Y!新发布接口已经屏蔽该字段，另外后续的变更、更新、维护不会再对该字段进行维护。具体酒店房型、价格等信息可放在单酒店中查询。 2、单酒店查询： 根据多酒店查询结果，或者是渠道自身缓存酒店信息时甄选完酒店后，对客人感兴趣的酒店，可以通过单酒店查询指令【TH_ HotelSingleAvailRQ/RS】进行查询，查询时需传过来酒店代码、入住离店时间等关键信息。返回的结果中可能会有多个供应商提供的数据，如果涉及仅1个上游供应商或酒店的直连系统，该供应商数据将以上游数据为准，其他非直连供应商提供的价格、房态等信息以平台数据为准返回给渠道；如果没有上游直连系统，将完全以平台数据返回；如果有多个上游直连系统，出于性能考虑，将完全以平台数据返回。 3、带供