제공된 투숙객 수 및 기타 기준을 충족하는 특정 호텔의 객실 데이터를 검색합니다.

이는 객실 선택이나 기타 사전 예약 쇼핑 지역을 위한 데이터 제공 또는 예약 제출 전의 요금 데이터 확인을 위해 요청될 수 있습니다.

방법 2는 예약하기 전에 요구되는 조건이며 성공적인 예약을 위한 가장 최신 요금 및 예약 가능한 객실 데이터를 확인합니다.

방법 1: 모든 객실의 반환 가능성 및 요금

이 방법은 한 시설 내 여러 객실에 관한 정보가 필요한 객실 선택 페이지 또는 기타 쇼핑 지역에서 사용합니다.

기본 요구 사항 외에 객실 수준의 이미지 요청 또는 답변에 포함된 호텔 정보 유형 조정을 위해 표시된 선택 사항을 보내야 할 수도 있습니다.

Name Required
apiExperience
hotelId
arrivalDate
departureDate
RoomGroup
includeRoomImages
includeHotelFeeBreakdown
options

방법 2: 예약 시 선택한 객실 확인

이 옵션은 고객이 예약 시 특정 객실을 선택한 이후에만 사용합니다.

이 요청 구성으로 요금 불일치 또는 품절 오류로 인한 예약 실패의 경우를 줄이고자 고객이 선택한 객실의 가장 최신 요금 데이터를 검색합니다.

Name Required
apiExperience
hotelId
arrivalDate
departureDate
RoomGroup
rateCode
roomTypeCode
includeDetails
includeHotelFeeBreakdown
요청 형식
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/avail?
XML 상위 요소: <HotelRoomAvailabilityRequest>
고유 프로토콜 요구 사항
REST: 객실 및 투숙객 수는 XML과 형식이 다릅니다. 호텔 목록 페이지에서 REST 객실 형식 섹션을 검토하십시오.

참고: 이 서비스의 필수 매개 변수가 상기 제시된 두 개의 서비스 방법으로 분리되었습니다.

요청 요인

기본 요인
이름 방법에 필수 설명
apiExperience 문자열 1&2 이 속성을 사용하여 요청의 원본을 식별할 수 있습니다. 제출한 각 요청의 아래에 제시된 집합에서 해당 값을 선택합니다.

값:
PARTNER_CALL_CENTER - 콜센터 상담원 요청
PARTNER_WEBSITE - 고객용 웹사이트 요청
PARTNER_MOBILE_WEB - 모바일 형식 웹사이트 요청
PARTNER_MOBILE_APP - 모바일 앱 요청
PARTNER_BOT_CACHE - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청

hotelId 정수(Long) 1&2 예약 가능 객실을 쿼리하는 숙박업소 ID
arrivalDate 문자열 1&2

체크인 날짜, MM/DD/YYYY 형식입니다.

당일 이용 요청을 위한 오늘 날짜를 포함합니다. 예약은 현지 호텔 시간으로 오후 11시 59분까지 가능합니다(PST 및 태평양제도의 경우 오후 9시 59분).

departureDate 문자열  1&2 MM/DD/YYYY 형식의 체크아웃 날짜입니다.

예약 가능 객실은 최대 이 날짜 500일 전에 검색할 수 있습니다.

전체 투숙 기간은 29일을 초과할 수 없습니다.
RoomGroup 개체 1&2 투숙객 및 객실 수를 정의하는 Room 배열의 컨테이너입니다. 목록 요청에서 REST를 사용한 경우 고유 REST 형식을 따라야 합니다.
RoomGroup.Room 배열 1&2 요청된 객실 수를 정의하는 Room 노드의 개수입니다. 각 노드에는 성인/아동 투숙객 수가 포함됩니다.

예약당 최대 8개의 객실까지 허용됩니다.
Room.numberOfAdults 정수 1&2 객실의 성인 투숙객 수입니다.

일반적으로 인당 추가 요금 없이 투숙객 4인까지 수용합니다.

"결과 없음" 오류를 방지하기 위해 항상 숙박 시설의 호텔 목록 응답으로 반환되는 가장 높은 maxRoomOccupancy 값으로 객실 이용률을 제한하십시오.

