지정된 객실의 예약을 요청합니다. 이 요청은 고객의 결제 정보를 보호하기 위해 HTTPS를 통해 POST 메소드로 전송해야 합니다. 이 요청에서 제출된 정보는 EAN의 독점적인 사기 및 보안 검증 메소드를 거칩니다.

요청에 입력한 신용카드 정보는 예약 시 직접 선지급할 때 사용됩니다. 예약 날짜 전이라도 응답이 수신되면 고객의 예약이 즉시 전액 결제 처리됩니다(룸서비스 등의 추가 사항 제외).

실시간 예약에 정확한 cid/apiKey 쌍을 사용해야 합니다. 이는 예약을 성공적으로 완료하고 수수료가 올바른 계좌로 지급되도록 하는 데 매우 중요합니다.

city, address 또는 firstNamelastName 값에서 입력 검증 오류가 발생하는 경우, 현재 이 API는 UTF-8 Basic LatinLatin-1 Supplement 문자 집합만 지원한다는 사실에 유의하십시오. ő 또는 ű 와 같이 이러한 문자 집합에서 지원되지 않는 문자를 사용하는 언어의 경우 입력 오류를 피하기 위해 필터링되거나 변환되어야 합니다.


요청 형식
XML/REST URL: POST https://book.api.ean.com/ean-services/rs/hotel/v3/res
XML 상위 요소: <HotelRoomReservationRequest>

URL 길이 제한 문제의 발생을 방지하기 위해 POST 본문 안의 모든 요청 값을 application/x-www-form-urlencoded 데이터로 전송하십시오. URL 문자열 자체에 매개 변수를 전송하지 마십시오.
XML 요청의 경우, 일반 요소를 GET 요청에 사용되는 형식과 동일한 형식으로 전송해야 합니다. 이러한 값을 POST 본문에서 XML 요소 형식으로 지정하지 마십시오.



요청 매개변수

서비스별 URL 매개변수
이름 필수 설명
currencyCode 문자열 필수 예약 요청을 위해 이 매개변수를 작성할 때는 항상 이전 응답의 ChargeableRateInfo 노드에서 반환된 속성 값을 사용하십시오.
이 값에 다른 소스를 사용하면 불일치 오류가 발생할 수 있습니다.
additionalData 다음에 대한 컨테이너: MapEntry 필수 아님

이 예약 전용 요인을 사용하여 EAN 제휴사 센터에서 예약을 추적할 수 있습니다. 전체 설명서는 예약 추적 페이지를 참조하십시오.



기본 요인
이름 유형 필수 설명
apiExperience 문자열 필수

이 속성을 사용하여 요청의 원본을 식별할 수 있습니다. 제출한 각 요청의 아래에 제시된 집합에서 해당 값을 선택합니다.

값:
PARTNER_CALL_CENTER - 콜센터 담당자 요청
PARTNER_WEBSITE - 고객용 웹 사이트 요청
PARTNER_MOBILE_WEB - 모바일 형식 웹 사이트 요청
PARTNER_MOBILE_APP - 모바일 앱 요청
PARTNER_BOT_CACHE - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청
PARTNER_AFFILIATE - 고유 제휴사 기반으로 서비스하는 API/플랫폼 요청

hotelId 정수(Long) 필수 예약 시 요청되는 숙박업소 ID
arrivalDate 문자열 필수

체크인 날짜, MM/DD/YYYY 형식입니다. 객실 응답에서 값을 가져옵니다.

예약은 현지 호텔 시간으로 오후 11시 59분까지 가능합니다(PST 및 태평양제도의 경우 오후 9시 59분).

departureDate 문자열 필수 체크아웃 날짜, MM/DD/YYYY 형식입니다. 객실 응답에서 값을 가져옵니다.
supplierType 문자열 필수 예약에 사용할 공급업체를 정의합니다. 객실 응답에서 값을 가져옵니다.

값:
E: Expedia Collect
rateKey 문자열 필수 예약 요청에서 사용된 요인을 확인합니다. 객실 응답에서 값을 가져옵니다. 최적의 성능을 위해 객실 응답의 첫 번째 Room 개체 내에서 반환된 rateKey를 사용합니다.

