HotelBE数据缓存接口文档资料.docx

酒店数据缓存查询：

HotelCacheRS标签改为HotelAvailabilityCacheRS，RoomRates标签改为Rates，RoomRate标签改为Rate。

Rate标签中增加Payment、GuestType属性

新增酒店房型静态缓存查询

王贽

2011-3-8

1.1.1

酒店房型静态缓存查询增加返回标签

王贽

2011-3-9

1.1.2

酒店数据缓存查询增加返回、标签，修改标签内容说明

王贽

2011-3-16

1.1.3

酒店数据缓存查询返回：

Rate的子标签内容修改

王贽

2011-3-17

1.2.0

酒店数据缓存查询返回:

GuaranteePolicy的子标签内容修改;

增加新指令：

酒店价格计划控制缓存查询（TH_RATEPLANCONTROLCACHERQ/RS）

王贽

2011-3-23

1.2.1

TH_HotelStaticInfoCacheRQ/RS改名为多酒店静态信息查询；

TH_RoomTypeStaticInfoCacheRQ/RS改名为单酒店静态信息查询；

单酒店静态信息查询返回增加HotelVendors标签

王贽

2011-4-12

1.2.2

城市信息查询缓存（TH_CityDetailsSearchRQ/RS）输入项说明变化；

酒店价格计划控制缓存查询（TH_RATEPLANCONTROLCACHERQ/RS）示例修正

王贽

2011-04-26

1.2.3

增加酒店价格计划佣金缓存查询（TH_RateplanCommCacheRQ/RS）

王贽

2011-05-03

1.2.4

单酒店静态信息查询TH_RoomTypeStaticInfoCacheRQ/RS返回增加交通信息

王贽

2011-05-09

1.2.5

酒店数据缓存查询TH_HotelAvailabilityCacheRQ/RS返回RoomQuotas标签更改为Quotas

RoomQuota标签更改为Quota

王贽

2011-5-25

1.2.6

单酒店静态信息查询TH_RoomTypeStaticInfoCacheRQ/RS返回增加酒店所支持信用卡信息

王贽

2011-7-21

1.2.7

酒店数据缓存查询TH_HotelAvailabilityCacheRQ/RS返回标签ServiceFee、FeePercent说明修改

王贽

2011-8-5

1.2.8

TH_RoomTypeStaticInfoCacheRS返回标签CardIssueName增加信用卡对应发卡银行列表

王贽

2011-9-6

1.3.0

根据业务要求，酒店价格计划佣金缓存查询（TH_RateplanCommCacheRQ/RS）暂停提供

王贽

2011-11-9

1.3.1

多酒店静态缓存返回TH_HotelStaticInfoCacheRS增加ShortDesc、BrandCode、ChainCode标签

王贽

2011-11-24

1.3.2

多酒店静态缓存返回TH_HotelStaticInfoCacheRS增加TotalNumber、PageNo标签；

多酒店静态缓存请求TH_HotelStaticInfoCacheRQ增加PageNo标签

王贽

2012-01-9

1.4.0

增加酒店缓存更新查询（TH_UPDATEHOTELSRQ/RS）；

酒店数据缓存查询请求TH_HotelAvailabilityCacheRQ增加、标签；

价格计划控制缓存查询请求TH_RATEPLANCONTROLCACHERQ增加标签；

酒店数据缓存查询返回TH_HotelAvailabilityCacheRS标签增加属性RatePlanType；

价格计划控制缓存查询返回TH_RATEPLANCONTROLCACHERS增加标签

王贽

2012-3-1

1.4.1

TH_LandMarkSearchRQ中地标类别增加HOT：

热点地区

王贽

2012-3-22

1.5.0

增加TH_OfferHotelsRQ、TH_OfferRoomTypesRQ指令；

TH_UpdateHotelsRQ/RS指令请求、返回标签增加“P”，具体见文档说明；

“4.0酒店缓存查询策略”中增加新的说明，见标记为今天更细的部分内容；

3.8酒店缓存更新查询（TH_UpdateHotelsRQ/RS）增加如下说明：

“注意：

由于酒店更新信息涉及各个方面，缓存更新查询是以酒店为单位进行更新，可能更新查询会查到有变化的信息，但某些渠道在实际数据查询中未发现变化，这种情况属于正常”

王贽

2012-3-29

1.5.1

多酒店静态信息查询缓存（TH_HotelStaticInfoCacheRQ/RS）返回增加标签酒店拼音首字码

王贽

目录

变更记录2

1概述5

2指令格式解析5

3通知型指令详析6

3.1城市信息查询缓存（TH_CityDetailsSearchRQ/RS）6

3.1.1请求指令：

6

3.1.2返回指令：

7

3.1.3示例XML8

3.2地标行政区查询缓存（TH_LandMarkSearchRQ/RS）9

3.2.1请求指令：

9

3.2.2返回指令：

10

3.2.3示例11

3.3多酒店静态信息查询缓存（TH_HotelStaticInfoCacheRQ/RS）12

3.3.1请求指令：

12

3.3.2返回指令：

