사용 가능 여부 메시지

개요

재고 메시지 (OTA_HotelAvailNotifRQ)는 특정 여정의 제품(요금제와 결합된 객실 유형)을 해당 날짜에 판매할 수 있는지를 정의합니다. Availability 메시지를 전송하면 제품의 재고 상태 또는 제한사항이 변경되었는지 여부를 나타냅니다.

다음 섹션에서는 가용성 메시지를 사용하여 가용성을 추가하고 업데이트하는 방법을 시작하는 데 도움이 되는 일반 가이드라인, 기본 예시, 사용 방법 시나리오를 다룹니다.

야간 사용 가능 여부 제한

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

제한 설정

기본적으로 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>