이전 객실 응답에 제공된 값이 아닌 다른 값을 사용할 경우 예약이 실패합니다.

고객이 예약 단계에서 모든 요인을 수정할 수 있도록 허용한 경우, 해당 요인을 새 객실 요청에 재전송하여 이 요인에 대한 새 유효값을 받을 수 있습니다.

"유효하지 않은 QueryId"에 관한 오류 또는 요금 캐시 오류가 발생하는 경우 키가 만료되었거나 잘못되었을 수 있습니다. 변경된 요인가 없는 경우에도 이전 객실 요청을 재전송하여 새 값을 받을 수 있습니다.
roomTypeCode 문자열 필수 요청된 특정 객실을 지정하는 코드로, 이전 객실 응답에서 항상 동적으로 가져와야 합니다.

다음과 함께 전송: rateCode
rateCode 문자열 필수 요청된 특정 객실에 연결된 요금을 지정하는 코드로, 이전 객실 응답에서 항상 동적으로 가져와야 합니다.

다음과 함께 전송: roomTypeCode
RoomGroup 개체 필수 투숙객 및 객실 수를 정의하는 Room 배열의 컨테이너입니다. 이전 객실 요청에서 정의된 것과 동일한 성인 수, 어린이 수 및 어린이 연령 값을 사용합니다.

예약 시 이 개체에 대한 추가 매개변수가 필요합니다(아래 참조).
RoomGroup.Room 배열 필수 요청된 객실 수를 정의하는 Room 노드의 개수입니다. 이전 객실 요청에서 정의된 것과 동일한 노드 개수 및 투숙객 수/연령 요인을 포함합니다.
Room.numberOfAdults 정수 필수 객실의 성인 투숙객 수입니다. 이전 객실 요청에서 정의한 것과 동일한 값을 사용합니다.
Room.numberOfChildren 정수 > 0인 경우 필수 객실의 아동 투숙객 수입니다. 이전 객실 요청에서 정의한 것과 동일한 값을 사용합니다.
Room.childAges 쉼표로 구분된
정수 목록
아동 수가 > 0인 경우 필수 어린이 투숙객의 연령입니다(해당하는 경우). 이전 객실 요청에서 정의한 것과 동일한 값을 사용합니다. EAN은 영아를 포함한 17세 미만을 모두 아동으로 간주합니다.
Room.firstName 문자열 필수 예약 시 체크인하는 투숙객의 이름입니다. 숙박업소에서 체크인할 때 투숙객의 사진 ID에 있는 이름과 일치해야 합니다.

최대 25자이며 호칭이나 기업명을 사용할 수 없습니다. 투숙객 이름은 각 객실별로 고유하지 않아도 됩니다.
Room.lastName 문자열 필수 예약 시 체크인하는 투숙객의 성입니다. 숙박업소에서 체크인할 때 투숙객의 사진 ID에 있는 이름과 일치해야 합니다.

최대 40자이며 호칭이나 기업명을 사용할 수 없습니다. 투숙객 이름은 각 객실별로 고유하지 않아도 됩니다.
Room.bedTypeId 문자열 필수 고객이 선택한 침대 코드입니다(선택하지 않은 경우 단일 값).

객실 응답 중 고객이 선택한 객실의 BedType ID 특성과 일치하는 값을 가져옵니다.

동일한 객실의 여러 침대 유형 중 하나를 선택하도록 요청하며 예약 가능 객실이 없는 경우 호텔에서 예약을 접수하지 않을 수 있습니다.
Room.numberOfBeds 정수 필수 아님 1 또는 2의 값입니다. 전용으로, 객실 응답에 반환된 BedType 옵션을 기반으로 하여 합리적인 경우에만 제공합니다.
Room.smokingPreference 문자열 사용한 경우 필수 요청된 흡연/비흡연 선택입니다. 해당 예약에서 필요 없는 경우 요청에서 이 요소를 모두 생략하십시오.

가능한 값:
NS: 금연
S: 흡연
E: 상관없음

