HotelBE数据缓存接口文档资料

中国航信HotelBE数据缓存接口描述中国民航信息网络股份有限公司2012年3月变更记录DateVersionDescriptionAuthor2010/121.0.0版本发布王贽20.11.城市信息查询,countycode=”ALL”,查询所有国家范云满2.酒店静态信息查询接口说明修改3.酒店数据缓存查询接口说明修改4.地标行政区域查询接口说明修改2010.12.281.0.21.删除订单状态说明王贽2.增加酒店缓存策略说明2011/2/18增加访问地址说明,各指令示例。杨同波2011/2/21修改地标查询输入中类别、城市编码的说明王贽2011/2/21修改地标查询输入中类别的说明王贽2011/2/281.0.3修改所有查询输入输出的<Application>说明；修改地标查王贽询输入中城市代码的说明2011-3-31.1.0酒店静态信息查询缓存：增加返回标签<Province>、王贽<Address>、<PostalCode>、<Tel>、<OpenDate>、<FixMent>、<RoomQuantity>、<Floor>、<Fax>、<District>、<LongDesc>、<Latitude>、<Longitude>、<HotelImages>酒店数据缓存查询：HotelCacheRS标签改为HotelAvailabilityCacheRS，RoomRates标签改为Rates，RoomRate标签改为Rate。Rate标签中增加Payment、GuestType属性新增酒店房型静态缓存查询2011-3-81.1.1酒店房型静态缓存查询增加返回<HotelAmenities>标签王贽2011-3-91.1.2酒店数据缓存查询增加返回<SaleQuota>、<AuthenQuota>王贽标签，修改<Avail>标签内容说明2011-3-161.1.3酒店数据缓存查询返回：Rate的子标签内容修改王贽2011-3-171.2.0酒店数据缓存查询返回:GuaranteePolicy的子标签内容修王贽改;增加新指令：酒店价格计划控制缓存查询TH_RATEPLANCONTROLCACHERQ/RS）2011-3-23 TH_HotelStaticInfoCacheRQ/RS 改名为多酒店静态信息查 王贽询；TH_RoomTypeStaticInfoCacheRQ/RS改名为单酒店静态信息查询；单酒店静态信息查询返回增加 HotelVendors标签2011-4-12 城市信息查询缓存（TH_CityDetailsSearchRQ /RS）输入项 王贽<CountryCode>说明变化；酒 店 价 格 计 划 控 制 缓 存 查 询TH_RATEPLANCONTROLCACHERQ/RS）示例修正2011-04-26 增加 酒店价格计划佣金缓存查 询（TH_王贽RateplanCommCacheRQ/RS）2011-05-031.2.4单酒店静态信息查询TH_RoomTypeStaticInfoCacheRQ/RS王贽返回增加<HotelTrafficInfos>交通信息2011-05-091.2.5酒店数据缓存查询TH_HotelAvailabilityCacheRQ/RS返王贽回RoomQuotas标签更改为QuotasRoomQuota标签更改为Quota2011-5-251.2.6单酒店静态信息查询TH_RoomTypeStaticInfoCacheRQ/RS王贽返回增加<CreditCardInfos>酒店所支持信用卡信息2011-7-211.2.7酒店数据缓存查询TH_HotelAvailabilityCacheRQ/RS返王贽回标签ServiceFee、FeePercent说明修改2011-8-51.2.8TH_RoomTypeStaticInfoCacheRS返回标签CardIssueName增加信王贽用卡对应发卡银行列表2011-9-61.3.0根据业务要求，酒店价格计划佣金缓存查询王贽（TH_RateplanCommCacheRQ/RS）暂停提供2011-11-91.3.1多酒店静态缓存返回TH_HotelStaticInfoCacheRS增加ShortDesc、王贽BrandCode、ChainCode标签2011-11-241.3.2多酒店静态缓存返回TH_HotelStaticInfoCacheRS增加王贽TotalNumber、PageNo标签；多酒店静态缓存请求TH_HotelStaticInfoCacheRQ增加PageNo标签2012-01-91.4.0增加酒店缓存更新查询（TH_UPDATEHOTELSRQ/RS）；王贽酒店数据缓存查询请求TH_HotelAvailabilityCacheRQ增加<Type>、<AuthType>标签；价格计划控制缓存查询请求 TH_RATEPLANCONTROLCACHERQ增加<AuthType>标签；酒店数据缓存查询返回 TH_HotelAvailabilityCacheRS 标签<HotelRoomType>增加属性RatePlanType；价格计划控制缓存查询返回TH_RATEPLANCONTROLCACHERS增加标签<RatePlanType>2012-3-11.4.1TH_LandMarkSearchRQ中地标类别增加HOT：热点地区王贽2012-3-221.5.0增加TH_OfferHotelsRQ、TH_OfferRoomTypesRQ指令；王贽TH_UpdateHotelsRQ/RS指令请求、返回标签<Type>增加“P”，具体见文档说明；“4.0酒店缓存查询策略”中增加新的说明，见标记为今天更细的部分内容；3.8酒店缓存更新查询（TH_UpdateHotelsRQ/RS）增加如下说明：“注意：由于酒店更新信息涉及各个方面，缓存更新查询是以酒店为单位进行更新，可能更新查询会查到有变化的信息，但某些渠道在实际数据查询中未发现变化，这种情况属于正常”2012-3-291.5.1多酒店静态信息查询缓存王贽TH_HotelStaticInfoCacheRQ/RS）返回增加标签<Pysz>酒店拼音首字码</Pysz>目 录变更记录 21概述 52指令格式解析 53通知型指令详析 63.1城市信息查询缓存（ TH_CITYDETAILSSEARCHRQ/RS） 6请求指令： 6返回指令： 7示例XML 83.2地标行政区查询缓存（ TH_LANDMARKSEARCHRQ/RS） 9请求指令： 9返回指令： 10示例 113.3多酒店静态信息查询缓存（ TH_HOTELSTATICINFOCACHERQ/RS） 12请求指令： 12返回指令： 13示例： 153.4酒店数据缓存查询（ TH_HOTELAVAILABILITYCACHERQ/RS） 16请求指令： 16返回指令： 17示例： 203.5单酒店静态信息查询（ TH_ROOMTYPESTATICINFOCACHERQ/RS） 21请求指令： 22返回指令： 22示例： 253.6酒店价格计划控制缓存查询（ TH_RATEPLANCONTROLCACHERQ/RS） 26请求指令： 26返回指令： 27示例： 283.7(该指令因业务原因暂停 )酒店价格计划佣金缓存查询（ TH_RATEPLANCOMMCACHERQ/RS） 29请求指令： 29返回指令： 30示例： 313.8酒店缓存更新查询（ TH_UPDATEHOTELSRQ/RS） 32请求指令： 32返回指令： 333.8.3示例：353.9酒店上下线缓存更新查询（TH_OFFERHOTELSRQ/RS）353.9.1请求指令：363.9.2返回指令：373.9.3示例：383.10房型上下线缓存更新查询（TH_OFFERROOMTYPESRQ/RS）383.10.1请求指令：393.10.2返回指令：393.10.3示例：404.0酒店缓存查询策略415.0关于返回错误425.0.1业务级错误返回425.0.2系统级错误返回42概述该文档描述了 HotelBE数据缓存接口各个指令的含义、具体内容及应用情况。本接口通过 MQ服务提供，为UTF-8编码格式。外部通过 http请求的方式调用 DirectLink服务，目前也遵循 UTF-8编码，如有变更，请遵循 DirectLink编码标准即可。请求的指令为 XML字符串，参数名为 request。DirectLink的访问地址：生产地址： 测试地址：指令格式解析每条指令都包括两部分：请求和返回，都是 XML格式，请求指令以<OTRequest>为根节点（请求中请不要出现单引号和百分号字符），返回指令以

