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 rooms left for 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 EWT OpenTravel Alliance (тип предупреждения об ошибке), связанный с ошибкой. Используется только значение 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>