庫存訊息

總覽

庫存訊息 (OTA_HotelInvCountNotifRQ) 定義了特定房型可預訂的庫存數量 (實體房間數量)。傳送商品目錄訊息時，您可以指明特定日期在該類型的可用會議室數量。如果沒有可用的會議室類型，系統就不會顯示與該房型和日期相關的產品。

以下各節將說明一般指南、基本範例和操作情境，協助您開始新增及更新廣告空間與傳送廣告空間訊息。

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

必要和選用元素

XML 參考資料提供必要及選用元素的說明。如要進一步瞭解屬性和子元素，請參閱「商品目錄元素和屬性」一文。

語法和結構定義

建立商品目錄訊息時，請使用商品目錄語法範例做為參考資料，確保採用正確的格式。

您可以使用第三方 XML 工具 (例如 xmllint) 使用已發布的結構定義來驗證動態饋給，再提交給 Google。如需瞭解商品目錄訊息結構定義，請參閱飯店廣告結構定義。

規範

請按照以下規範處理商品目錄訊息：

• 廣告空間是按飯店、日期和房型類型區分，

• 對於所有住宿夜晚的庫存數量，庫存數量必須大於 0，才能顯示相關費率方案和可住人數的價格。

• 如果庫存數量等於 0，就無法預訂指定客房 ID 和日期範圍的會議室。

• CountType 必須一律將 2 的值設為有效，因為這個值會指出「絕對可用性」的計數。

• 當系統在您的系統中進行預訂或取消時，就傳送更新後的庫存。

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

廣告空間與供應情形

「空房數」是依據實際數量和供應情形顯示可預訂的會議室數量，指出是否可以預訂房型和房價方案的組合。就 ARI 而言，空房和清查都可能因日期或住宿類型而異，且兩者都有對應的訊息類型。空房數和空房資訊是依照飯店、日期和客房類型來區分，並新增空房費率方案。

即使有目錄，也還是「無法使用」，因為庫存和供應情形是各自獨立的。

可用性有兩種概念。首先，是特定住宿產品的整體供應情形，會受到許多因素影響，例如每晚房價是否定義、相關房型的空房，以及空房限制等。其次，產品在特定日期也有特定限制，以 OTA_HotelAvailNotifRQ 中的 <RestrictionStatus Restriction="Master" Status="Open"/> 表示，而關閉這個供應情形稱為「停止銷售」。

商品目錄的值必須是大於 0 的整數，且供應情形限制必須開啟，才能顯示產品價格。

注意： 如果客房已售罄，則無法再銷售任何與該客房相關聯的房價方案。

範例

本節將提供使用必要和選用元素的基本商品目錄訊息基本範例。準備好檔案後，您需要透過 POST 訊息，將檔案傳送給 Google 這個端點：

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

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

重點： 每當商品目錄資料改變 (例如訂票和取消發生時)，傳送更新後的商品目錄訊息給 Google。

針對 HotelCode，請使用系統在系統中識別房源的專屬飯店 ID。這個值必須符合飯店清單動態饋給中使用 <id> 屬性指定的飯店 ID。<listing>針對 <RoomID>，請使用系統內使用的會議室類型 ID。與系統的一致性是確保 Google 正確顯示資料的關鍵。

注意： <CountType=2> 表示「絕對可用性」的計數，因此是唯一的有效選項。

以下範例說明如何為 12 月的 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 (例如 1 月的前幾週)。

注意： 如果會議室任何入住一晚的房源庫存數量為 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>