객실당 8명 이상의 투숙객을 허용하지 마십시오. 대부분이 시장에서는 8명 이상의 투숙객에 대한 결과가 반환되지 않습니다.

Room.numberOfChildren 정수 아동 수가 > 0인 경우 1&2 객실의 아동 투숙객 수입니다. 아동 동반 시 모든 숙박 시설에 대해 필수입니다. childAges와 조합되어 예약 가능 객실 및 요금이 결정됩니다.
Room.childAges 쉼표로 구분된
정수 목록
아동 수가 > 0인 경우 1&2 객실의 각 어린이 연령을 쉼표로 구분된 목록으로 전송합니다.

아동과 성인의 기준은 호텔마다 다르게 정의할 수 있으므로 아동 투숙객을 지정할 때 고객에게 해당 정보를 항상 요청해야 합니다. 예를 들어 숙박업소에서 17세를 성인으로 간주할 수 있으며 이전 성인 투숙객 정의에 따라 객실 인원 한도에 도달한 경우 성인 추가 인원 요금이 발생할 수 있습니다.
roomTypeCode 문자열 2만 고객의 특정 객실 선택이 이미 알려진 경우에만 사용됩니다. 이 문자열은 객실에 대한 취소 정책, 침대 유형 및 흡연/비흡연 선택을 반환합니다.

다음과 함께 전송합니다. rateCode
rateCode 문자열 2만 고객의 특정 객실 선택이 이미 알려진 경우에만 사용됩니다. 이 문자열은 객실에 대한 취소 정책, 침대 유형 및 흡연/비흡연 선택을 반환합니다.

다음과 함께 전송합니다. roomTypeCode
includeDetails 부울 2만 고객이 객실 선택을 완료한 이후 방법 2에 사용됩니다.

제공되는 객실 및 요금 코드를 위한 예약 준비 요금 데이터를 반환하려면 true로 전송합니다.

roomTypeCoderateCode와 함께 전송합니다
includeRoomImages 부울 필수 아님 지정된 hotelId에 대한 객실 수준 이미지를 검색합니다.

또한 룸온리 요청으로 사용 가능합니다.
includeHotelFeeBreakdown 부울 필수 아님 각 요금의 적용 빈도와 적용 방식을 포함하는 HotelFees 배열에 대한 더욱 자세한 응답 구조를 반환합니다. minorRev=24 이상에서 사용 가능합니다.
options 문자열 또는 쉼표로 구분된
문자열 목록
필수 아님 방법 1을 사용하여 숙박 시설의 객실 옵션을 채워 넣을 때 별도의 호텔 정보 요청 대신 이 매개 변수를 사용합니다.

단일 값 또는 쉼표로 구분된 목록 값의 조합을 전송합니다.

값:
HOTEL_DETAILS 호텔 세부정보만 검색(숙박업소 설명)
ROOM_TYPES 객실 유형 검색
ROOM_AMENITIES 객실 편의 시설 목록(소형 주방, TV 등) 검색
PROPERTY_AMENITIES 숙박업소 편의 시설 목록(스파, 체육관, 회의실) 검색
HOTEL_IMAGES 호텔 이미지 URL만 검색(객실 이미지 아님)
numberOfBedRooms 정수 필수 아님 이 요인은 콘도/휴가철 렌트에만 유효합니다. 요청된 침실의 수를 지정하며 최대 4개까지 가능합니다.
supplierType 문자열 필수 아님 이전 호텔 목록 응답에서 반환된 동일한 값을 제공합니다.

값:
E: Expedia Collect
rateKey 문자열 필수 아님 이전 호텔 목록 응답에 제공된 요금을 결정하는 요인에 대한 키입니다.
호텔 객실 응답
요청된 특정 호텔에서 명시된 숙박일 동안 명시된 고객 수를 수용할 수 있는 객실을 반환하거나 제공된 roomTypeCoderateCode에 대해 예약 가능 여부 및 가격을 확인합니다.

또한 이러한 응답은 체크인 지침, 숙박업소 세부정보, 세부 요금 정보 및 예약에 필수인 rateKey 키를 반환합니다.

options 개체가 방법 1 요청에 포함된 경우 개체 내에 지정된 세부 정보도 반환됩니다(해당하는 경우).

