取消單一客房的現有訂房。

若要取消所有多間客房的訂房,行程上的每間客房都必須個別取消。

如果需要剖析或傳送飯店取消罰款訊息的協助,請參閱 cancelPolicyInfoList 陣列上的使用說明。
取消靜態測試訂房時,系統一定會傳回一則錯誤訊息。此為正常情況 - 在我們的付款、住宿或保留房系統中絕對不會輸入測試訂房。
若要確認您的測試取消,請在測試後尋找我們系統自動寄發的取消後電子郵件,或使用追蹤行程要求

如果您在取消真實訂房時收到錯誤訊息,請參閱我們的取消錯誤頁面。


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



要求參數

基本參數
名稱 必要 說明
apiExperience 字串 yes

利用此屬性辨識您的原始要求。請在下方提供的設定中,為每個您送出的要求選擇適當的值。

值:
PARTNER_CALL_CENTER - 來自客戶服務中心服務專員的要求
PARTNER_WEBSITE - 來自旅客服務網站的要求
PARTNER_MOBILE_WEB - 來自行動版網站的要求
PARTNER_MOBILE_APP - 來自行動 App 的要求
PARTNER_BOT_CACHE - 來自快取程式的要求
PARTNER_BOT_REPORTING - 來自報告程式的要求
PARTNER_AFFILIATE - 來自提供您專屬合作夥伴庫之 API/平台的要求

itineraryId 長整數 yes 於訂房時提供的行程 ID。
email 字串 yes 於訂房時提供的電子郵件地址。
confirmationNumber 字串 yes 要取消的客房確認編號。

請記住,如果要取消多間客房訂房,每間客房必須以個別要求的方式個別取消,您無法在單一要求中傳送多個確認編號。
reason 字串 no 取消原因代碼 (如果適用)。這並非為必填項目,而且通常不會影響取消的處理程序。

值:
HOC:飯店要求我取消
COP:計畫變更
FBP:找到更優惠價格
FBH:找到更優惠飯店
CNL:決定取消我的計畫
NSY:不願意表示
OTH:其他


回應內容
父項目: HotelRoomCancellationResponse

名稱 說明
cancellationNumber 字串 取消的參考編號 (如果取消成功)。除了此編號以外,旅客應繼續保留他們的行程和確認編號以供任何進一步通訊使用。

範例 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>

範例 REST 要求:

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
&itineraryId=xxxxxxx
&email=email@domain.com
&reason=COP
&confirmationNumber=xxxxxxxx 

範例 JSON 回應:

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