<OTResponse>为根节点。用户可以根据文档及示例程序对

XML串进行解析，本文档将随系统升级而同步升级。 文档中，附有“★”标志的字段为不能为空字段。未声明数据类型均为

,String?

类型，未声明日期格式均为 ,yyyy-MM-dd?未,声明时间格式均为 ,HHMM(1800 表示为下午六点，时分间没有冒号)?，结果为是或否的字段，取值均为是:?Y?，否:?N?,灰色区域以及未注释区域、字段均为保留扩展时使用。指令中，IdentityInfo信息请务必填写完整，office信息务必填写，用户信息如无法确认具体操作人， 可填写入office管理员信息。通知型指令详析3.1城市信息查询缓存（ TH_CityDetailsSearchRQ/RS ）用例：城市信息查询指令描述：查询城市静态信息。用于获取城市代码等信息列表。该指令请求结构遵循 TH_CityDetailsSearchRQ.xsd 文件，返回结构遵循 TH_CityDetailsSearchRS.xsd 文件请求指令：<OTRequest><TransactionName>必填项:指令名称，String类型 固定值 “TH_CityDetailsSearchRQ”★</TransactionName><Header><SessionID>预留字段，不填 String类型</SessionID><Invoker>调用者 String类型</Invoker><Encoding>字符编码 String类型</Encoding><Locale>区域 String类型</Locale><SerialNo>预留字段，不填 String类型</SerialNo><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SSString

类型</TimeStamp><Application>子系统名称 String类型 “availCache”★</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><CityDetailsSearchRQ><CountryCode>所查城市所属国家代码CN:中国String类型;?ALL?查询所有国家;US:美国★</CountryCode><CountryName>预留不填String类型</CountryName></CityDetailsSearchRQ><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 ★</OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE)</BookingChannel></Source></OTRequest>返回指令：关于酒店图片：请在返回的数据前添加服务器地址 “”，如请求返回了数据“链接应为 “ ”

