OTA_호텔AvailNotifRQ

요청

문법

OTA_HotelAvailNotifRQ 메시지는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

요소 및 속성

OTA_HotelAvailNotifRQ 메시지에는 다음과 같은 요소와 속성이 있습니다.

참고: 각 숙박 기간 제한 유형은 독립적으로 설정됩니다. 예를 들어 SetMaxLOS를 설정하는 메시지는 이전에 SetForwardMaxStay에 정의된 값을 덮어쓰지 않습니다.

요소 / @Attribute 발생 횟수 유형 설명
OTA_HotelAvailNotifRQ 1 Complex element 객실 요금 이용 가능 여부를 정의하는 메시지의 루트 요소입니다.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) XML 네임스페이스입니다.
OTA_HotelAvailNotifRQ / @EchoToken 1 string 이 요청 메시지의 고유 식별자입니다. 이 값은 응답 메시지에 반환됩니다. 허용되는 문자는 a-z, A-Z, 0-9, _ (밑줄), - (대시)입니다.
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime 이 메시지의 생성 날짜 및 시간입니다.
OTA_HotelAvailNotifRQ / @Version 1 decimal OpenTravel 메시지 버전입니다.
OTA_HotelAvailNotifRQ / POS 0..1 POS 이 메시지의 파트너 계정을 지정하기 위한 컨테이너입니다. 일반적으로 백엔드에서 여러 파트너 계정에 가격 피드를 제공하는 경우 사용됩니다.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source <POS>가 있는 경우 필수입니다. <RequestorID>의 컨테이너입니다.
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID <POS>가 있는 경우 필수입니다. 파트너 계정을 정의합니다.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string 이 메시지의 파트너 계정입니다. 이 문자열 값은 Hotel Center의 계정 설정 페이지에 표시된 Partner key 값입니다.

참고: 여러 계정에 피드를 제공하는 백엔드가 있는 경우, 이 값은 동일한 계정에 대한 거래 (숙박 시설 데이터) 메시지의 partner 속성 값과 <OTA_HotelRateAmountNotifRQ> 메시지의 <RequestorID> 요소에 있는 ID 속성 값과 일치해야 합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages 하나 이상의 <AvailStatusMessage> 요소의 컨테이너입니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string 숙박 시설의 고유 식별자입니다. 이 값은 호텔 목록 피드에서 <listing>의 <id> 요소를 사용하여 지정된 호텔 ID와 일치해야 합니다. 호텔 ID는 Hotel Center에도 표시됩니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage 단일 숙박 시설의 다양한 기간에 대한 객실 요금의 이용 가능 여부 및 제한사항을 정의합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer 참고: 이 속성을 설정하는 것보다 OTA_HotelInvCountNotifRQ 메시지를 사용하는 것이 좋습니다.

<StatusApplicationControl>의 기간에 예약할 수 있는 남은 회의실 수입니다. BookingLimit가 지정되면 <StatusApplicationControl>는 InvTypeCode를 지정해야 하며, <AvailStatusMessage>는 <LengthOfStay> 또는 <RestrictionStatus>를 포함할 수 없습니다.

0 이상이어야 합니다. 음수이거나 제공되지 않으면 기본값은 0입니다.