응답 컨텐츠
상위 요소: HotelRoomAvailabilityResponse
특성: size - 반환된 객실 개수

이름 설명
hotelId 정수(Long) 숙박업소에 대한 ID입니다. 동일한 ID가 이후의 모든 예약 요청에 사용됩니다.
arrivalDate 문자열 요청에 제출된 체크인 날짜를 확인합니다.
departureDate 문자열 요청에 제출된 체크아웃 날짜를 확인합니다.
hotelName 문자열 호텔 이름
hotelAddress 문자열 호텔 위치 주소
hotelCity 문자열 호텔이 위치한 도시
hotelStateProvince 문자열 시/도를 나타내는 두 자리의 코드로, 지정된 도시를 포함합니다. 미국, 캐나다 및 호주 국가 코드인 경우에만 반환됩니다.

참조:
미국 주 코드
캐나다 주/영토 코드
호주 주/영토 코드
  • 호주 수도 - AC
  • 뉴사우스웨일즈 - NW
  • 노던 준주 - NO
  • 퀸즐랜드 - QL
  • 남호주 - SA
  • 태즈메이니아 - TS
  • 빅토리아 - VC
  • 서호주 - WT
hotelCountry 문자열 호텔이 위치한 국가를 나타내는 두 자리의 ISO-3166 코드입니다.
numberOfRoomsRequested 정수 요청에 전송된 Room 노드의 개수를 확인합니다.
checkInInstructions 문자열 호텔에서 반환하는 경우 반드시 표시해야 합니다.
체크인 시 발생할 수 있는 수수료, 운영 시간 이후 체크인 지침 등이 포함될 수 있습니다.
specialCheckInInstructions 문자열 숙박 시설에 예정 도착 시간 알림 요건 등과 같이 중요한 체크인 정보가 포함됩니다. 기본 체크인 지침과 동일한 영역에 이 정보를 표시합니다.
HotelRoomResponse 배열 각 노드에는 호텔의 각 객실에 대한 요금과 세부정보가 포함됩니다. 이 배열의 JSON 응답 형식은 Axis에서 문제를 일으킬 수 있습니다.
HotelRoomResponse.policy 문자열 그 외 다양한 정책입니다(예: 체크인 시 필요한 사진 ID).
HotelRoomResponse.rateCode 문자열 표시된 요금에 대한 코드입니다.
HotelRoomResponse.roomTypeCode 문자열 객실에 대한 객실 유형 코드입니다.

options 요인이 예약 가능 객실 요청에 전송된 경우 이 요소는 반환되지 않습니다. 값은 RoomType 개체의 roomCode 특성을 대신 전송합니다.
HotelRoomResponse.rateDescription 문자열

두 객실과 청구 요금에 대한 간단한 설명입니다(예: 디럭스 룸 킹 - 비용 일체 포함).

기본 표시로 권장합니다.

HotelRoomResponse.roomTypeDescription 문자열 객실 유형에 대한 간단한 설명입니다(예: 디럭스 더블 킹).

options 요인이 예약 가능 객실 요청에 전송된 경우 이 요소는 반환되지 않습니다. 값은 RoomType 개체의 description 요소를 대신 전송합니다.
HotelRoomResponse.supplierType 문자열 호텔 공급업체입니다. 제공된 모든 예약을 처리할 때 동일한 공급업체가 사용됩니다.

값:
E: Expedia Collect
HotelRoomResponse.otherInformation 문자열 호텔에 대한 기타 정보입니다(해당하는 경우).
HotelRoomResponse.propertyId 문자열 호텔의 Expedia ID입니다. Expedia로 상호 참조할 때 이 값을 사용하여 hotelId에 매핑합니다.
HotelRoomResponse.smokingPreferences 쉼표로 구분된 문자열 목록 객실에 대해 흡연/비흡연을 사용 가능합니다(해당하는 경우).