/676/WJ/676WJ01.jpg

”，此<OTResponse><TransactionName>固定值 TH_CityDetailsSearchRS</TransactionName><Header><SessionID>预留字段，不填 </SessionID><Invoker>调用者</Invoker><Encoding>字符编码</Encoding><Locale>区域 </Locale><SerialNo>预留字段，不填 </SerialNo><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SS </TimeStamp><Application>子系统名称 String类型 “availCache”</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>保留字段</UniqueID></DestinationSystemCodes><CityDetailsSearchRS><Success/><Warnings/><CityInfos><CityInfo><CityCode>城市3字码</CityCode><CityName>城市名称</CityName><CityEnglishName>城市英文名</CityEnglishName><CityPinYin>城市名称拼音</CityPinYin><CityPYFW>拼音首字母</CityPYFW><Province>省份名称</Province><CountryCode>国家代码</CountryCode><CountryName>国家</CountryName></CityInfo></CityInfos></CityDetailsSearchRS><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型</OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE) </BookingChannel></Source></OTResponse>示例XML<OTRequest><TransactionName>TH_CityDetailsSearchRQ</TransactionName><Header><SessionID></SessionID><Invoker></Invoker><Encoding></Encoding><Locale></Locale><SerialNo></SerialNo><TimeStamp>2010-12-2813-35-06</TimeStamp><Application>availCache</Application><Language>CN</Language></Header><DestinationSystemCodes><UniqueID></UniqueID></DestinationSystemCodes><CityDetailsSearchRQ><CountryCode>CN</CountryCode><CountryName></CountryName></CityDetailsSearchRQ><IdentityInfo><OfficeID></OfficeID><UserID></UserID><Password></Password><Role></Role></IdentityInfo><Source><OfficeCode></OfficeCode><UniqueID></UniqueID><BookingChannel>HOTELBE</BookingChannel></Source></OTRequest>3.2地标行政区查询缓存（ TH_LandMarkSearchRQ/RS ）用例：地标行政区查询指令描述：该指令用来查询地标行政区等信息。该指令请求结构遵循 TH_LandMarkSearchRQ.xsd文件，返回结构遵循TH_LandMarkSearchRS.xsd文件请求指令：<OTRequest><TransactionName>必填项:指令名称，String类型 固定值 “TH_LandMarkSearchRQ”★</TransactionName><Header><SessionID>预留字段，不填 String类型</SessionID><Invoker>调用者 String类型</Invoker><Encoding>字符编码 String类型</Encoding><Locale>区域 String类型</Locale><SerialNo>预留字段，不填 String类型</SerialNo><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SSString

类型</TimeStamp><Application>子系统名称 String类型 “availCache”★</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><LandMarkSearchRQ><Category>类型。POR：地标信息，<CountryCode>所查城市所属国家代码

DST：行政区信息；不填默认为中国

TRA：交通信息；,ALL为查询所有国家

SGT：周围景观；HOT：热点地区。String类型 </CountryCode>

String类型

</Category><CountryName>预留 不填 String类型 </CountryName><cityCode>城市code必填项★</cityCode></LandMarkSearchRQ><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 ★</OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE)</BookingChannel></Source></OTRequest>返回指令：<OTResponse><TransactionName>固定值 TH_LandMarkSearchRS</TransactionName><Header><SessionID>预留字段，不填 </SessionID/><Invoker>调用者</Invoker/><Encoding>字符编码</Encoding/><Locale>区域 </Locale/><SerialNo>预留字段，不填 </SerialNo/><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SS </TimeStamp/><Application>子系统名称 String类型 “availCache”</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><LandMarkSearchRS><Success/><Warnings/><LandMarks><LandMarkInfo><CityCode>城市3字码</CityCode><CityName>城市名称</CityName><LandMarkName>地标或行政区名称 </LandMarkName><Category>类别POR:地标；DST：行政区；TRA：交通信息；SGT：周围景观</Category><CountryCode>国家代码</CountryCode><CountryName>预留,国家</CountryName><Lantitude>预留,纬度</Lantitude><Longitude>预留,经度</Longitude><Hotels>该区域酒店code队列</Hotels></LandMarkInfo></LandMarks></LandMarkSearchRS><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 </OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE) </BookingChannel></Source></OTResponse>示例<OTRequest><TransactionName>TH_LandMarkSearchRQ</TransactionName><Header><SessionID></SessionID><Invoker></Invoker><Encoding></Encoding><Locale></Locale><SerialNo></SerialNo><TimeStamp>2010-12-2813:00:44</TimeStamp><Application>availCache</Application><Language>CN</Language></Header><DestinationSystemCodes><UniqueID></UniqueID></DestinationSystemCodes><LandMarkSearchRQ><Category>POR</Category><CountryCode>CN</CountryCode><CountryName></CountryName><cityCode>XMN</cityCode></LandMarkSearchRQ><IdentityInfo><OfficeID></OfficeID><UserID></UserID><Password></Password><Role></Role></IdentityInfo><Source><OfficeCode></OfficeCode><UniqueID></UniqueID><BookingChannel>HOTELBE</BookingChannel></Source></OTRequest>3.3 多酒店静态信息查询缓存（ TH_HotelStaticInfoCacheRQ/RS ）用例：多酒店静态信息查询指令描述：该指令用来查询酒店基本信息。该指令请求结构遵循 TH_HotelStaticInfoCacheRQ.xsd 文件，返回结构遵循TH_HotelStaticInfoCacheRS.xsd 文件请求指令：<OTRequest><TransactionName>必填项:指令名称，String类型 固定值 “TH_HotelStaticInfoCacheRQ”★</TransactionName><Header><SessionID>预留字段，不填 String类型</SessionID><Invoker>调用者 String类型</Invoker><Encoding>字符编码 String类型</Encoding><Locale>区域 String类型</Locale><SerialNo>预留字段，不填 String类型</SerialNo><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SSString

