이용 가능 여부, 요금 및 재고 (ARI) XML 참조

이 XML 참조 가이드에서는 가용성, 요금, 인벤토리 (ARI) 피드에 사용할 수 있는 다양한 메시지, 요소, 속성에 관한 자세한 참조 콘텐츠와 코드 예시를 제공합니다.

ARI는 야간 요금, 예약 가능 여부, 인벤토리를 제어하고 이러한 항목을 결합하는 방법에 관한 제약 조건을 제공하는 가격 게재 모드입니다. ARI는 세금, 수수료, 프로모션을 포함할 수 있는 유연성도 제공합니다.

ARI는 가용성 및 인벤토리를 정의하기 위한 일부 주요 메시지 유형에 대해 OpenTravel Alliance (OTA)의 표준 프로토콜을 따릅니다.

LOS 기반 가격 책정

LOS-based 가격 책정을 사용하면 숙박 날짜가 아닌 체크인 날짜와 숙박 기간별로 요금을 지정할 수 있습니다. LOS 기반 요금 책정에 <StatusApplicationControl> 요소를 지정하면 @Start@End 속성은 LOS 요금이 적용되는 체크인 날짜 범위를 나타냅니다.

숙박 기간 기반 요금을 사용하는 경우 더 이상 야간 요금이 없지만 다른 모든 ARI 기능 (인벤토리, 예약 가능 여부, 규칙, 프로모션 등)은 이러한 요금에 계속 적용할 수 있으며 야간 수준으로 지정됩니다. 즉, 시스템이 LOS 기반 가격 책정 시스템과 더 밀접하게 연관되어 있는 경우에도 야간 가용성 및 제한 업데이트를 활용하여 제공되는 대역폭 효율성 외에도 다양한 ARI 기능 세트를 활용할 수 있습니다.

계정에서 LOS 기반 가격 책정을 사용 설정하려면 TAM에게 문의하거나 Google에 문의하세요.

ARI는 다음 요청 메시지를 사용합니다.

  • Transaction (속성 데이터) 유형 및 패키지(요금제) 정보를 정의합니다.

  • OTA_HotelRateAmountNotifRQ. 특정 기간의 제품 (객실 유형 및 요금제 조합)별 날짜별 또는 LOS 기반 점유율 금액을 정의합니다.

  • OTA_HotelAvailNotifRQ: 객실 유형 및 요금제를 기반으로 가용성 및 제한사항을 정의합니다. 이 메시지를 사용하여 인벤토리를 업데이트할 수도 있지만 OTA_HotelInvCountNotifRQ이 더 좋습니다.

  • OTA_HotelInvCountNotifRQ: 판매 가능한 실제 객실 인벤토리 또는 객실 수를 정의합니다.

  • TaxFeeInfo(선택사항): 숙박 시설별 세금과 수수료를 정의합니다. OTA_HotelRateAmountNotifRQ 메시지에 AmountAfterTax가 지정된 경우 이 메시지는 필요하지 않습니다.

  • Promotions. (선택사항) 특정 예약, 숙박, 사용자의 프로모션 요금을 정의합니다.

  • RateModifications. (선택사항) 특정 예약, 숙박, 사용자의 요금 수정 규칙을 정의합니다.

  • ExtraGuestCharges. (선택사항) 아동 및 추가 성인에 대해 요금을 구성하는 방법을 정의합니다.

각 메시지에는 사용자가 특정 체크인 및 체크아웃 날짜와 숙박 인원으로 숙박 시설을 검색할 때 Google에서 표시되는 가격과 예약 가능 여부를 계산하는 데 사용하는 정보의 하위 집합이 포함됩니다.

ARI XML 참조 수정 기록

다음 표에는 기능 변경사항에 대한 문서 업데이트만 나열되어 있습니다.

날짜 변경사항
2020년 8월 14일 첫 출시입니다.
2020년 10월 21일 프로모션 메시지 유형이 추가되었습니다.
2020년 11월 17일 거래 (숙박 시설 데이터) 메시지의 경우 엔드포인트를 업데이트하고 action 속성을 PropertyDataSet 요소에 추가했습니다.
2020년 11월 24일 거래 (숙박 시설 데이터) 메시지의 경우 <AllowablePackageIDs><AllowableRoomIDs> 요소가 추가되었습니다.
2021년 2월 4일 응답 메시지가 추가되었습니다.
2021년 2월 25일 OTA_HotelInvCountNotifRQ을 추가했습니다.
2020년 10월 21일 요금 수정 메시지 유형이 추가되었습니다.