OTA_HotelAvailNotifRQ

요청

구문

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> 메시지는 델타 업데이트로 취급됩니다. <StatusApplicationControl>에 지정된 각 숙박 시설, 날짜, 객실, 패키지의 경우 이전에 정의된 제한사항을 업데이트하면 동일한 제한사항의 값만 대체되지만 새 제한사항을 추가해도 이전에 정의된 다른 제한사항에는 영향을 미치지 않습니다. 예를 들어 이전에 최소 숙박 기간이 2일로 정의되었는데 최대 숙박 기간이 7일인 새 메시지가 업데이트된 경우 이 작업으로 이전 최소 숙박 기간 값이 삭제되지는 않습니다.

요소 및 속성

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 값 이상이어야 합니다. startend이 동일하면 업데이트가 해당 날짜에 적용됩니다.
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로 설정되지 않은 다른 요일이 제외됩니다 (사실상 StartEnd 내의 날짜에서 필터링됨).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean 수요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일이 제외됩니다 (사실상 StartEnd 내의 날짜에서 필터링됨).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean 목요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일이 제외됩니다 (사실상 StartEnd 내의 날짜에서 필터링됨).

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean 금요일을 명시적으로 포함하려면 true 또는 1로 설정합니다.

true로 설정하면 명시적으로 true로 설정되지 않은 다른 요일이 제외됩니다 (사실상 StartEnd 내의 날짜에서 필터링됨).

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로 설정되지 않은 다른 요일이 제외됩니다 (사실상 StartEnd 내의 날짜에서 필터링됨).

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박 숙박과 같습니다.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum 다양한 유형의 숙박 기간 제한입니다. SetMaxLOS, SetMinLOS, FullPatternLOS는 도착 기반입니다. SetForwardMinStay SetForwardMaxStay는 stay-through 기반입니다. 최댓값은 최솟값 이상이어야 합니다.
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의 값까지 각 숙박 기간이 허용되는지 여부를 나타내는 YN 문자 시퀀스입니다. 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

OpenClose 값은 <Restriction> 요소의 모든 값과 호환됩니다. OpenClose 값이 ArrivalDeparture 값과 함께 사용되면 각각 체크인 및 체크아웃을 위한 여정의 특정 날짜를 제한합니다.

  • Arrival이 있는 OpenClose: 이 조합은 운항 일정에서 체크인할 수 있는 날짜를 지정합니다.
  • OpenClose(Departure 포함): 이 조합은 운항 일정에서 체크아웃할 수 있는 날짜를 지정합니다.
  • Arrival 날짜는 체크인 날짜 이후 숙박 기간의 예약 가능 여부를 제한하지 않습니다.

    예를 들어 4월 1일부터 4일까지의 숙박 중 4월 2일부터 4일까지는 도착이 불가능한 경우에도 예약이 가능합니다.

    참고:

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

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

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

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

    ArrivalDeparture 모두 해당 일정에 이용 가능한 객실이 있어야 합니다. 이전 메시지가 닫혔음을 나타내는 메시지를 전송하지 않은 경우 ArrivalDeparture의 기본값은 Open입니다. 또한 객실/패키지 조합은 숙박 마지막 날을 제외한 여정의 모든 날짜에 이용 가능해야 합니다. 이 사용 가능 여부는 Hotel Center의 기본 설정이나 <Status> 또는 <Restriction> 요소를 통해 설정할 수 있습니다. 기본 설정이 Close인 경우 관련 날짜에 대해 OpenStatus 값과 Masterrestriction 값을 전송하여 일정 날짜의 재고를 다시 열어야 합니다.

    예를 들어 도착일이 4월 1일인 3박 숙박의 경우 전체 숙박 일정은 4월 1일~4일입니다. Status 값은 Open로 설정하고 Restriction 값은 4월 1~3일 야간 숙박에 대해 Master로 설정해야 합니다. 숙박의 마지막 날 (4월 4일)은 Open 상태가 필요한 것은 숙박 날짜뿐이므로 종료됩니다.

    참고: 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일 전 오후 6시 이전에는 예약할 수 없음을 나타냅니다.

    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>
    
    

    LoS 제한 삭제

    <LengthOfStay>에서 Time="0"을 설정하면 지정된 숙박 기간에 제한이 없음을 나타냅니다. 예를 들어 <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>은 최대 숙박 기간 제한이 없음을 의미합니다.

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