类型</TimeStamp><Application>子系统名称 String类型 “availCache”★</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><HotelStaticInfoCacheRQ><HotelStaticInfoCacheCriteria><HotelCode>预留,不填,酒店编码 String类型<HotelName>预留,不填,酒店名称，模糊匹配<HotelEnglishName>预留,不填,酒店英文名称

</HotelCode>String类型 </HotelName>String类型 </HotelEnglishName><CityCode>城市代码 String类型 </CityCode><CityName>预留,不填,城市名称 String类型 </CityName><Rank>预留,不填,酒店星级 String类型 </Rank><CountryCode>国家代码 不填默认为中国 String类型 </CountryCode><PageNo>所查询的页面代码，阿拉伯数字，不填默认为第一页，每页返回

700家酒店数据

</PageNo></HotelStaticInfoCacheCriteria></HotelStaticInfoCacheRQ><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 ★</OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE)</BookingChannel></Source></OTRequest>*country

为空,city不为空,返回中国的对应的 (citycode)的酒店信息country为空,city为空,返回中国所有的酒店信息country不为空,city为空返回country对应的酒店信息country不为空,city不为空返回country对应的(citycode)的酒店信息返回指令：<OTResponse><TransactionName>固定值 TH_HotelStaticInfoCacheRS</TransactionName><Header><SessionID>预留字段，不填 </SessionID/><Invoker>调用者</Invoker/><Encoding>字符编码</Encoding/><Locale>区域 </Locale/><SerialNo>预留字段，不填 </SerialNo/><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SS </TimeStamp/><Application>子系统名称 String类型 “availCache”</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><HotelStaticInfoCacheRS><Success/><Warnings/><TotalNumber>所查询得到的总酒店数 </TotalNumber><PageNo>所查询的页面代码，阿拉伯数字，每页返回 700家酒店数据 </PageNo><HotelStaticInfos><HotelStaticInfo><HotelName>酒店名称</HotelName><HotelEnglishName>酒店英文名称</HotelEnglishName><HotelCode>酒店代码</HotelCode><Rank>酒店星级</Rank><CityCode>所在城市3字码</CityCode><CityName>国家</CityName><CountryCode>国家代码</CountryCode><Province>省</Province><Address>地址</Address><PostalCode>邮编</PostalCode><Tel>电话</Tel><OpenDate>开业时间</OpenDate><FixMent>装修时间</FixMent><RoomQuantity>房间数量</RoomQuantity><Floor>楼层数</Floor><Fax>传真</Fax><District>行政区</District><LongDesc>简介</LongDesc><ShortDesc>简单描述</ShortDesc><BrandCode>品牌id</BrandCode><ChainCode>连锁id</ChainCode><Latitude>纬度</Latitude><Longitude>经度</Longitude><Pysz>酒店拼音首字码 </Pysz><HotelImages>图片信息列表<HotelImage>图片信息<HotelCode>酒店代码</HotelCode><Category>图片类别代码，解释见“图片类别描述” </Category><Url>url地址</Url><Descp>图片类别描述 </Descp></HotelImage></HotelImages></HotelStaticInfo></HotelStaticInfos></HotelStaticInfoCacheRS><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 </OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE) </BookingChannel></Source></OTResponse> 示例：<OTRequest><TransactionName>TH_HotelStaticInfoCacheRQ</TransactionName><Header><SessionID></SessionID><Invoker></Invoker><Encoding></Encoding><Locale></Locale><SerialNo></SerialNo><TimeStamp>2010-12-2812:00:00</TimeStamp><Application>availCache</Application><Language>CN</Language></Header><DestinationSystemCodes><UniqueID></UniqueID></DestinationSystemCodes><HotelStaticInfoCacheRQ><HotelStaticInfoCacheCriteria><HotelCode>SOHOTO10959</HotelCode><HotelName></HotelName><HotelEnglishName></HotelEnglishName><CityCode>PEK</CityCode><CityName></CityName><Rank></Rank><CountryCode>CN</CountryCode></HotelStaticInfoCacheCriteria></HotelStaticInfoCacheRQ><IdentityInfo><OfficeID></OfficeID><UserID></UserID><Password></Password><Role></Role></IdentityInfo><Source><OfficeCode></OfficeCode><UniqueID></UniqueID><BookingChannel>HOTELBE</BookingChannel></Source></OTRequest>3.4 酒店数据缓存查询（ TH_HotelAvailabilityCacheRQ/RS ）用例：酒店数据缓存查询指令描述：该指令用来查询酒店数据缓存信息。该指令请求结构遵循 TH_HotelAvailabilityCacheRQ.xsd 文件，返回结构遵循TH_HotelAvailabilityCacheRS.xsd 文件请求指令：<OTRequest><TransactionName>必填项:指令名称，String类型 固定值 “TH_HotelAvailabilityCacheRQ ”★</TransactionName><Header><SessionID>预留字段，不填 String类型</SessionID><Invoker>调用者 String类型</Invoker><Encoding>字符编码 String类型</Encoding><Locale>区域 String类型</Locale><SerialNo>预留字段，不填 String类型</SerialNo><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SSString 类型</TimeStamp><Application>子系统名称 String类型 “availCache”★</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><HotelAvailabilityCacheRQ ><HotelAvailabilityCacheCriteria ><DateRange>从即日起查询之后多久的数据。现在为查询三个月(3M)</DateRange><HotelCode>酒店代码String类型,必填</HotelCode><RoomType>预留 不填,房型代码<Vendor>预留 不填 </Vendor><RatePlan>预留 不填</RatePlan>

