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 Уникальный идентификатор этого сообщения запроса. Это значение возвращается в ответном сообщении. Допустимые символы: a–z, A–Z, 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 сообщения Transaction (Property Data) и значением атрибута 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> в сообщении Transactions (Property Data).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Контейнер для определения одного количества товаров в ассортименте.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Определяет количество доступных для бронирования номеров.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Количество доступных номеров определенного типа, которые можно забронировать. Значение "0" указывает на то, что все номера этого типа забронированы. Отрицательное значение обрабатывается как ноль.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Тип подсчета инвентаря. Допустимое значение:

  • 2. Товар есть в наличии.

Примеры

Оставшийся инвентарь

Устанавливает, что для RoomID_1 на указанные даты осталось 5 номеров.

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