为一间客房取消现有预订。

要取消整个多客房预订,必须单独取消行程中的每间客房。

如果您在分析取消酒店预订要遭受的处罚或传递处罚消息方面需要帮助,请参阅有关 cancelPolicyInfoList 数组的文档。
取消静态测试预订时,始终会返回错误。这是正常现象 - 测试预订从不会进入我们的付款、住宿或预留房系统。
要验证您的取消预订测试,请在测试之后查找我们在取消预订后自动发出的电子邮件,或使用跟进行程请求

如果您在取消实时预订时收到错误,请参阅我们的取消错误页面。


请求格式
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/cancel?
XML 父元素: <HotelRoomCancellationRequest>



请求参数

基本参数
名称 是否必需 说明
apiExperience 字符串

使用此属性可识别您的请求源。针对您发送的每个请求,从下文提供的集合中选择一个适用的值。

值:
PARTNER_CALL_CENTER - 来自呼叫中心代理的请求
PARTNER_WEBSITE - 来自面向客户网站的请求
PARTNER_MOBILE_WEB - 来自手机格式网站的请求
PARTNER_MOBILE_APP - 来自手机应用程序的请求
PARTNER_BOT_CACHE - 来自缓存 bot 的请求
PARTNER_BOT_REPORTING - 来自报告 bot 的请求
PARTNER_AFFILIATE - 来自作为您自己的联盟伙伴库的 API/平台的请求

itineraryId 长整型 在预订时提供的行程 ID。
email 字符串 在预订时提供的电子邮件地址。
confirmationNumber 字符串 要取消的客房的确认编号。

请记住,对于多客房预订,必须通过单独的请求一次取消一间客房,在单个请求中发送多个确认编号将不起作用。
reason 字符串 取消的原因代码(如果适用)。这不是必需项,通常不会影响对取消的处理。

值:
HOC:酒店要求我取消
COP:更改计划
FBP:找到更好的价格
FBH:找到更好的酒店
CNL:决定取消我的计划
NSY:不想说
OTH:其他


回复内容
父元素: HotelRoomCancellationResponse

名称 说明
cancellationNumber 字符串 取消对应的参考编号(如果成功)。除此编号外,客户还应继续保留其行程和确认编号,以在任何其他信件中使用。

REST 请求示例:

http://api.ean.com/ean-services/rs/hotel/v3/cancel?
minorRev=[current minorRev #]
&cid=54321
&sig=5432145
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&locale=en_US
&currencyCode=USD
&itineraryId=xxxxxxx
&email=email@domain.com
&reason=COP
&confirmationNumber=xxxxxxxx 

JSON 回复示例:

{"HotelRoomCancellationResponse":{"customerSessionId":"XXXX","cancellationNumber":"XXXXX"}}

XML 请求示例:

http://api.ean.com/ean-services/rs/hotel/v3/cancel?
minorRev=[current minorRev #]
&cid=#####
&sig=##############
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelRoomCancellationRequest>
	<itineraryId>xxxxxxx</itineraryId>
	<email>email@domain.com</email>
	<reason>COP</reason>
	<confirmationNumber>xxxxxxxx</confirmationNumber>
</HotelRoomCancellationRequest>

XML 回复示例:

<ns2:HotelRoomCancellationResponse> 
   <customerSessionId>XXXX</customerSessionId>
   <cancellationNumber>XXXXXX</cancellationNumber>
</ns2:HotelRoomCancellationResponse>