String类型

</RoomType><Type>指定查询内容类别，“

R”只查询价格信息（无配额、政策信息）；“

Q”只查询配额信息（无价格、政策信息）；“

P”只查询政策信息（无价格、配额信息）；不填：查全部信息

</Type><AuthType>指定查询内容的授权级别，“U”：只查询授权给所有用户的公布价格计划相关内容（不返回仅授权给当前代理的私有协议价格计划相关内容）；“P”：只查询授权给当前代理的私有协议价格计划相关内容（不返回授权给所有用户的公布价格计划相关内容）；不填或“A”：查询当前代理可以得到的所有价格计划相关内容 </AuthType></HotelAvailabilityCacheCriteria></HotelAvailabilityCacheRQ ><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 ★</OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE)</BookingChannel></Source></OTRequest>返回指令：<OTResponse><TransactionName>固定值

TH_HotelAvailabilityCacheRS

</TransactionName><Header><SessionID>

预留字段，不填

</SessionID/><Invoker>调用者</Invoker/><Encoding>字符编码</Encoding/><Locale>区域 </Locale/><SerialNo>预留字段，不填 </SerialNo/><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SS </TimeStamp/><Application>子系统名称 String类型 “availCache”</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><HotelAvailabilityCacheRS><Success/><Warnings/><HotelRoomTypes><HotelRoomTypeHotelCode="酒店代码"RoomType="房型代码"Vendor="供应商代码"RatePlan="价格计划代码"RatePlanType="价格计划类型，为空或“BAR”表示公布价格计划，“COR”表示私有协议价格计划"><Rates><RateHotelCode="酒店代码"RoomTypeCode="房型代码"VendorCode="供应商代码"RatePlanCode="价格计划代码"RatePlanName="价格计划名称"RoomTypeName="房型名称"RoomTypeEnName="房型英文名称"VendorName="供应商名称"StartDate="开始日期"EndDate="结束日期"Payment="支付方式"('T':现付；'S':代付；'Y'预付)GuestType="内宾D，外宾F，A空则标示通用价"><ChainCode>保留</ChainCode><FreeMeal>免费餐食，-1表示“有早”但不确定具体数目 </FreeMeal><AmountPrice>销售价，税前价格 +其他费用（如服务费、税） </AmountPrice><<Currency>>货币代码</<Currency>><AmountBeforeTax>税前价格(返佣价)</AmountBeforeTax><DisplayPrice>门市价格</DisplayPrice><FeePercent>服务费百分比</FeePercent><ServiceFee>服务费固定值</ServiceFee></Rate></Rates><Quotas><QuotaHotelCode="酒店代码"RoomTypeCode="房型代码"VendorCode="供应商代码"RatePlanCode="价格计划代码"RatePlanName="价格计划名称"RoomTypeName="房型名称"RoomTypeEnName="房型英文名称"VendorName="供应商名称"Date="日期"><Avail>可用配额数， 0为申请</Avail><SaleQuota>已售配额数</SaleQuota><AuthenQuota>总售配额数</AuthenQuota></Quota></Quotas><Policies><CancelPolicies>

