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

요소 및 속성

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

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

요소 / @속성 발생 횟수 유형 설명
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

Open 및 Close 값은 <Restriction> 요소의 모든 값과 호환됩니다. Open 및 Close 값이 Arrival 및 Departure 값과 함께 사용되면 숙박 일정에서 각각 체크인 및 체크아웃의 특정 날짜를 제한합니다.

  • Open 및 Close와 Arrival: 이 조합은 숙박 일정에서 체크인할 수 있는 날짜를 지정합니다.
  • Open 및 Close와 Departure: 이 조합은 숙박 일정에서 체크아웃할 수 있는 날짜를 지정합니다.

    • Arrival 날짜는 체크인 날짜 이후 숙박 일수의 예약 가능 여부를 제한하지 않습니다.

    예를 들어 4월 1일~4월 4일 숙박 중 4월 2일~4월 4일은 도착 전에 폐쇄되지만 예약은 가능합니다.

    참고:

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

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

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

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

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

    예를 들어 도착일이 4월 1일인 3박 숙박의 경우 전체 숙박 일정은 4월 1일~4월 4일입니다. 4월 1일~3일의 숙박에 대해 Status 값은 Open로, Restriction 값은 Master로 설정해야 합니다. 숙박 마지막 날 (4월 4일)은 Open 상태가 필요한 숙박 일수에 해당하지 않으므로 닫힙니다.

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

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

    • Integer: 도착일 전까지의 일 수입니다. 예를 들어 값이 1이면 객실 요금을 도착일로부터 최소 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>

    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 메시지에는 다음과 같은 요소와 속성이 있습니다.

    요소 / @속성 발생 횟수 유형 설명
    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>