OTA_HotelInvCountNotifRQ

Запросы

Синтаксис

В сообщении OTA_HotelInvCountNotifRQ используется следующий синтаксис:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

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

Сообщение OTA_HotelInvCountNotifRQ содержит следующие элементы и атрибуты:

Элемент / @Атрибут События Тип Описание
OTA_HotelInvCountNotifRQ 1 Complex element Корневой элемент сообщения, определяющего доступность номеров по льготным ценам.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Пространство имен XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Уникальный идентификатор для данного запроса. Это значение возвращается в ответном сообщении. Допустимые символы: az, AZ, 0-9, _ (подчеркивание) и - (тире).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime Дата и время создания этого сообщения.
OTA_HotelInvCountNotifRQ / @Version 1 decimal Версия сообщения OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Контейнер для указания партнерской учетной записи для этого сообщения (обычно используется, если ваша внутренняя система предоставляет ценовые фиды для нескольких партнерских учетных записей).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Обязательно, если присутствует <POS> . Контейнер для <RequestorID> .
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Обязательно, если присутствует <POS> . Определяет учетную запись партнера.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Партнерский аккаунт для этого сообщения. Это строковое значение представляет собой значение ключа «Партнер» , указанное на странице «Настройки учетной записи» в Hotel Center.

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

OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Контейнер для одного или нескольких элементов <Inventory> .
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string Уникальный идентификатор объекта недвижимости. Это значение должно совпадать с идентификатором отеля, указанным с помощью <id> в элементе <listing> ленты списка отелей . Идентификатор отеля также указан в Hotel Center .
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Определяет количество доступных номеров для различных временных диапазонов в рамках одного объекта недвижимости.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Определяет диапазон дат, а также идентификатор типа номера ( InvTypeCode ).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Начальная дата (с учетом часового пояса объекта недвижимости), включая указанный диапазон дат.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Конечная дата (с учетом часового пояса объекта недвижимости), включая дату начала диапазона дат. Должна быть равна или больше start даты. Если start и end равны, обновление применяется к этой дате.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Установите значение true или 1 , чтобы явно включить понедельники.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Установите значение true или 1 , чтобы явно включить вторники.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Установите значение true или 1 , чтобы явно включить среды.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Установите значение true или 1 , чтобы явно включить четверги.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Установите значение true или 1 , чтобы явно включить пятницы.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Установите значение true или 1 , чтобы явно включить субботы.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Установите значение true или 1 , чтобы явно включить воскресенья.

Если установлено значение true , то другие дни недели, для которых значение true не указано явно, исключаются (по сути, они отфильтровываются из дат в полях Start и End »).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Уникальный идентификатор для инвентаря (типа номера). Это значение сопоставляется с <RoomID> в сообщении транзакций (данные об объекте недвижимости) .
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Контейнер для определения единого значения инвентаризации.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Определяет количество доступных для бронирования номеров.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Количество доступных номеров, которые можно забронировать для данного типа номера. Значение, равное нулю, означает, что номера данного типа номера распроданы. Отрицательное значение считается равным нулю.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Указанный тип инвентаризации. Допустимое значение:

  • 2 : Гарантированная доступность.

Примеры

Остаток запасов

Устанавливает количество оставшихся комнат (5) для RoomID_1 на указанные даты.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Товар распродан.

В указанные даты все номера в номере RoomID_1 были распроданы.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Ответы

Синтаксис

В сообщении OTA_HotelInvCountNotifRS используется следующий синтаксис:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS 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_HotelInvCountNotifRS>

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

Сообщение OTA_HotelInvCountNotifRS содержит следующие элементы и атрибуты:

Элемент / @Атрибут События Тип Описание
1 Complex element Корневой элемент ответа на сообщение о доступности.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime Дата и время создания этого сообщения.
OTA_HotelInvCountNotifRS / @EchoToken 1 string Уникальный идентификатор из соответствующего сообщения OTA_HotelInvCountNotifRQ .
OTA_HotelInvCountNotifRS / Success 0..1 Success Указывает на то, что сообщение OTA_HotelInvCountNotifRQ было успешно обработано.

В каждом сообщении присутствует либо <Success> , либо <Errors> .

OTA_HotelInvCountNotifRS / Errors 0..1 Errors Контейнер для одной или нескольких проблем, возникших при обработке сообщения OTA_HotelInvCountNotifRQ .

В каждом сообщении присутствует либо <Success> , либо <Errors> .

OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Описание ошибки, возникшей при обработке сообщения OTA_HotelInvCountNotifRQ . Подробную информацию об этих ошибках можно найти в разделе «Сообщения об ошибках состояния ленты» .
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Соответствующий ошибке код ошибки OpenTravel Alliance EWT (Error Warning Type). Используется только значение 12 (Processing exception) .
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Код ошибки (ERR) OpenTravel Alliance, связанный с данной ошибкой. Используется только значение 450 (Unable to process) .
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Статус исходного запроса. Используется только значение NotProcessed .
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Идентификатор проблемы от Google. Подробную информацию об этих ошибках можно найти в разделе «Сообщения об ошибках состояния ленты» .

Примеры

Успех

Ниже приведён ответ на успешно обработанное сообщение OTA_HotelInvCountNotifRQ .

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

Ошибки

Ниже приведён ответ на сообщение OTA_HotelInvCountNotifRQ не обработанное из-за ошибок.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>