取消政策集合<CancelPolicyStartDate="开始日期"EndDate="结束日期"><Status>状态 是否可用</Status><ShortDesc>简要描述</ShortDesc><LongDesc>详细描述</LongDesc><PeriodDate1>距离入住日期的天数在 0到该日期之间需遵循 UnitOfFee1 和FeeValue1的值</PeriodDate1><PeriodDate2>距离入住日期的天数在 PeriodDate1到该日期之间需遵循 UnitOfFee2 和FeeValue2的值</PeriodDate2><PeriodDate3>距离入住日期的天数在 PeriodDate2到该日期之间需遵循 UnitOfFee2 和FeeValue2的值</PeriodDate3><UnitOfFee1>收费具体值，如百分比额度等 </UnitOfFee1><UnitOfFee2>收费具体值，如百分比额度等 </UnitOfFee2><UnitOfFee3>收费具体值，如百分比额度等 </UnitOfFee3><FeeValue1>收费具体值，如百分比额度等 </FeeValue1><FeeValue2>收费具体值，如百分比额度等 </FeeValue2><FeeValue3>收费具体值，如百分比额度等 </FeeValue3></CancelPolicy><CancelPolicies><GuaranteePolicies>担保政策集合<GuaranteePolicyStartDate="开始日期"EndDate="结束日期"><Status>状态 是否可用</Status><GuaranteeType>担保类型(信用卡担保：

CRED，公司担保：

COMP

；P：预付；

M：客人联系方式担保

)

担保政策展示给用户在预订前需要担保的时间段内进行预订需要向酒店或供应商提供担保信息（公司担保、信用卡担保），或者需要提交客人联系方式（客人联系方式担保），或者需要采用预付的支付方式进行支付。</GuaranteeType><GuaranteeMethod>担保方式，有 Arrival/Stay/Room 三个值。Arrival：代表对提前预订需提供担保，主要参考 GuaranteeDate 、GuaranteeDate2 、GuaranteeDate3 。如果存在 3个时间点（即 GuaranteeDate 、GuaranteeDate2 、GuaranteeDate3 全都有大于 0的值），则提前预订天数在【 GuaranteeDate ，GuaranteeDate2)期间，如果到店时间在 HoldTime 之后到店的，需要提供收费单位为 UniOfFee、值为FeeValue 的担保；提前预订天数在【 GuranteeDate2,GuranteeDate3) 期间的，如果到店时间在

HoldTime2

之后到店的，需要提供收费单位为

UniOfFee2

、值为

FeeValue2

的担保；提前预订天数大于等于

GuranteeDate3

时，如果到店时间在HoldTime3

之后到店的，需提供收费单位为

UniOfFee3

、值为

FeeValue3

的担保。如果存在 2个时间点（即 GuaranteeDate 、GuaranteeDate2 有大于HoldTime 之后到店的，需要提供收费单位为 UniOfFee、值为FeeValue的，需要提供收费单位为 UniOfFee2、值为FeeValue2 的担保。

0的值），则提前预订天数在【的担保；提前预订天数大于等于

GuaranteeDateGuranteeDate2

，GuaranteeDate2)的，如果到店时间在

期间，如果到店时间在HoldTime2 之后到店如果只存在

1个时间点，则提前预订天数大于

GuaranteeDate

的，如果到店时间在

HoldTime

之后到店的，需要提供收费单位为

UniOfFee

、值为

FeeValue

的担保。Stay：代表对连住需提供担保，主要参考如果存在 3个连住天数（即 DaysOfStay

DaysOfStay、DaysOfStay2 、DaysOfStay3 ；、DaysOfStay2 、DaysOfStay3 都有大于 0的值），连住天数在【

DaysOfStay,DaysOfStay2)

之间的，如果到店时间在HoldTime

之后到店的，需要提供收费单位为

UniOfFee

、值为

FeeValue

的担保；连住天数在【

DaysOfStay2,DaysOfStay3)

之间的，如果到店时间在

HoldTime2

之后到店的，需要提供收费单位为 UniOfFee2、值为FeeValue2 的担保；提前入住天数大于等于 DaysOfStay3 时，如果到店时间在 HoldTime3 之后到店的，需提供收费单位为 UniOfFee3、值为 FeeValue3 的担保。如果存在 2个连住天数（即 DaysOfStay 、DaysOfStay2 都有大于 0的值），连住天数在【 DaysOfStay,DaysOfStay2) 之间的，如果到店时间在 HoldTime 之后到店的，需要提供收费单位为 UniOfFee、值为FeeValue 的担保；连住天数大于等于 DaysOfStay2 的，如果到店时间在 HoldTime2 之后到店的，需要提供收费单位为UniOfFee2、值为FeeValue2的担保。如果存在