객실 응답에서 반환된 값만 제공하며 위의 값은 하드 코딩된 선택 사항으로 사용하지 않습니다. 응답에 제공되지 않은 값을 포함하면 예약 오류가 발생합니다. 여러 값을 전송하지 않습니다.
affiliateConfirmationId 문자열 필수 예약을 추적하고 중복 예약을 방지하도록 설계된 값입니다.

예약을 제출하기 전에 GUID ID(최대 36자)와 같은 고유한 값을 생성합니다. API에서 기존 예약과 연결된 값을 감지하면 이후의 모든 예약을 중복으로 간주하여 예약을 방지합니다.

유효한 예약 재시도가 거부되지 않게 하려면 시간 초과 이외의 다른 오류로 인해 실패한 예약을 다시 시도할 때 항상 새 값을 생성하십시오.
affiliateCustomerId 문자열 필수 아님 파트너 측의 추적에 사용하기 위한 선택적인 추가 고객 ID입니다. 이 ID가 의도치 않게 노출되면 고객에게 해당하지 않는 일정 검색을 허용할 수 있으므로, 내부적으로만 사용합니다.
itineraryId 정수(Long) 필수 아님

최초 예약 요청이 신용카드 오류를 반환한 경우 응답에서 이 값을 추출하고 해당 값을 이후의 예약 시도에 포함합니다.

다시 전달되면 이 값이 첫 번째 요청에서 생성된 기존 일정 기록과 연결됩니다. 반복된 신용카드 거절이나 오류는 단일 레코드로 제한되어 모든 통계에서 여러 번의 취소로 표시되는 것을 방지할 수 있습니다.

EAN 지원을 이용하는 경우(자체 지원 상담원이 없는 경우)에만 이 값을 고객에게 공개하십시오.

-1로 반환되면 이 값을 다시 보내지 않습니다. 일정이 만들어지지 않았음을 나타냅니다. 오류를 메시지로 전달하고 필요한 경우 고객이 수정할 수 있도록 한 후 새로운 요청을 시작하십시오.

chargeableRate 문자열 필수 예약 시 청구되는 총금액입니다.

객실 응답에 반환된 ChargeableRateInfo 개체에서 total 값을 전달합니다.

요청 제출 시 이 금액을 제공된 객실 및 요금 코드에 대한 가장 최근 요금과 비교하여 확인합니다. 최근 요금이 더 높으면 새로운 높은 요금 및 일치하는 해당 rateKey 값이 포함된 오류가 반환됩니다. 최근 요금이 더 낮으면 요청이 새로운 낮은 요금과 함께 전달됩니다.
specialInformation 문자열 필수 아님

고객이 추가 정보나 요청을 추가하여 숙박업소에 전달할 수 있도록 허용합니다.

포함된 정보는 요청에 불과하며 보장되지 않으므로 – 이 필드를 사용하여 B2B 고객 서비스 요청을 전달하거나 중요한 개인/재무 정보를 전달하지 마십시오.

최대 256자이며 줄 바꿈이나 캐리지 반환은 허용되지 않습니다. 이 요인에서 줄 바꿈이나 캐리지 반환을 제거하지 않으면 복구할 수 없는 오류가 발생합니다.

sendReservationEmail 부울 필수 아님

자체 확인 이메일을 보내는 경우 false로 전송하고 그 외의 경우 생략합니다.

이미 계정 관리자에게 문의했거나 자체 확인 이메일 시스템을 지원하는 경우에만 이 요인을 사용합니다.

결제 정보 매개변수
이 매개변수는 결제를 위한 고객의 신용카드 확인 및 청구에 사용되는 정보를 정의합니다.

결제 정보는 ReservationInfo 개체 및 AddressInfo 개체를 통해 제공되며, 두 개체 내에 해당하는 값을 신용카드 소유자의 발급 은행 정보와 비교하여 확인합니다.

결제 확인 및 처리에 사용되는 일부 시스템은 라틴 문자 이외의 문자를 구문 분석할 수 없습니다. 따라서 데이터 확인 오류를 방지하기 위해 모든 요인에 라틴 문자 값만 허용합니다.