값:
NS: 비흡연
S: 흡연
E: 둘 중 하나
HotelRoomResponse.minGuestAge 정수 어린이가 허용되지 않는 경우 객실 내 투숙객의 최소 연령(예: 18 또는 21)입니다. 최소 연령이 없는 경우 0 또는 빈 값을 반환합니다.
HotelRoomResponse.quotedOccupancy 정수 추가 요금을 제외한 객실 수용 가능 최대 인원을 나타냅니다.
HotelRoomResponse.rateOccupancyPerRoom 정수 추가 요금이 발생될 수 있는 고객을 포함하여 객실 수용 가능 최대 인원을 나타냅니다. 목록 응답의 maxRoomOccupancy 값과 동일합니다.

이 값이 quotedOccupancy 값보다 큰 경우, Surcharges 배열에 있는 추가 요금을 확인한 다음 사용자에게 이를 알리십시오.
문자열 템플릿에 객실 예약 가능 여부 페이지에 상응하는 딥 링크를 추가합니다. 반환 형식은 기존의 템플릿 계정과 호환됩니다.
HotelRoomResponse.BedTypes 배열 각 객실의 침대 유형 선택권입니다. 싱글 침대 유형이나 예약할 때 포함할 수 있는 선택권을 반환할 수 있습니다. 침대 유형 세부정보 검토
HotelRoomResponse.ValueAdds ValueAdd의 컨테이너 해당하는 경우 제공된 객실 및 요금에 대한 ValueAdd 요소의 배열을 포함합니다. 반환된 부가 서비스의 개수를 나타내기 위해 size 특성을 포함합니다.
ValueAdds.ValueAdd 배열

제공된 객실 및 요금에 포함되는 무료 서비스(예: 무료 아침식사 또는 무선 인터넷)에 대해 description 요소를 포함합니다.

minorRev=28 이상인 경우 숫자로 된 id 속성은 반환되지 않고 description만 제공됩니다. 최소 minorRev=28을(를) 사용하여 일정 및 예약 응답에 부가 서비스를 반환할 수 있습니다.

minorRev=26 이하를 사용하면 다음과 같은 알려진 id 속성이 description 값을 반환합니다.

ID description
1 모든 식사
2 유럽식 아침식사
4 풀코스 아침식사
8 영국식 아침식사
16 무료 점심식사
32 무료 저녁식사
64 식음료 이용 포인트
128 무료 주차
256 무료 공항주차
512 비용 일체 포함
1024 무료 초고속 인터넷
2048 무료 무선 인터넷
4096 2인용 유럽식 아침식사
8192 2인용 아침식사
16384 무료 주차대행
32768 무료 공항 셔틀
65536 무료 객실 업그레이드
131072 리조트 포인트 포함
262144 도착 시 환영 선물
524288 스파 이용 포인트
1048576 골프 이용 포인트
2097152 나이트클럽 VIP 출입권
4194304 1인 요금으로 2인 이용 뷔페
8388608 무료 스키 리프트권 & 장비 대여
16777216 아침 뷔페
33554432 숙박 시 식사 일부 제공
67108864 숙박 시 식사 제공
134217728 취사도구 완비
268435456 슬롯머신
536870912 카지노 이용 포인트
1073741824 매치 플레이
HotelRoomResponse.RoomImages 배열 includeRoomImages 요인을 통해 요청되는 경우 사용 가능한 객실 수준 이미지 URL 배열입니다.
HotelRoomResponse.RoomType 개체 options 요인이 ROOM_TYPES 및/또는 ROOM_AMENITIES 값과 함께 전송되면 반환됩니다.

특성:
roomCode: roomTypeCode 요소 대체
roomTypeId
RoomType.description 문자열 roomTypeDescription 요소를 대체합니다. 모든 예약 및 예약 확인 페이지뿐만 아니라 개별 객실 페이지에도 표시해야 합니다.
RoomType.descriptionLong 문자열 자세한 객실 유형 설명입니다(해당하는 경우).
RoomType.roomAmenities 배열 해당하는 경우 객실 편의 시설 목록입니다(호텔 정보 응답에 제공된 것과 동일한 콘텐츠 및 구조).
RoomType.HotelDetails 개체 호텔 설명 컨텐츠(호텔 정보 응답에 제공된 것과 동일한 콘텐츠 및 구조)
RoomType.PropertyAmenities 개체 호텔 편의 시설 정보(호텔 정보 응답에 제공된 것과 동일한 콘텐츠 및 구조)
RoomType.HotelImages 개체 호텔 이미지 정보(호텔 정보 응답에 제공된 것과 동일한 콘텐츠 및 구조)
HotelRoomResponse.RateInfos RateInfo의 컨테이너 개별 객실에 대해 상세 요금 정보를 제공하는 RateInfo 요소의 배열을 포함합니다.

