단일 객실에 대한 기존 예약을 취소합니다. 여러 개의 객실이 포함된 예약 전체를 취소하려면 일정의 각 객실을 개별적으로 취소해야 합니다.

호텔 취소 위약금 분석 또는 메시징에 도움이 필요하면 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 - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청
PARTNER_AFFILIATE - 고유 제휴사 기반으로 서비스하는 API/플랫폼 요청

itineraryId 정수(Long) 필수 예약 시 제공된 일정 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>