Инвентарное сообщение

Обзор

Сообщение инвентаризации ( OTA_HotelInvCountNotifRQ ) определяет количество инвентаря (количество физических номеров), доступных для бронирования для определенных типов номеров. Когда вы отправляете сообщение об инвентаризации, вы указываете, сколько номеров этого типа доступно на определенную дату. Если номеров этого типа нет в наличии, продукты, относящиеся к этому типу номера и дате, не будут отображаться.

В следующих разделах описаны общие рекомендации, базовый пример и практические сценарии, которые помогут вам начать добавлять и обновлять инвентарь, а также отправлять сообщения инвентаризации.

Примеры различных сценариев, связанных с инвентаризацией, см . в разделе «Практические инструкции» .

Обязательные и необязательные элементы

Справочник XML содержит описания обязательных и необязательных элементов. Подробную информацию об атрибутах и ​​дочерних элементах см. в разделе Элементы и атрибуты инвентаря .

Синтаксис и схемы

Используйте пример синтаксиса инвентаризации в качестве справочного материала при создании сообщения инвентаризации, чтобы убедиться, что вы используете правильный формат.

Вы можете использовать сторонний инструмент XML, например xmllint, чтобы проверить свои каналы на соответствие опубликованным схемам перед отправкой их в Google. Схему сообщения о ресурсах см. в разделе Схемы рекламы гостиниц .

Рекомендации

Используйте следующие рекомендации для сообщения инвентаризации:

• Инвентарь привязан к отелю, дате и типу номера.

• Количество инвентаря должно быть больше 0 для всех ночей пребывания, чтобы отображалась цена соответствующего тарифного плана и размещение.

• Если количество инвентаря равно 0 , номера не будут доступны для бронирования для указанного идентификатора номера и диапазона дат.

• CountType всегда должен иметь значение 2 чтобы быть действительным, поскольку он указывает на количество «определенной доступности».

• Отправляйте обновленные данные всякий раз, когда в вашей системе происходит бронирование или отмена номера.

Примечание. Отправьте данные о наличии номеров с помощью OTA_HotelInvCountNotifRQ (рекомендуемый метод) или альтернативного метода с использованием атрибута <BookingLimit> сообщения OTA_HotelAvailNotifRQ .

Запасы и доступность

Инвентаризация — это количество номеров, которые можно забронировать, исходя из их физического количества, а доступность указывает, разрешено ли бронировать сочетание типа номера и тарифного плана. Для ARI доступность и инвентарь могут варьироваться в зависимости от набора дат или типа размещения, и оба имеют соответствующие типы сообщений. Инвентарь и доступность определяются по отелю, дате и типу номера с добавлением тарифного плана для проверки доступности.

«Доступность может отсутствовать», даже если запасы есть, поскольку запасы и наличие не зависят друг от друга.

Есть две концепции доступности. Во-первых, это общая доступность продукта для данного пребывания, на которую влияют такие факторы, как наличие определенной цены за каждую ночь, наличие мест для соответствующего типа номера и открытое ограничение доступности. Во-вторых, существует определенное ограничение для продукта на определенную дату, представленное <RestrictionStatus Restriction="Master" Status="Open"/> в OTA_HotelAvailNotifRQ , и закрытие этой доступности называется «стоп-продажей».

Инвентарь должен быть целым числом больше 0 для комнаты, а ограничение доступности должно быть открыто, чтобы отображалась цена на продукт.

Примечание. Если номер распродан, никакие тарифные планы, связанные с этим номером, больше не могут быть проданы.

Пример

В этом разделе представлен базовый пример сообщения инвентаризации с использованием обязательных и необязательных элементов. После того как вы подготовите файл, вам нужно будет отправить его в Google через POST-сообщение на эту конечную точку:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Дополнительные сведения о том, как отправить/POST сообщение, см. в разделе Отправка сообщений .

Ключевой момент: отправляйте Google обновленное сообщение об инвентаре всякий раз, когда ваш инвентарь меняется, например, когда происходит бронирование или отмена.

В качестве HotelCode используйте уникальный идентификатор отеля, который вы использовали в своей системе для идентификации объекта. Это значение должно соответствовать идентификатору отеля, указанному с помощью <id> в элементе <listing> в фиде списка отелей. Для <RoomID> используйте тот же идентификатор, который вы использовали в своей системе для типов номеров. Согласованность с вашей системой имеет решающее значение для обеспечения правильного отображения ваших данных Google.

Примечание. <CountType=2> — единственный допустимый параметр, поскольку он указывает количество «определенной доступности».

В этом примере показано, как настроить инвентарь для 13 бронируемых номеров на декабрь:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Дополнительные примеры см. в разделе Примеры инвентаризации .

Инструкции

В этом разделе описан сценарий, с которым вы можете столкнуться при отправке сообщения инвентаризации.

Сценарий: Как заблокировать бронирование номеров

Описание

Вам необходимо указать, что нет свободных номеров, которые можно забронировать для этого типа номеров на определенный набор дат, чаще всего потому, что они распроданы.

Решение

Вы устанавливаете для <InvCount Count> значение 0 и добавляете желаемый диапазон дат.

Образец

В этом примере показано, как использовать InvCount для установки инвентаризации на 0 для указанной комнаты и дат (например, первые несколько недель января).

Примечание. Если инвентаризация номера равна 0 для любой ночи пребывания, пребывание не может быть забронировано для каких-либо продуктов, связанных с этим номером.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>