minorRev=6 또는 이전에서 실행되는 오래된 통합을 사용하는 경우 RateInfoRateInfos 컨테이너 없이 반환됩니다.
RateInfos.RateInfo 개체 몇 가지 다른 개체 및 개별 값 내에서 단일 객실에 대한 모든 요금 정보를 포함합니다.

특성:
priceBreakdown 부울 청구된 전체 요금 내역에 세금과 총금액이 포함되어 있는지 나타냅니다.
promo 부울 반환된 요금이 프로모션 요금인지 나타냅니다.
rateChange 부울 투숙 기간 동안 하루 이상의 숙박비가 다른 날과 다른지 나타냅니다.
RateInfo.RoomGroup 개체 제공된 요금에 적용할 때 동일한 RoomGroup 개체의 컨텐츠가 요청에 전송되었는지 확인합니다. minorRev=29 이상인 경우 객실당 숙박비 세부 정보를 포함합니다.
RoomGroup.Room 개체 개체의 아동 요소는 제공된 요금 계산에 사용된 특정한 numberOfAdults, numberOfChildrenchildAges를 확인합니다.
Room.rateKey 개체 검색 요인 및 가격을 결정하는 기타 값에 대한 키

이 값은 호텔 예약 가능 객실 응답에 반환된 값과 항상 다릅니다. 이 응답의 값을 예약 요청으로 전달합니다.

검색 요인이 변경될 때마다(예: 투숙객 수 변경, 숙박 날짜 변경, 아동 추가 등) 새 요청을 전송하여 이 요인에 대한 새 값을 얻어야 합니다.

minorRev=18 이하의 경우 이 요소는 응답의 본문에서 반환됩니다.
Room.ChargeableNightlyRates 배열 객실의 NightlyRate 배열에 대한 컨테이너입니다. 반환되는 요금은 개별 객실에 특정하며 숙박 기간에 걸쳐 순차적으로 반환됩니다.

여러 객실의 평균 1박 비용을 보려면 nightlyRatesPerRoom에서 제공된 값을 사용합니다.

minorRev=29 이상에 대해 반환됩니다.
ChargeableNightlyRates.NightlyRate 개체 요청한 투숙 기간 내의 단일 야간 요금을 제공합니다. 이 위치 이내로 반환되면 요금은 항상 포함 Room에 특정합니다.

프로모션 요금, 기본 요금 및 프로모션이 적용된 이후의 요금이 있는지 나타냅니다(해당하는 경우). 특성만 포함합니다.

minorRev=29 이상에 대해 반환됩니다.

특성:
promo 부울 숙박 요금에 프로모션 요금이 적용되었는지 나타냅니다.
rate 부동 프로모션이 적용된 이후의 숙박비입니다(해당하는 경우).
baseRate 부동 프로모션이 적용되기 전의 숙박비입니다(해당하는 경우).
ChargeableNightlyRates.NightlyRate 개체

고객이 요청한 통화로 변환된 요금 정보입니다. 요청된 통화가 호텔에서 비용 청구할 수 없는 통화이거나 고객의 시장 지역 내의 통화인 경우에만 반환됩니다. ChargeableNightyRates와 동일한 특성을 포함합니다. minorRev=29 이상에 대해 반환됩니다.

