사용 가능 여부 메시지

개요

이용 가능 여부 메시지 (OTA_HotelAvailNotifRQ)는 지정된 여행 일정에 포함된 객실 유형(요금제와 결합된 객실)을 해당 날짜에 판매할 수 있는지를 정의합니다. 재고 메시지를 보낼 때 제품의 재고 또는 제한이 변경되었는지 여부를 나타냅니다.

다음 섹션에서는 일반 가이드라인, 기본 예시, 가용성 메시지를 사용하여 사용 가능 여부를 추가하고 업데이트하는 방법 시나리오를 설명합니다.

1박 이용 가능 여부 제한

이용 가능 여부 메시지를 사용하면 예약의 전반적인 이용 가능 여부를 제어하는 제한사항을 정의할 수 있습니다. 주목할 만한 제한 유형 중 하나는 '야간 재고 수량', 즉 제품을 특정 날짜에 판매할 수 있는지 여부입니다. 체크인부터 체크아웃까지 숙박을 예약하려면 모든 날짜에 1박 이용이 가능해야 하고 다른 모든 예약 및 숙박 제한을 충족해야 합니다.

제한사항 설정

기본적으로 Restriction="Master"의 RestrictionStatus는 닫혀 있습니다. 즉, 기본적으로 매일 밤 '판매 중단'이 있습니다.

판매 가능하려면 숙박 기간 내내 모든 제품 조합에 대해 <RestrictionStatus Restriction="Master" Status="Open">이(가) 있어야 합니다. 각 제품에 대한 명시적 Open를 Google에 전송하거나 Hotel Center에서 기본값을 변경해야 합니다. Hotel Center에서 가격 책정 > 설정 페이지로 이동하여 '기본 이용 가능 여부' 필드를 수정하면 됩니다.

기타 제한사항

도착/출발
지정된 날짜에 도착 또는 출발하는 여행 일정의 판매를 방지합니다. 기본값은 Open입니다.
최소 및 최대 예약 오프셋
도착 예정일 최소 또는 최대 일정 기간 전에 일정을 구매해야 합니다.
최소 및 최대 숙박 기간
도착 날짜가 이 날짜인 숙박 일정의 숙박 기간을 제한합니다.
최소 및 최대 전방 숙박 (또는 '숙박')
이 숙박 날짜가 포함된 숙박 일정의 숙박 기간을 제한합니다.
숙박 기간 패턴
이 도착 날짜에 허용되는 숙박 기간을 정확하게 관리할 수 있습니다.

일반 가이드라인

  • 이용 가능 여부 제한은 호텔, 날짜, 객실 유형, 요금제에 따라 키가 지정됩니다.

  • 숙박 기간 (체크인부터 체크아웃까지)에 적용되는 제한사항이 없거나 사용자가 숙박을 예약할 수 있는 경우에만 제품을 예약할 수 있습니다.

  • 특정 날짜에 제품의 재고 제한이 변경될 때마다 Google에 이용 가능 여부 메시지 업데이트를 전송합니다.

예

이 섹션에서는 필수 및 선택적 요소를 사용하여 가용성 메시지의 기본 예를 제공합니다. 파일이 준비되면 다음 엔드포인트에 POST 메시지를 통해 Google에 파일을 보내야 합니다.

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

메시지를 푸시/POST하는 방법에 관한 자세한 내용은 메시지 푸시를 참조하세요.

HotelCode의 경우 시스템 내에서 속성을 식별하기 위해 사용한 고유한 호텔 ID를 사용합니다. 이 값은 호텔 목록 피드의 <listing> 요소에서 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. Google에서 데이터를 올바르게 표시하려면 시스템과의 일관성이 중요합니다.

다음 예에서는 참석 여부 제한을 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

더 많은 예는 사용 가능 여부 예시를 참고하세요.

방법

이 섹션에서는 이용 가능 여부 메시지를 전송하는 동안 발생할 수 있는 시나리오에 관한 솔루션, 특히 야간 이용 가능 여부 제한('판매 중단'이라고도 함)에 관한 세부정보를 제공합니다.

시나리오 1: 특정 날짜에 제품 판매 방법

설명

특정 날짜에 객실 유형 및 요금제 조합 (제품)을 사용할 수 있도록 설정하려고 합니다.

해결 방법

Master 제한을 Open로 설정하고 날짜를 지정합니다.

샘플

이 샘플은 3월에 몇 주 동안 제품의 야간 재고를 여는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

가격 책정 설정 방법에 대한 자세한 내용은 누락되거나 불완전한 가격 책정 문제 해결을 참조하세요.

시나리오 2: 특정 날짜에 제품 판매를 중지하는 방법

설명

특정 날짜에 재고가 없는 것이 아니라 제품 판매를 명시적으로 중지하려고 합니다.

해결 방법

Master 제한을 Close로 설정하고 날짜를 지정합니다.

샘플

이 샘플은 지정된 날짜에 제품의 '판매 중단' 또는 야간 재고를 종료하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>