1个连住天数（即

DaysOfStay

有大于

0的值），连住天数大于等于

DaysOfStay

的，如果到店时间在

HoldTime

之后到店的，需要提供收费单位为

UniOfFee

、值为

FeeValue

的担保。Room：代表对房间数达到一定量需要提供担保，主要参考 NumOfRoom,NumOfRoom2,NumOfRoom3 。如果存在 3个房间数（即NumOfRoom,NumOfRoom2,NumOfRoom3 都大于0），入住房间数在【NumOfRoom,NumOfRoom2)

之间的，如果到店时间在

HoldTime之后到店的，需要提供收费单位为

UniOfFee

、值为

FeeValue

的担保；入住房间数在【

NumOfRoom2,NumOfRoom3)

之间的，如果到店时间在

HoldTime2

之后到店的，需要提供收费单位为 UniOfFee2、值为

FeeValue2

的担保；入住房间数大于等于

NumOfRoom3

的，如果到店时间在

HoldTime3

之后到店的，需提供收费单位为UniOfFee3、值为FeeValue3的担保。如果存在

2个房间数（即

NumOfRoom,NumOfRoom2

都大于

0），入住房间数在【

NumOfRoom,NumOfRoom2)

之间的，如果到店时间在

HoldTime

之后到店的，需要提供收费单位为

UniOfFee

、值为

FeeValue

的担保；入住房间数大于等于

NumOfRoom2

的，如果到店时间在

HoldTime2

之后到店的，需要提供收费单位为UniOfFee2、值为FeeValue2的担保。如果存在1个房间数，入住房间数大于等于 NumOfRoom 的，如果到店时间在 HoldTime之后到店的，需要提供收费单位为 UniOfFee、值为FeeValue的担保。</GuaranteeMethod><ShortDesc>简要描述</ShortDesc><LongDesc>详细描述</LongDesc><GuaranteeDate>提前预订天数，在GuaranteeMethod为Arrival时起作用</GuaranteeDate><GuaranteeDate2>提前预订天数，在GuaranteeMethod为Arrival时起作用</GuaranteeDate2><GuaranteeDate3>提前预订天数，在GuaranteeMethod为Arrival时起作用</GuaranteeDate3><UnitOfFee>收费单位（RN间夜、CNY人民币、PS百分比）</UnitOfFee><UnitOfFee2>收费单位（RN间夜、CNY人民币、PS百分比）</UnitOfFee2><UnitOfFee3>收费单位（RN间夜、CNY人民币、PS百分比）</UnitOfFee3><FeeValue>收费具体值，如百分比额度等</FeeValue><FeeValue2>收费具体值，如百分比额度等 </FeeValue2><FeeValue3>收费具体值，如百分比额度等 </FeeValue3><HoldTime>担保时限，到店时间晚于该时间需要担保<HoldTime2>担保时限，到店时间晚于该时间需要担保