ChargeableNightlyRates.
ConvertedNightlyRates
개체 고객이 요청한 통화로 변환된 요금 정보입니다. 요청된 통화가 호텔에서 비용 청구할 수 없는 통화이거나 고객의 시장 지역 내의 통화인 경우에만 반환됩니다. ChargeableNightyRates와 동일한 특성을 포함합니다. minorRev=29 이상에 대해 반환됩니다.
RateInfo.promoId 문자열 반환된 프로모션 상품의 ID입니다(있는 경우).
RateInfo.promoDescription 문자열 반환된 프로모션의 설명입니다(있는 경우). 최대 255자가 반환됩니다.
RateInfo.promoDetailText 문자열 반환된 프로모션의 추가 세부정보입니다(있는 경우).
RateInfo.nonRefundable 부울 예약의 환불 불가능 여부를 나타냅니다. 반환되는 경우 반드시 표시하며 성공적인 예약 이후에 모든 청구는 최종입니다. 이 값은 기타 정책 데이터에 언제나 우선합니다.
RateInfo.depositRequired 부울 Expedia Collect에서는 항상 true을 반환합니다.
RateInfo.rateType 문자열 반환 요금이 EAN을 통해 선납되는지 호텔에서 후납되는지 여부를 표시합니다. 선불 예약 가능 객실에 대해 MerchantStandard의 값으로 반환되거나 모든 후불에 대해 반환되지 않습니다.
RateInfo.currentAllotment 정수 숙박업소에서 보유하고 있는 예약 가능한 객실 수입니다. 이 값을 사용하여 긴급 메시지에 대한 규칙을 생성하면 성수기나 인기 숙박업소에 대해 예약 가능 객실 수가 적음을 사용자에게 알려 줄 수 있습니다.

0이 반환되는 경우에도 숙박업소에 예약 가능한 객실이 부족하다는 뜻이 아닙니다. 이것은 값을 계산하는 데 필요한 규칙이 충족되지 않음을 나타내며 절대적인 예약 가능 객실을 나타내는 것이 아닙니다.
RateInfo.cancellationPolicy 문자열 이 객실에 대한 호텔의 취소 정책입니다. 모든 예약 및 예약 확인 페이지뿐만 아니라 개별 객실 페이지에도 표시해야 합니다.
RateInfo.CancelPolicyInfoList Cancel
PolicyInfo
의 컨테이너
취소 정책의 구체적인 내용은 일반적으로 위약금 부과 기간을 결정하는 시간과 취소 시 발생하는 위약금입니다.
CancelPolicyInfo 배열의 세부정보 검토
RateInfo.ChargeableRateInfo 개체 이 개체의 특성은 요금 평균 및 총금액뿐 아니라 예약에 대해 청구된 총금액을 포함합니다. 개별 숙박비와 추가 요금에 세부정보를 제공하는 개체 내 노드입니다.

특성:
total 부동 예약에 청구되는 모든 숙박비, 세금 및 추가 요금의 총합입니다. 고객에게 표시되어야 하는 전체 값이며 예약 요청에 포함됩니다.
surchargeTotal 부동 Surcharges 배열에서 TaxAndServiceFeeExtraPersonFee에 대한 합계입니다.
nightlyRateTotal 부동 이 개체 내에 포함된 nightlyRatesPerRoom 배열의 모든 값에 대한 합계입니다.
maxNightlyRate 부동 반환된 모든 요금에서 가장 높은 1박 요금입니다.
currencyCode 문자열 반환된 요금에 대한 통화 코드입니다.
commissionableUsdTotal 부동 파트너 수수료를 계산하는 데 사용되는 금액이며 미국 달러 기준입니다. 추가 요금 없는 숙박비 총합입니다.
averageRate 부동 추가 요금 없이 프로모션 값이 적용된 평균 숙박비입니다.
averageBaseRate 부동 추가 요금 없이 프로모션 값이 적용되지 않은 평균 숙박비입니다. 프로모션이 없으면 이전 값과 똑같이 반환됩니다.
ChargeableRateInfo.
nightlyRatesPerRoom
배열 NightlyRate 배열의 컨테이너입니다. 배열에서 노드의 개수를 나타내기 위해 size 특성을 보유하며 요청에서 숙박일수에 해당합니다. 투숙 기간 동안 연속된 순서로 반환되는 요금입니다.
nightlyRatesPerRoom.NightlyRate n/a

요청한 투숙 기간 내의 단일 야간 요금을 제공합니다.

프로모션 요금, 기본 요금 및 프로모션이 적용된 이후의 요금이 있는지 나타냅니다(해당하는 경우). 특성만 포함합니다.

여러 객실 요청의 경우, 이 값은 모든 객실의 1박 비용의 평균입니다. EAN은 여러 객실 가격 표시를 위해 새로운 객실별 ChargeableNightlyRates 배열을 사용할 것을 권장합니다.