신용카드 종류 페이지의 확인 섹션에서 카드 정보 요청 및 처리를 위한 모범 사례를 확인하십시오.

이름 필수 설명
ReservationInfo 개체 필수 고객의 연락처 및 신용카드 정보를 포함합니다.
ReservationInfo.email 문자열 필수 고객 이메일 주소입니다. EAN(travelnow.com) 확인 이메일이 이 주소로 자동 전송됩니다. 통합에서 이 필드를 내부 전용으로 취급하더라도 반드시 유효한 이메일 주소여야 합니다.
@ 및 마침표(.)를 포함한 전체 주소는 최대 50자입니다.
ReservationInfo.firstName 문자열 필수 신용카드 보유자의 이름입니다.
최대 25자이며 호칭이나 기업명을 사용할 수 없습니다.
ReservationInfo.lastName 문자열 필수 신용카드 보유자의 성입니다.
최대 40자이며 호칭이나 기업명을 사용할 수 없습니다.
ReservationInfo.homePhone 문자열 필수

고객 집 전화번호입니다. 예약 문제를 해결하기 위해 고객에게 문의해야 하는 경우 고객 서비스 대행사에서 사용합니다.

숫자는 5자리 이상이어야 합니다. 문자를 0-9, +, - 및 ( ) 등으로만 제한합니다.

ReservationInfo.workPhone 문자열 필수 아님 고객의 직장 전화번호입니다. 숫자는 5자리 이상이어야 합니다. 문자를 0-9, +, - 및 ( ) 등으로만 제한합니다.
ReservationInfo.extension 문자열 필수 아님 고객의 직장 전화 내선번호입니다(해당하는 경우). 최대 5자입니다.
ReservationInfo.faxPhone 문자열 필수 아님 고객의 팩스 번호입니다. 숫자는 5자리 이상이어야 합니다. 문자를 0-9, +, - 및 ( ) 등으로만 제한합니다.
ReservationInfo.companyName 문자열 필수 아님 직원 출장 영수증 또는 세금 목적으로 필요한 경우 회사 이름
ReservationInfo.creditCardType 문자열 필수 사용된 신용카드 유형입니다. 신용카드 유형 및 검증 시 세부내역에 대한 특정 값은 이 페이지를 검토하십시오.
ReservationInfo.creditCardNumber 문자열 필수 고객 신용카드 번호입니다.
ReservationInfo.creditCardIdentifier 문자열 필수 카드 뒷면에 있는 신용카드 식별 번호 또는 카드 보안 값(CSV 또는 CVV)입니다. 고객이 입력한 뒤 예약을 시도한 후에는 이 값을 저장하면 안 됩니다.
ReservationInfo.creditCardExpirationMonth 문자열 필수 신용카드 만료 월이며 MM 형식입니다.
ReservationInfo.creditCardExpirationYear 문자열 필수 신용카드 만료 연도이며 YYYY 형식입니다.
주소 정보
카드 소유자의 주소 정보는 ReservationInfo의 결제 카드 세부 정보와 별도로 개체에 전송됩니다. 정적 테스트 예약 수행을 위한 개발 과정에서 특수한 값이 이 개체에 사용될 수 있습니다.
이름 필수 설명
AddressInfo 개체 필수 카드 소유자의 주소 정보를 포함합니다. 성공적인 처리를 위해 이 정보가 결제 시 사용된 신용카드 제공업체의 기록과 일치해야 합니다.
AddressInfo.address1 문자열 필수 고객 상세 주소이며 최대 28자입니다. 특수문자는 적절하게 인코딩되어야 합니다.
AddressInfo.address2 문자열 필수 아님 상세 주소의 두 번째 줄로(선택 사항), 최대 28자입니다.
AddressInfo.address3 문자열 필수 아님 상세 주소의 세 번째 줄로(선택 사항), 최대 28자입니다.
city 문자열 필수 고객 거주 도시입니다.
stateProvinceCode 문자열 US,
CA, AU에 대해 필수
시/도를 나타내는 두 자리의 코드로, 지정된 도시를 포함합니다. 호주의 경우 아래의 특수 코드를 사용해야 합니다.

