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 값은 4월 1~3일 밤 숙박의 경우 Open로 설정해야 하고 Restriction 값은 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>