Эта страница переведена с помощью Cloud Translation API.

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>

Ограничение выезда

Установите запрет на выезд. (Это предотвращает маршруты с выездом в указанные даты.)

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

ФуллпаттернЛос

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

Для регистрации заезда 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>