単一の部屋の既存の予約をキャンセルします。複数の部屋の予約全体をキャンセルするには、旅程上の各部屋をそれぞれキャンセルする必要があります。

ホテルのキャンセル料の解読またはメッセージ送付についてサポートが必要な場合は、cancelPolicyInfoList 配列のドキュメントを参照してください。

実際の予約のキャンセル時にエラーが発生した場合は、キャンセル エラーのページを参照してください。テスト予約については、テスト予約の手順を参照してください。

 


リクエストのフォーマット
XML / REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/cancel?
XML 親エレメント : <HotelRoomCancellationRequest>



リクエスト パラメータ

基本パラメータ
名前 必須 説明
apiExperience string はい

この属性を使用して、リクエストの発信元を識別します。以下に示されているセットの中から、送信する各リクエストに該当する値を 1 つ選択します。

値 :
PARTNER_CALL_CENTER - コールセンターのエージェントからのリクエスト
PARTNER_WEBSITE - お客様向けの Web サイトからのリクエスト
PARTNER_MOBILE_WEB - モバイル向けの Web サイトからのリクエスト
PARTNER_MOBILE_APP - モバイル アプリからのリクエスト
PARTNER_BOT_CACHE - キャッシュ ボットからのリクエスト
PARTNER_BOT_REPORTING - レポート ボットからのリクエスト
PARTNER_AFFILIATE - アフィリエイト ベースにサービスする API / プラットフォームからのリクエスト

itineraryId long はい 予約時に指定された旅程 ID。
email string はい 予約時に指定された電子メール アドレス。
confirmationNumber string はい キャンセル対象の部屋の確認番号。

複数の部屋を予約している場合は、個別のリクエストで 1 度に 1 部屋のみキャンセルする必要があります。1 回のリクエストで複数の確認番号を送信してもキャンセルできません。
reason string いいえ キャンセルの理由コード (該当する場合)。これは必須項目ではありません。通常、キャンセル処理には影響しません。

値 :
HOC: ホテルからキャンセルを依頼されたため
COP: プラン変更
FBP: さらによい価格を見つけたため
FBH: さらによいホテルを見つけたため
CNL: 予定をキャンセルすることにしたため
NSY: ここでは言及しない
OTH: その他


レスポンス コンテンツ
親エレメント : HotelRoomCancellationResponse

名前 説明
cancellationNumber string キャンセルの参照番号 (正常にキャンセルされた場合)。今後問い合わせが必要になった場合にそなえて、お客様はこの番号に加えて旅程番号と確認番号を保管しておく必要があります。

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>