13

3.3.3示例：

15

3.4酒店数据缓存查询（TH_HotelAvailabilityCacheRQ/RS）16

3.4.1请求指令：

16

.3.4.2返回指令：

17

3.4.3示例：

20

3.5单酒店静态信息查询（TH_RoomTypeStaticInfoCacheRQ/RS）21

3.5.1请求指令：

22

3.5.2返回指令：

22

3.5.3示例：

25

3.6酒店价格计划控制缓存查询（TH_RateplanControlCacheRQ/RS）26

3.6.1请求指令：

26

3.6.2返回指令：

27

3.6.3示例：

28

3.7（该指令因业务原因暂停）酒店价格计划佣金缓存查询（TH_RateplanCommCacheRQ/RS）29

3.7.1请求指令：

29

3.7.2返回指令：

30

3.7.3示例：

31

3.8酒店缓存更新查询（TH_UpdateHotelsRQ/RS）32

3.8.1请求指令：

32

3.8.2返回指令：

33

3.8.3示例：

35

3.9酒店上下线缓存更新查询（TH_OfferHotelsRQ/RS）35

3.9.1请求指令：

36

3.9.2返回指令：

37

3.9.3示例：

38

3.10房型上下线缓存更新查询（TH_OfferRoomTypesRQ/RS）38

3.10.1请求指令：

39

3.10.2返回指令：

39

3.10.3示例：

40

4.0酒店缓存查询策略41

5.0关于返回错误42

5.0.1业务级错误返回42

5.0.2系统级错误返回42

1概述

该文档描述了HotelBE数据缓存接口各个指令的含义、具体内容及应用情况。

本接口通过MQ服务提供，为UTF-8编码格式。

外部通过http请求的方式调用DirectLink服务，目前也遵循UTF-8编码，如有变更，请遵循DirectLink编码标准即可。

请求的指令为XML字符串，参数名为request。

DirectLink的访问地址：

生产地址：

测试地址：

http:

//202.106.139.49:

9090/directlink/send.do

2指令格式解析

每条指令都包括两部分：

请求和返回，都是XML格式，请求指令以为根节点（请求中请不要出现单引号和百分号字符），返回指令以为根节点。

用户可以根据文档及示例程序对XML串进行解析，本文档将随系统升级而同步升级。

文档中，附有“★”标志的字段为不能为空字段。

未声明数据类型均为‘String’类型，未声明日期格式均为‘yyyy-MM-dd’,未声明时间格式均为‘HHMM（1800表示为下午六点，时分间没有冒号）’，结果为是或否的字段，取值均为是:

’Y’，否:

’N’,灰色区域以及未注释区域、字段均为保留扩展时使用。

指令中，IdentityInfo信息请务必填写完整，office信息务必填写，用户信息如无法确认具体操作人，可填写入office管理员信息。

3通知型指令详析

3.1城市信息查询缓存（TH_CityDetailsSearchRQ/RS）

用例：

城市信息查询指令

描述：

查询城市静态信息。

用于获取城市代码等信息列表。

该指令请求结构遵循TH_CityDetailsSearchRQ.xsd文件，返回结构遵循TH_CityDetailsSearchRS.xsd文件

3.1.1请求指令：

必填项:

指令名称，String类型固定值“TH_CityDetailsSearchRQ”★

String

所查城市所属国家代码CN:

中国String类型;’ALL’查询所有国家;US:

美国★

预留不填String类型

代理Office号★

用户名★

用户密码★

角色

代理Office号String类型★

String

预定渠道代码（默认填写:

HOTELBE）

3.1.2返回指令：

关于酒店图片：

请在返回的数据前添加服务器地址“，如请求返回了数据“/676/WJ/676WJ01.jpg”，此链接应为“

固定值TH_CityDetailsSearchRS

保留字段

城市3字码

城市名称

城市英文名

城市名称拼音

拼音首字母

省份名称

国家代码

国家

代理Office号★

用户名★

用户密码★

角色

代理Office号String类型

String

预定渠道代码（默认填写:

HOTELBE）

3.1.3示例XML

TH_CityDetailsSearchRQ

CN

HOTELBE

3.2地标行政区查询缓存（TH_LandMarkSearchRQ/RS）

用例：

地标行政区查询指令

描述：

该指令用来查询地标行政区等信息。

该指令请求结构遵循TH_LandMarkSearchRQ.xsd文件，返回结构遵循TH_LandMarkSearchRS.xsd文件

3.2.1请求指令：

必填项:

指令名称，String类型固定值“TH_LandMarkSearchRQ”★

String

类型。

POR：

地标信息，DST：

行政区信息；TRA：

交通信息；SGT：

周围景观；HOT：

热点地区。

String类型

所查城市所属国家代码不填默认为中国,ALL为查询所有国家String类型

预留不填String类型

城市code必填项★

代理Office号★

用户名★

用户密码★

角色

代理Office号String类型★

String

预定渠道代码（默认填写:

HOTELBE）

3.2.2返回指令：

固定值TH_LandMarkSearchRS

String

城市3字码

城市名称