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 .

Элемент/@Атрибут События Тип Описание
OTA_HotelAvailNotifRQ 1 Complex element Корневой элемент сообщения, определяющего доступность стоимости номера.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) Пространство имен XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string Уникальный идентификатор этого сообщения запроса. Это значение возвращается в ответном сообщении. Допустимые символы: az , AZ , 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 Партнерский аккаунт для этого сообщения. Это строковое значение представляет собой значение Partner key , указанное на странице настроек учетной записи в Hotel Center.

Примечание. Если у вас есть серверная часть, которая предоставляет каналы для нескольких учетных записей, это значение должно совпадать со значением атрибута partner вашего сообщения транзакции (данные о собственности) и значением атрибута ID в элементе <RequestorID> вашего сообщения <OTA_HotelRateAmountNotifRQ> для тот же аккаунт.

OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages Контейнер для одного или нескольких элементов <AvailStatusMessage> .
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string Уникальный идентификатор свойства. Это значение должно соответствовать идентификатору отеля, указанному с помощью <id> в элементе <listing> в фиде списка отелей. Идентификатор отеля также указан в 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 исключаются (по сути, они отфильтровываются из дат в полях Start и 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> в сообщении транзакции (данные свойства). Тарифный план дополнительно определяется и упоминается в <StatusApplicationControl> в сообщениях <OTA_HotelRateAmountNotifRQ> и <OTA_HotelAvailNotifRQ> .

Атрибут RatePlanCode неприменим и не должен указываться, если <AvailStatusMessage> содержит атрибут BookingLimit . Необходимо указать, если указаны <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 Единица измерения продолжительности пребывания. Обратите внимание, что нулевое значение не рассматривается как отсутствие ограничений. Например, <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 основаны на режиме ожидания. Максимальные значения должны быть больше или равны минимальным значениям.
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 Последовательность символов Y и N , указывающая, разрешена ли каждая продолжительность пребывания: от одной ночи до значения в FixedPatternLength . Любая продолжительность пребывания, превышающая 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 указывает, что бронирование должно произойти за шесть часов до окончания даты прибытия (т. е. 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 указывает, что бронирование не может произойти ранее 18:00, за 30 дней до даты прибытия.

Примеры

Дата прибытия ЛС

Установите минимальную и максимальную продолжительность пребывания (в зависимости от даты прибытия).

<?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

Установка Time="0" в <LengthOfStay> указывает на отсутствие ограничений на указанную продолжительность пребывания. Например, <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 для данного типа номера.

<?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

Установите полное ограничение продолжительности пребывания.

Для регистрации заезда 26 июля 2023 г. допускается только период пребывания 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 EWT OpenTravel Alliance (тип предупреждения об ошибке), связанный с ошибкой. Используется только значение 12 (Processing exception) .
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer ERR (код ошибки) OpenTravel Alliance, связанный с ошибкой. Используется только значение 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>