建立交易訊息

發行項
12/21/2023

若要提供 Bing 旅館價格和可用性資料，請建立包含交易訊息的 XML 檔。交易訊息包含簽入日期、停留時間和定價的清單。

交易訊息最多可包含 180 天的進階預約，而每個預約最多可指定 14 個夜間停留時間。簽入日期和停留時間稱為路線。如果您指定路線數目上限，則訊息會包含 2,520 個路線。

使用 GZip 壓縮) ，交易訊息限制為 100 MB 的未壓縮資料或 10 MB 的壓縮資料 (。若要減少網路流量，您應該傳送壓縮的資料。

交易訊息應該只包含您要新增或更新的路線，請勿包含自上次傳送訊息後未變更的行程。

檔必須使用 UTF-8 編碼，而且必須符合交易 XSD。

重要事項

您必須閱讀並遵循所有旅館價格廣告原則。如需原則清單，請參閱試驗計畫原則。

注意事項

Bing 不支援所有交易 XSD 元素。 Bing 會忽略訊息中不支援的任何元素或屬性。交易訊息參考只包含 Bing 支援的元素和屬性。

注意事項

訊息必須以交易 XSD (中定義的順序或參考) 中所示來指定專案。

最上層 Transaction 元素

交易訊息包含單一的最上層 Transaction 元素。

<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">

您必須指定 timestamp 和 id 屬性。

屬性 timestamp 應該會識別您提交訊息的時間。 Bing 會使用時間戳，以確保它只處理最新的行程。例如，如果 Bing 處理的時間戳記為 14：10 的訊息，然後處理時間戳記為 14：09 的訊息，Bing 只會處理 14：09 訊息中未包含在 14：10 訊息中的行程。

id屬性是使用者定義的識別碼，可唯一識別訊息給廣告商。廣告商會使用識別碼來識別旅館摘要狀態報表清單中的訊息。

指定路線清單

元素 Transaction 包含 Result 元素的清單，每個定義的路線各一個。訊息應該只包含新的路線或已變更的路線。

下列顯示 Result 指定必要子專案的專案。

  <Result>
    <Property>13579</Property>
    <Checkin>2017-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>

標識 Property 符必須符合旅館摘要檔案中屬性的識別碼。日期 Checkin 必須在 90 天的進階預約時間範圍內，且 Nights 範圍必須介於 1 到 14 之間。

指定 Baserate 整段停留時間的成本，而不是夜間房間費率。

如果您允許五天的進階預約，且最多保留三天，則您的訊息會包含 15 個 Result 元素。下列範例顯示一天的行程。

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

定義 15 個路線之後，每個後續訊息只會包含已變更的路線。例如，價格或可用性變更。

移除路線

若要移除路線，請將其 Baserate 、 Tax 和 OtherFees 專案設定為 -1.00。 Bing 會自動移除具有過去簽入日期的行程。

使用選擇性的 Result 元素

下列顯示 Result 包含選擇性子項目的專案。

  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <ExpirationTimestamp>2017-05-28T09:00:34Z</ExpirationTimestamp>
    <ChargeCurrency>deposit</ChargeCurrency>
    <Custom1>summer2017</Custom1>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>

使用 ExpirationTimestamp 指定行程的到期日。例如，在案例 1 中，會提供路線。

案例 1：

Today = 3/16/2018
CheckInDate = 4/1/2018
ExpirationTimestamp = 3/20/2018

但在案例 2 中，不會提供路線。

案例 2：

Today = 3/21/2018
CheckInDate = 4/1/2018
ExpirationTime = 3/20/2018

ChargeCurrency使用專案來指定何時向使用者收取預約費用。根據預設，使用者在預約時會支付 (這是 Web 選項) 。此範例會使用[存回]，要求使用者在預約時支付部分費用，而餘數則 (例如，當使用者取出) 時。

使用五 Custom 個元素中的一個或多個元素，在銷售點中提供動態參數的替代值， (POS) URL。例如，如果 POS URL 是 https://www.partnerdomain.com?promo=(CUSTOM1) 且 Custom1 設定為 summer2017，Bing 使用的 POS URL 就是 https://www.partnerdomain.com?promo=summer2017. 如需詳細資訊，請參閱使用動態查詢參數。

所有 Custom[1-5] 值的總和限制為最多 1,000 個字元，但請記住，根據 URL 的最大長度，實際限制可能較少。

使用元素 AllowablePointsOfSale 來指定使用者可用於預約的特定 POS URL。根據預設，使用者可以在合作夥伴的銷售點摘要檔案中使用任何 POS。屬性 id 必須符合摘要檔案中的 POS。

後續步驟

傳送交易訊息之前，請確定您的旅館摘要檔案和銷售點檔案是最新狀態。若要更新這些檔案，請連絡您的 TAM。 TAM 將資料匯入 Bing 之後，您就可以開始傳送交易訊息。匯入資料之前傳送的交易訊息將會失敗。

將交易訊息傳送至 Bing 之前，請先驗證該訊息。如需詳細資訊，請參閱驗證您的交易訊息。

如需傳送 Bing 交易訊息的相關資訊，請參閱將交易訊息推送至 Bing 或具有 Bing 提取交易訊息。

如需將會議室套件組合新增至行程的相關資訊，請參閱建立中繼資料交易訊息和使用會議室套件組合。