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>, обновление любого ранее заданного ограничения заменяет только значение этого ограничения, а добавление нового ограничения не влияет на другие ранее заданные ограничения. Например, если ранее была задана минимальная длительность пребывания в два дня, а затем в новом сообщении была указана только максимальная длительность пребывания в семь дней, то это действие не приведет к удалению предыдущего значения минимальной длительности пребывания.

Элементы и атрибуты

Сообщение 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 Аккаунт партнера для этого сообщения. Это строковое значение Partner key, указанное на странице Настройки аккаунта в Hotel Center.

Примечание. Если у вас есть сервер, который предоставляет фиды для нескольких аккаунтов, это значение должно совпадать со значением атрибута partner сообщения Transaction (Property Data) и значением атрибута 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, исключаются (фактически они отфильтровываются из дат в пределах начальной и 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> в сообщении Transactions (Property Data).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string Уникальный идентификатор тарифного плана. Этот идентификатор сопоставляется со значением <PackageID> в сообщении Transaction (Property Data). Тарифный план определяется и упоминается в элементе <StatusApplicationControl> в сообщениях <OTA_HotelRateAmountNotifRQ> и <OTA_HotelAvailNotifRQ>.

Атрибут RatePlanCode не применяется и не должен указываться, если <AvailStatusMessage> содержит атрибут BookingLimit. Необходимо указать, если задано свойство <RestrictionStatus> или <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay Контейнер для определения ограничений по продолжительности проживания. Нельзя использовать, если в <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" равна одной ночи проживания.
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

Значения Open и Close совместимы со всеми значениями элемента <Restriction>. Если значения Open и Close используются вместе со значениями Arrival и Departure, они ограничивают определенные даты в маршруте для регистрации заезда и выезда соответственно.

  • Open и Close с Arrival: Эта комбинация указывает, в какие даты маршрута доступна регистрация.
  • Open и Close с Departure: эта комбинация указывает, какие даты в маршруте доступны для выезда.

    • Дата Arrival не ограничивает доступность номеров на ночи после даты заезда.

    Например, если заезд закрыт со 2 по 4 апреля, то забронировать номер на период с 1 по 4 апреля все равно можно.

    Примечание

    • По умолчанию Master для всех товаров используется значение Close. Это можно сделать в разделе "Доступность по умолчанию" в настройках цен Hotel Center. Значение Closed (Закрыто) в Hotel Center соответствует значению 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.

    Например, если гость планирует остановиться на три ночи с 1 апреля, то полная программа пребывания – с 1 по 4 апреля. Для ночей с 1 по 3 апреля значение Status должно быть равно Open, а значение Restriction – Master. Последний день пребывания (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 указывает, что бронирование должно быть выполнено за шесть часов до окончания даты прибытия (то есть до 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>

    Продолжительность пребывания в больнице

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

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


    Открыть даты поступления

    Открыть доступность для типа номера и тарифного плана на указанные даты.

    Примечание. Чтобы цены были доступны, также необходимо указать стоимость за ночь и количество номеров определенного типа (больше нуля).

    <?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 Код ошибки 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>