minorRev=28 이하의 여러 객실 요청의 경우, 이 요소는 평균 요금이 아니라 첫 번째 객실에 대해서만 요금을 제공합니다.



특성:
promo 부울 숙박 요금에 프로모션 요금이 적용되었는지 나타냅니다.
rate 부동 프로모션이 적용된 이후의 숙박비입니다(해당하는 경우).
baseRate 부동 프로모션이 적용되기 전의 숙박비입니다(해당하는 경우).
RateInfo.promoType 문자열 반환된 프로모션이 모바일용인지 표준 프로모션인지 나타냅니다. 모바일 프로모션의 경우 Mobile, 그 외에는 Standard를 반환합니다.
모바일 프로모션을 반환하려면 적절한 customerUserAgent 문자열을 통해 모바일 사이트 또는 앱을 식별해야 합니다.
ChargeableRateInfo.Surcharges 배열 Surcharge 배열의 컨테이너입니다. 이 배열은 surchargeTotal에 대해 반환된 값을 구성하는 개별 추가 요금을 나열합니다. 배열에서 노드의 개수를 나타내기 위해 size 특성을 포함합니다.
Surcharges.Surcharge n/a 단일 추가 요금 및 유형에 대한 세부정보입니다. 특성만 포함합니다.

특성:
amount 부동 특정 추가 요금의 총합입니다.
type 문자열 추가 요금 이름입니다.
가능한 값:
  • TaxAndServiceFee
  • ExtraPersonFee
  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax

TaxAndServiceFeeExtraPersonFeesurchargeTotal에 합산됩니다. 다른 모든 값은 TaxAndServiceFee 값의 개별 요소입니다.


참고: SalesTaxHotelOccupancyTax 추가 요금 유형은 뉴욕 주 법률에 따라 표시되어야 합니다. 최종 요금 내역에서 이러한 값을 "호텔 투숙 및 판매세"로 표시할 수 있는지 확인해야 합니다.

RateInfo.HotelFees 배열

이 요소는 호텔에서 부과한 특정 세금 및 요금을 분석하며 그렇지 않은 경우 추가 요금 배열에서 상세하게 제공됩니다.

이 요소의 모든 값은 체크인 또는 체크아웃 시 호텔 측에서 청구합니다. 예약 시점에 징수되는 요금의 일부가 아닙니다.

기입되면 주요 검색 엔진이나 애그리게이터에서 필요한 요금/세금/수수료 표시 형식과 일치하도록 이 요소를 사용합니다.

포함된 청구 개수를 나타내도록 size 특성을 포함합니다.

HotelFees.HotelFee 없음 설명, 총금액, 단일 요금의 통화에 대한 특성을 포함합니다. VAT, 시/도 세금, 리조트 요금 또는 합법적으로 피할 수 없는 그 외 요금에 대한 세부정보입니다.
ChargeableRateInfocurrencyCode 특성에서 나타내는 예약 가능한 통화에 반환되는 청구입니다.

특성:
description 문자열 청구 유형입니다. 가능한 값:
  • MandatoryFee
  • MandatoryTax
  • ResortFee
amount 부동 청구에 대한 값입니다.
HotelFee.HotelFeeBreakdown 없음 요청에서 includeHotelFeeBreakdown가 전송된 경우 반환됩니다. 요금이 적용되는 방식과 빈도를 설명합니다.

특성:
unit 문자열 요금이 배포되는 방식입니다. 가능한 값:
  • Per Person
  • Per Room
  • Per accommodation
  • Per house
  • Per apartment
  • Per adult
frequency 문자열 요금의 빈도입니다. 가능한 값:
  • Per Night
  • Per Day
  • Per Stay
  • Per week

minorRev=24 이상에서 사용 가능합니다.

RateInfo.ConvertedRateInfo 개체 고객이 요청한 통화로 변환된 요금 정보입니다. 청구 가능한 통화와 변환된 통화가 다른 경우에만 반환됩니다(예: 호텔이 고객이 요청한 통화를 수용할 수 없는 경우). ChargeableRateInfo와 동일한 특성을 포함합니다.