庫存訊息

總覽

庫存訊息 (OTA_HotelInvCountNotifRQ) 定義了庫存數量 可供預訂且可供預訂的特定會議室 (實際數量) 。傳送商品目錄訊息時，請指明該訊息的會議室數量 類型。如果沒有該類型的會議室可供使用， 系統不會顯示有關該房型和日期的產品。

下列各節涵蓋一般指南、基本範例和操作說明 協助您開始新增及更新廣告空間， 庫存訊息。

如需各種與廣告空間相關的情境示例，請參閱 操作說明。

必要和選用元素

XML 參考資料 提供必要和選用元素的說明。瞭解詳情 請參閱「廣告空間元素與 屬性。

語法和結構定義

使用廣告空間 所有的語法範例 ，確保您遵循 格式必須正確無誤

您可以使用 xmllint 等第三方 XML 工具，使用 已公開的結構定義，再提交給 Google針對廣告空間 訊息架構，請參閱飯店廣告架構。

指南規範

設定商品目錄訊息時，請遵守下列規範：

• 廣告空間按飯店、日期和客房類型對應。

• 訂單中所有住宿夜的庫存數量必須大於 0 顯示相關費率方案和可住人數的價格。

• 如果庫存數量等於 0，就無法預訂客房 指定書籍 ID 和日期範圍

• CountType 必須始終包含 2 的值才算有效，因為這會指出 「確定可用性」的數量

• 預訂或取消會議室時，傳送最新的庫存資訊 會發生什麼事

，瞭解如何調查及移除這項存取權。

注意： 使用 OTA_HotelInvCountNotifRQ 傳送會議室庫存數量 (建議方法) 或替代方法 OTA_HotelAvailNotifRQ 訊息的 <BookingLimit> 屬性。

廣告空間與供應情形

房源是根據實體數量計算可預訂房間的數量，而可預訂數量則表示房型和房價方案組合是否可供預訂。以 ARI 來說，供應情形和空房情況皆可能不同 挑選出適當的日期或住宿類型，且兩者都有 訊息類型。空房數和空房資訊按飯店、日期和客房劃分 並新增供應情形的費率方案。

屬性中可能會顯示「無法預約」即使有廣告空間 和供應情形各自獨立

可用性有兩個概念。首先是 特定住宿期間的產品，受許多因素影響，例如 例如每晚房價、相關房型的廣告空間 並開啟供應情形限制第二，這裡還有 特定日期的產品限制，以 OTA_HotelAvailNotifRQ 的 <RestrictionStatus Restriction="Master" Status="Open"/> 表示，以及結尾 這個供應情形稱為「停止銷售」。

空房數量和供應情形必須是大於 0 的整數 限制必須開啟，才能顯示產品的價格。

注意： 如果空房已售罄，則與該客房相關的任何房價方案都可以 不再出售。

範例

本節將舉例說明使用「必填」屬性的商品目錄訊息 以及選用的元素檔案準備就緒後，您需要將檔案傳送到 Google 透過 POST 訊息傳送至這個端點：

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

如要進一步瞭解如何推送/POST 訊息，請參閱「推送 訊息。

重點： 每當商品目錄資料出現時，請將最新的商品目錄訊息傳送給 Google 例如預訂和取消變更時間。

針對 HotelCode，請使用系統中用於識別房源的專屬飯店 ID。這個值必須符合使用 <listing>中的<id> 元素 飯店清單動態饋給。若是 <RoomID>，請使用系統中使用的 ID 房間類型與系統的一致性是確保 Google 正確顯示資料

注意： <CountType=2> 表示唯一有效的選項，因為這個項目會指出 「無限期供應。」

以下範例說明如何設定 13 個可預訂房間的房源，適用於 12 月：

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