</HoldTime></HoldTime2><HoldTime3>担保时限，到店时间晚于该时间需要担保</HoldTime3><DaysOfStay>入住天数，在GuaranteeMethod为Stay时起作用</DaysOfStay><DaysOfStay2>入住天数，在GuaranteeMethod为Stay时起作用</DaysOfStay2><DaysOfStay3>入住天数，在GuaranteeMethod为Stay时起作用</DaysOfStay3><NumOfRoom>入住房间数，在GuaranteeMethod为Room时起作用</NumOfRoom><NumOfRoom2>入住房间数，在GuaranteeMethod为Room时起作用</NumOfRoom2><NumOfRoom3>入住房间数，在GuaranteeMethod为Room时起作用</NumOfRoom3></GuaranteePolicy><GuaranteePolicies><BookingPolicies>预订政策集合<BookingPolicyStartDate="开始日期"EndDate="结束日期"><Status>状态 是否可用</Status><ShortDesc>简要描述</ShortDesc><LongDesc>详细描述</LongDesc></BookingPolicy><BookingPolicies><FavourPolicies>优惠政策集合<FavourPolicyStartDate="开始日期"EndDate="结束日期"><Status>状态 是否可用</Status><ShortDesc>简要描述</ShortDesc><LongDesc>详细描述</LongDesc></FavourPolicy><FavourPolicies></Policies></HotelRoomType></HotelRoomTypes></HotelAvailabilityCacheRS><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 </OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE) </BookingChannel></Source></OTResponse> 示例：<OTRequest><TransactionName>TH_HotelAvailabilityCacheRQ</TransactionName><Header><SessionID></SessionID><Invoker></Invoker><Encoding></Encoding><Locale></Locale><SerialNo></SerialNo><TimeStamp>2010-12-2812:00:00</TimeStamp><Application>availCache</Application><Language>CN</Language></Header><DestinationSystemCodes><UniqueID></UniqueID></DestinationSystemCodes><HotelAvailabilityCacheRQ><HotelAvailabilityCacheCriteria><DateRange></DateRange><HotelCode>SOHOTO6390</HotelCode><RoomType></RoomType><Vendor></Vendor><RatePlan></RatePlan></HotelAvailabilityCacheCriteria></HotelAvailabilityCacheRQ><IdentityInfo><OfficeID></OfficeID><UserID></UserID><Password></Password><Role></Role></IdentityInfo><Source><OfficeCode>HOTELBE</OfficeCode><UniqueID></UniqueID><BookingChannel>HOTELBE</BookingChannel></Source></OTRequest>3.5单酒店静态信息查询（ TH_RoomTypeStaticInfoCacheRQ/RS ）用例：单酒店静态信息查询指令描述：根据酒店 id，查询酒店的所有可用房型、供应商、服务，返回房型、供应商、服务等静态信息请求指令：<OTRequest><TransactionName>必填项:指令名称，String类型 固定值 “TH_RoomTypeStaticInfoCacheRQ”★</TransactionName><Header><SessionID>预留字段，不填 String类型</SessionID><Invoker>调用者 String类型</Invoker><Encoding>字符编码 String类型</Encoding><Locale>区域 String类型</Locale><SerialNo>预留字段，不填 String类型</SerialNo><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SSString 类型</TimeStamp><Application>子系统名称 String类型 “availCache”★</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><HotelRoomTypeStaticInfoCacheRQ><HotelRoomTypeStaticInfoCacheCriteria ><HotelCode>酒店代码 String类型,必填 ★</HotelCode></HotelRoomTypeStaticInfoCacheCriteria></HotelRoomTypeStaticInfoCacheRQ><IdentityInfo><OfficeID>代理Office号★</OfficeID><UserID>用户名 ★</UserID><Password>用户密码 ★</Password><Role>角色</Role></IdentityInfo><Source><OfficeCode>代理Office号String类型 ★</OfficeCode><UniqueID>String</UniqueID><BookingChannel>预定渠道代码(默认填写:HOTELBE)</BookingChannel></Source></OTRequest>返回指令：<OTResponse><TransactionName>固定值 TH_RoomTypeStaticInfoCacheRS</TransactionName><Header><SessionID>预留字段，不填 </SessionID/><Invoker>调用者</Invoker/><Encoding>字符编码</Encoding/><Locale>区域 </Locale/><SerialNo>预留字段，不填 </SerialNo/><TimeStamp>时间戳 YYYY-mm-DDHH:MM:SS </TimeStamp/><Application>子系统名称 String类型 “availCache”</Application><Language>语言标识 默认为”CN”</Language></Header><DestinationSystemCodes><UniqueID>String</UniqueID></DestinationSystemCodes><HotelRoomTypeStaticInfoCacheRS><Success/><Warnings/><HotelRoomTypeStaticInfo><HotelCode>酒店id</HotelCode><RoomTypeStaticInfos>酒店房型静态信息列表<RoomTypeStaticInfo>酒店房型静态信息<HotelCode>酒店id</HotelCode><RoomTypeCode>房型id</RoomTypeCode><InvStatus>保留值</InvStatus><NoSmoking>是否无烟 “Y”是；“N”否</NoSmoking><BedType>床型</BedType><TotalNumber>房间总量</TotalNumber><Floor>楼层</Floor><RoomArea>房间面积</RoomArea><MaxAddBed>最大加床数量</MaxAddBed><Descp>描述</Descp><Orientation>朝向</Orientation><InvType>房型名称</InvType><Category>房型种类(经济BUD标准STA豪华DEL舒适SUI行政ADM商务BIS)</Category><RoomView>房型景观(海景，山景)</RoomView><MaxGuestNum>最大入住客人数目</MaxGuestNum><Internet>'Y'可上网</Internet><EnInvType>房型英文名称 </EnInvType><BedArea>床面积</BedArea></RoomTypeStaticInfo></RoomTypeStaticInfos><HotelAmenities>酒店设施信息列表<HotelAmenity>酒店设施信息<AmenityName>设施名称</AmenityName><AmenityStatuse>是否可用“Y”是；“N”否</AmenityStatus><AmenityType>设施类别 “CAT”：餐饮；“ REC”：休闲娱乐；“ SER”：服务</AmenityType></HotelAmenity></HotelAmenities><HotelVendors>酒店供应商信息列表<HotelVendor>酒店供应商信息<VendorCode>供应商代码</VendorCode><VendorPromotionCode>供应商推荐级别（按数字字母的自然升序规则排序）</VendorPromotionCode><VendorPromotionRemark>供应商推荐语</VendorPromotionRemark><VendorPromotionPicURL>供应商推荐图片链接 </Vend