참조:
미국 주 코드
캐나다 주/준주 코드
오스트레일리아 주/준주 코드
  • 오스트레일리아 수도 - AC
  • 뉴사우스웨일즈 - NW
  • 노던 주 - NO
  • 퀸즈랜드 - QL
  • 사우스오스트레일리아 - SA
  • 태즈메이니아 - TS
  • 빅토리아 - VC
  • 웨스턴 오스트레일리아 - WT
countryCode 문자열 필수 국가를 나타내는 두 자리의 ISO-3166 코드이며 지정된 도시를 포함합니다. ISO-3166 디코딩 표에 "공식적으로 지정"된 국가 코드만 사용합니다.
postalCode 문자열 필수 고객의 청구지 우편 번호입니다. 최대 10자. 미국 예약에는 5자리 디지털 우편 번호만 사용해야 합니다.
이 값이 신용카드 제공업체의 기록과 반드시 일치해야 예약이 유효합니다.
이 필드를 "청구지 우편 번호"로 표시하여 오류를 방지하십시오. 유효한 문자는 영숫자, 공백, 밑줄(_), 하이픈(-)입니다.


예약 응답
요청된 객실이 예약되었음을 확인하거나 예약이 확인되지 않은 경우 예약 상태에 대한 정보를 제공합니다.

예약에 성공했음을 알리는 응답에는 고객의 일정 번호, 확인 번호, 객실 선택 확인 및 결제한 요금이 포함됩니다.

이 응답에는 고객 데이터가 포함되어 있으므로 HTTPS를 통해 보안을 유지한 상태로 사용자에게 데이터를 반환합니다.

응답 컨텐츠
상위 요소: HotelRoomReservationResponse


이름 설명
itineraryId 정수(Long) 예약에 대한 EAN의 고유 ID입니다.

EAN 또는 자체 고객 서비스 부서에서 고객에게 연락할 때 예약 확인 번호와 함께 사용됩니다. 두 값 모두 고객에게 제대로 전달되어야 합니다.
confirmationNumbers 배열

예약 확인 번호로, 예약한 객실당 1개의 번호가 부여되며 EAN의 예약 데이터베이스에서 생성되었습니다

이 값은 EAN과 고객의 모든 통신에서 일정 ID와 함께 사용됩니다. 자체 이메일을 보내고 EAN 지원을 사용하는 경우(자체 상담원이 없는 경우) 두 값을 모두 확실히 고객에게 제공하도록 하십시오. 상담원 대 상담원 지원을 사용하는 경우 이 값을 고객에게 제공하지 마십시오.

복수 객실 예약에는 첫 번째 객실에 대한 표준 확인 번호가 반환됩니다. 나머지 객실에는 동일한 확인 번호에 하이픈과 1부터 시작하는 번호가 추가됩니다. 예: 120467481181, 120467481181-1, 120467481181-2

processedWithConfirmation 부울 예약이 처리되었을 때 호텔에서 직접 예약을 확인했음을 나타냅니다.

false로 반환된 경우 숙박업소가 아직 예약 확인 번호를 반환하지 않았다는 뜻입니다. 예약은 주로 PS 상태로 반환됩니다.

이러한 경우 EAN 대행사가 예약이 완전히 확인될 때까지 모니터링합니다. 확인 번호가 제공되는 즉시 대행사가 이를 전달한다는 사실을 고객에게 확인 이메일로 안내합니다.
errorText 문자열 EanWSError 공통 요소의 콘텐츠 외에 예약 처리 중에 발생할 수 있는 오류 텍스트입니다.
hotelReplyText 문자열 예약 시 호텔로부터 수신하는 추가 정보
supplierType 문자열 예약을 처리하는 데 사용하는 공급업체 시스템을 확인합니다.
reservationStatusCode 문자열 예약 시 공급업체 시스템상의 예약 상태를 나타냅니다. 확인되지 않은 모든 값에 대해 적절한 고객 메시지를 예측합니다.