참고: 지정된 <StatusApplicationControl> 설정으로 회의실 이용 가능 여부를 설정하려면 BookingLimit 속성을 한 번 이상 설정해야 합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl 기간과 함께 객실 유형(InvTypeCode) 및 요금제 RatePlanCode에 대한 식별자를 정의합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date 기간을 포함하는 속성의 시간대를 기준으로 한 시작일입니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date 기간을 포함하는 종료일 (속성 시간대를 기준으로 함)입니다. start 값 이상이어야 합니다. start과 end이 같으면 업데이트가 해당 날짜에 적용됩니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean 월요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 'true'로 설정되지 않은 다른 요일은 제외됩니다 (실제로 Start and End). 내 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean 화요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일은 제외됩니다 (실질적으로 Start 및 End 내의 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 수요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일은 제외됩니다 (실질적으로 Start 및 End 내의 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 목요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일은 제외됩니다 (실질적으로 Start 및 End 내의 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 금요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일은 제외됩니다 (실질적으로 Start 및 End 내의 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean 토요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일은 제외됩니다 (실제로 시작일 및 End 내의 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean 일요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일은 제외됩니다 (실질적으로 Start 및 End 내의 날짜에서 필터링됨).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string 인벤토리의 고유 식별자입니다 (객실 유형). 이 값은 트랜잭션(속성 데이터) 메시지의 <RoomID>에 매핑됩니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string 요금제의 고유 식별자입니다. 이 식별자는 트랜잭션 (숙박 시설 데이터) 메시지의 <PackageID> 값에 매핑됩니다. 요금제는 <OTA_HotelRateAmountNotifRQ> 및 <OTA_HotelAvailNotifRQ> 메시지 모두의 <StatusApplicationControl>에서 추가로 정의되며 참조됩니다.

<AvailStatusMessage>에 BookingLimit 속성이 포함된 경우 RatePlanCode 속성을 적용할 수 없으며 지정해서는 안 됩니다. <RestrictionStatus> 또는 <LengthOfStay>가 지정된 경우 지정해야 합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay LOS 제한사항을 정의하기 위한 컨테이너입니다. <AvailStatusMessage>에 BookingLimit 속성이 포함된 경우 있으면 안 됩니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer FullPatternLOS에 정의된 패턴의 길이입니다.

참고: 이 속성은 MinMaxMessageType="FullPatternLOS"를 사용할 때 설정해야 하며 그렇지 않은 경우에는 없습니다.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay 숙박 기간에 대한 제한을 정의합니다. <LengthOfStay> 요소를 두 개 이상 사용하는 경우 각각 다른 MinMaxMessageType 값을 지정해야 합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer 숙박 기간의 단위 값입니다. 값이 0이면 제한이 없는 것으로 간주됩니다. 예를 들어 <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS">는 최대 숙박 기간이 없음을 의미합니다.

참고: 이 속성은 MinMaxMessageType="FullPatternLOS"를 사용하지 않는 한 설정해야 합니다.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum 시간 단위입니다. 제공하지 않은 경우 기본값은 "Day"입니다. 유효한 값은 다음과 같습니다.
  • Day
참고: "Day" 단위 1개는 1박에 해당합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum 다양한 유형의 숙박 기간 제한입니다. SetMaxLOS, SetMinLOS, FullPatternLOS는 도착을 기준으로 합니다. SetForwardMinStay 및 SetForwardMaxStay는 연결 유지 기반입니다. 최댓값은 최솟값 이상이어야 합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern 숙박 기간 제한 패턴을 정의합니다.

참고: 이 요소는 MinMaxMessageType="FullPatternLOS"를 사용할 때는 있어야 하고 그렇지 않은 경우에는 없어야 합니다.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string 1박부터 FixedPatternLength 값까지 각 숙박 기간의 허용 여부를 나타내는 Y 및 N 문자 시퀀스입니다. 숙박 기간이 FixedPatternLength보다 길면 최종 위치의 값이 상속됩니다. 예를 들어 FixedPatternLength="4" 및 FullPatternLOS="YNYN"의 경우 숙박 기간 1과 3만 허용됩니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus 운항 일정 제한을 정의합니다. <AvailStatusMessage>에 BookingLimit 속성이 포함된 경우 있으면 안 됩니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum Restriction 속성으로 지정된 제한 유형이 개방형인지 폐쇄형인지를 나타냅니다. 유효한 값은 다음과 같습니다.
  • Open
  • Close

참고:

  • 기본적으로 Google은 모든 제품의 Master 설정이 Close이라고 가정합니다. Hotel Center 가격 책정 설정의 '기본 이용 가능 여부'를 통해 구성할 수 있습니다. Hotel Center의 '폐쇄' 값은 여기서 Close 값에 해당합니다.
  • Master를 Close로 설정하는 것을 '판매 중단'이라고 합니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

Status가 제공된 경우 이 속성은 필수입니다.

유효한 값은 다음과 같습니다.

  • Arrival: 이 값은 체크인 날짜가 Start 및 End 기간(양 끝값 포함)인 숙박 일정을 차단합니다.
  • Departure: 이 값은 Start 및 End 기간 중 체크아웃 날짜가 있는 운항 일정을 차단합니다.
  • Master: 이 값은 해당 날짜에 객실 요금을 예약할 수 있는지 여부를 나타냅니다.

참고: Restriction를 지정하지 않으면 기본값은 Master입니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration 이 객실 요금을 예약할 수 있는 도착 날짜 전의 최소 기간 (숙박 시설의 현지 시간 기준)입니다.

유효한 값 유형은 다음과 같습니다.

  • Integer: 도착일까지 남은 일 수입니다. 예를 들어 값이 1이면 객실 요금을 도착일로부터 최소 하루 전에 예약해야 함을 나타냅니다. 값 0 (기본값)은 최근 예약 시간에 대한 제한이 없음을 나타냅니다.
  • ISO 8601 Duration (days, hours, and minutes): 도착 날짜로부터의 일수 (선택사항, 시간/분)입니다. 예를 들어 값이 P1D이면 객실 요금을 도착일 하루 전에 예약해야 함을 나타냅니다. 값이 P0DT6H인 경우 도착 날짜가 끝나기 6시간 전 (예: 18:00) 이전에 예약해야 함을 나타냅니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration 이 객실 요금을 예약할 수 있는 도착 날짜 전의 최대 기간 (숙박 시설의 현지 시간 기준)입니다.

유효한 값 유형은 다음과 같습니다.

  • Integer: 도착일까지 남은 일 수입니다. 예를 들어 값 30은 도착일 30일 전에는 객실 요금을 예약할 수 없음을 나타냅니다. 값 0 (기본값)은 가장 빠른 예약 시간에 대한 제한사항이 없음을 나타냅니다.
  • ISO 8601 Duration (days, hours, and minutes): 도착일 전의 일수 (및 선택적으로 시간/분)입니다. 예를 들어 값 P30D은 도착 날짜로부터 30일 전에는 객실 요금을 예약할 수 없음을 나타냅니다. 값 P30DT6H은 도착일 30일 전인 18:00 전에는 예약할 수 없음을 나타냅니다.

예

LoS 도착일

도착 날짜를 기준으로 최소 및 최대 숙박 기간을 설정합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

LoS 기간

숙박 일수를 기준으로 최소 및 최대 숙박 기간을 설정합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

출발 제한

출발 마감 시간을 설정합니다. (이렇게 하면 지정된 날짜에 체크아웃이 있는 운항 일정을 방지할 수 있습니다.)

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

도착 제한

도착 폐쇄 제한을 설정합니다. 이렇게 하면 지정된 날짜에 체크인할 수 없습니다.

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

예약 가능 날짜

지정된 날짜의 객실 유형 및 요금제 예약 가능 여부를 확인합니다.

참고: 가격이 완전히 제공되기 전에 객실 요금과 함께 객실 유형의 인벤토리 수가 0보다 큰 경우에도 1박 요금이 필요합니다.

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


서비스 제공 날짜 닫기

지정된 날짜에 객실 유형 및 요금제의 이용 가능 여부를 닫습니다. 이를 '판매 중단'이라고도 합니다.

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

사전 예약 제한

주말에만 적용되는 최소 및 최대 사전 예약 기간 제한을 설정합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

예약 마감

호텔 현지 시간을 기준으로 도착 날짜 18:00에 예약 마감 시간을 적용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

여러 제한사항

객실 유형 및 요금제에 대해 같은 날짜에 여러 조건을 설정할 수 있습니다.

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


예약 한도

지정된 날짜의 객실 유형에 대한 인벤토리 수를 설정합니다.

참고: 이 속성을 설정하는 것보다 OTA_HotelInvCountNotifRQ 메시지를 사용하는 것이 좋습니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

전체 패턴 숙박 기간 제한을 설정합니다.

2023년 7월 26일에 체크인하는 경우 숙박 기간 2, 4, 6까지만 허용됩니다. 숙박 기간 1, 3, 5, 7+는 사용할 수 없습니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

응답

문법

OTA_HotelAvailNotifRS 메시지는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

요소 및 속성

OTA_HotelAvailNotifRS 메시지에는 다음과 같은 요소와 속성이 있습니다.

요소 / @Attribute 발생 횟수 유형 설명
OTA_HotelAvailNotifRS 1 Complex element 이용 가능 여부 메시지에 대한 응답의 루트 요소입니다.
OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime 이 메시지의 생성 날짜 및 시간입니다.
OTA_HotelAvailNotifRS / @EchoToken 1 string 연결된 OTA_HotelAvailNotifRQ 메시지의 고유 식별자입니다.
OTA_HotelAvailNotifRS / Success 0..1 Success OTA_HotelAvailNotifRQ 메시지가 성공적으로 처리되었음을 나타냅니다.

각 메시지에 <Success> 또는 <Errors>가 있습니다.
OTA_HotelAvailNotifRS / Errors 0..1 Errors OTA_HotelAvailNotifRQ 메시지를 처리하는 동안 발생한 하나 이상의 문제에 대한 컨테이너입니다.

각 메시지에 <Success> 또는 <Errors>가 있습니다.
OTA_HotelAvailNotifRS / Errors / Error 1..n Error OTA_HotelAvailNotifRQ 메시지를 처리하는 동안 발생한 오류의 설명입니다. 이러한 오류에 대한 자세한 내용은 피드 상태 오류 메시지에서 확인할 수 있습니다.
OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer 오류와 관련된 OpenTravel Alliance EWT (오류 경고 유형)입니다. 12 (Processing exception) 값만 사용됩니다.
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer 오류와 관련된 OpenTravel Alliance ERR (오류 코드)입니다. 450 (Unable to process) 값만 사용됩니다.
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum 원래 요청의 상태입니다. NotProcessed 값만 사용됩니다.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string 문제의 Google 식별자입니다. 이러한 오류에 대한 자세한 내용은 피드 상태 오류 메시지에서 확인할 수 있습니다.

예

성공

다음은 성공적으로 처리된 OTA_HotelAvailNotifRQ 메시지에 대한 응답입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

오류

다음은 오류로 인해 처리되지 않은 OTA_HotelAvailNotifRQ 메시지에 대한 응답입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>