값:
CF 확인됨
CX 취소됨
UC 확인되지 않음. 이 상태는 DT와 동일하게 취급합니다. 실시간 예약에는 API에 의해 이 상태가 할당되지 않습니다.
PS 보류 중인 공급업체. 보류 중인 처리 가이드를 참조하십시오.
ER 오류. 상담원이 예약을 살펴보아야 하거나 신용카드가 거부되었을 때 발생합니다. 신용카드 오류가 반환되면 고객에게 적절히 알리십시오. 고객이 다시 예약을 시도하면 실패한 예약 응답에서 반환된 itineraryId를 다시 보내십시오.
DT 삭제된 일정. 일반적으로 테스트 또는 실패한 예약을 가리킵니다.
existingItinerary 부울 중복 예약을 방지하기 위한 지표로, affiliateConfirmationId 요청 매개변수와 함께 사용됩니다. 동일한 확인 값이 두 번 이상 전송된 경우 기존의 성공적인 일정과 함께 true로 반환됩니다.
numberOfRoomsBooked 정수 예약된 객실 수를 확인합니다. 반환된 확인 번호에 있는 개수와 일치해야 합니다.
drivingDirections 문자열 일반적으로 비어 있으며, 표시하지 않는 것이 좋습니다.
checkInInstructions 문자열 호텔의 체크인 지침.
specialCheckInInstructions 문자열 숙박 시설에 예정 도착 시간 알림 요건 등과 같이 중요한 체크인 정보가 포함됩니다. 기본 체크인 지침과 동일한 영역에 이 정보를 표시합니다.
arrivalDate 문자열 체크인 날짜 확인
departureDate 문자열 체크아웃 날짜 확인
hotelName 문자열 예약된 호텔 이름
hotelAddress 문자열 호텔 위치 주소
hotelCity 문자열 호텔이 위치한 도시
hotelStateProvinceCode 문자열 시/도를 나타내는 두 자리의 코드로, 지정된 도시를 포함합니다. 미국, 캐나다 및 호주 국가 코드인 경우에만 반환됩니다.

참조:
미국 주 코드
캐나다 주/준주 코드
오스트레일리아 주/준주 코드
hotelCountryCode 문자열 호텔이 위치한 국가를 나타내는 두 자리의 ISO-3166 코드입니다.
hotelPostalCode 문자열 호텔 우편 코드
roomDescription 문자열 예약된 객실에 대한 간단한 설명
rateOccupancyPerRoom 정수 예약된 객실에 몇 명의 투숙객이 보장되는지 확인합니다.
RoomGroup 개체 투숙객 및 객실 수를 정의하는 Room 배열의 컨테이너입니다. 예약된 모든 객실의 투숙객 및 침대 세부정보를 확인합니다.
RoomGroup.Room 배열 노드의 번호가 numberOfRoomsBooked 값과 일치합니다.
Room.numberOfAdults 정수 객실의 성인 투숙객 수입니다.
Room.numberOfChildren 정수 객실의 아동 투숙객 수입니다.
Room.childAges 쉼표로 구분된
정수 목록
어린이 투숙객의 연령입니다(해당하는 경우).
Room.firstName 문자열 예약 시 체크인하는 투숙객의 이름입니다.
Room.lastName 문자열 예약 시 체크인하는 투숙객의 성입니다.
Room.bedTypeId 문자열 고객이 선택한 침대 코드입니다(선택하지 않은 경우 단일 값).
Room.bedTypeDescription 문자열 침대 유형 선택을 확인하는 설명입니다.
Room.numberOfBeds 정수 1 또는 2의 값입니다.
Room.smokingPreference 문자열 요청된 흡연/비흡연 선택을 확인합니다.
Room.ChargeableNightlyRates 배열 객실의 NightlyRate 배열에 대한 컨테이너입니다. 반환되는 요금은 개별 객실에 특정하며 숙박 기간에 걸쳐 순차적으로 반환됩니다.

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

minorRev=29 이상에 대해서 반환됩니다.
ChargeableNightlyRates.NightlyRate 개체

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

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

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

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

특성:

promo 부울 숙박 요금에 프로모션 요금이 적용되었는지 나타냅니다.
rate 문자열 프로모션이 적용된 이후의 숙박비입니다(해당하는 경우).
baseRate 문자열 프로모션이 적용되기 전의 숙박비입니다(해당하는 경우).
ChargeableNightlyRates.
ConvertedNightlyRates
개체 고객이 요청한 통화로 변환된 요금 정보입니다. 요청된 통화가 호텔에서 비용 청구할 수 없는 통화이거나 고객의 시장 지역 내의 통화인 경우에만 반환됩니다. ChargeableNightyRates와 동일한 특성을 포함합니다. minorRev=29 이상에 대해서 반환됩니다.
RateInfos 다음에 대한 컨테이너: RateInfo 개별 객실에 대해 상세 요금 정보를 제공하는 RateInfo 요소의 배열을 포함합니다.

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

특성:
priceBreakdown부울 청구된 전체 요금 내역에 세금과 총금액이 포함되어 있는지 나타냅니다.
promo 부울 반환된 요금이 프로모션 요금인지 나타냅니다.
rateChange 부울 투숙 기간 동안 하루 이상의 숙박비가 다른 날과 다른지 나타냅니다.
RateInfo.cancellationPolicy 문자열 숙박업소의 취소 정책이며, 반드시 표시해야 합니다.
RateInfo.CancelPolicyInfoList 배열 취소 정책의 구체적인 내용은 일반적으로 위약금 부과 기간을 결정하는 시간과 취소 시 발생하는 위약금입니다.
CancelPolicyInfo 배열의 세부정보 검토
RateInfo.nonRefundable 부울 객실 응답에 반환된 값을 확인합니다. 예약에 성공했음을 알리는 응답에 true가 반환된 경우, 청구된 총액이 최종 금액이 됩니다. Expedia Collect에만 해당합니다.
RateInfo.ChargeableRateInfo 개체 이 개체의 특성은 요금 평균 및 총금액뿐 아니라 예약에 대해 청구된 총금액을 포함합니다. 개별 숙박비와 추가 요금에 세부정보를 제공하는 개체 내 노드입니다.

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

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

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

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


참고: SalesTaxHotelOccupancyTax 추가요금 유형은 뉴욕 주 법률에 따라 표시되어야 합니다. 최종 가격 내역에 이 값을 별도로 표시합니다.
RateInfo.HotelFees 배열

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

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

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

반환된 요금은 1박 또는 객실당 요금으로 표시된 요금을 포함하여 예약 전체에 대한 값입니다. 예: 1박에 10달러의 요금으로 4박 투숙 시 40.00 값으로 표시됩니다.

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

HotelFees.HotelFee 없음

설명, 총금액, 단일 요금의 통화에 대한 특성을 포함합니다.

VAT, 시/도 세금, 리조트 요금 또는 합법적으로 피할 수 없는 그 외 요금의 합계에 대한 세부정보입니다.

ChargeableRateInfocurrencyCode 특성에서 나타내는 예약 가능한 통화에 반환되는 청구입니다.

특성:

description 문자열 청구 유형(예: VAT 또는 리조트 요금)입니다.
amount 문자열 청구에 대한 총합입니다.


ValueAdds 다음에 대한 컨테이너: ValueAdd 예약에 제공되는 모든 부가 서비스를 포함합니다. 개별 부가 서비스의 개수를 나타내기 위해 size 특성을 포함합니다.

minorRev=28 이상에서 사용 가능합니다.
ValueAdds.ValueAdd 배열

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

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

ConvertedRateInfo 개체 고객이 요청한 통화로 변환된 요금 정보입니다. 청구 가능한 통화와 변환된 통화가 다른 경우에만 반환됩니다(예: 호텔이 고객이 요청한 통화를 수용할 수 없는 경우). ChargeableRateInfo와 동일한 특성을 포함합니다.
이 개체에서 반환되는 값은 예약할 수 없습니다. 변환된 값으로 예약을 시도하면 오류가 발생합니다.
RoomGroup 개체 제공된 요금에 적용할 때 동일한 RoomGroup 개체의 컨텐츠가 요청에 전송되었는지 확인합니다.