Developer Hub
此為系統自動產生的翻譯

行程的 API 傳輸

透過「行程」功能，您可以顯示客戶的預訂資訊，並協助他們尋找 booking-related 上的產品或服務，例如旅遊行程或體驗活動。您也可以利用這些資料來分析預訂趨勢，並為相關人士製作報告。

配送選項

您的行程資料 API 傳輸可採用「推送」或「拉取」機制。

推播機制

推播服務會在行程更新時即時發送相關資訊。核心預訂欄位會在交易完成後數分鐘內提供，輔助欄位及補充欄位則會在 2 至 4 小時內跟進提供。此選項可讓您：

  • 在您的網站上顯示客戶的預訂資訊，或 App
  • 向旅客提供更多可供購買的旅遊相關產品與服務

推播事件將透過 Webhook 傳送至您提供的 URL，格式為HTTP POST 訊息。這些訊息的傳送順序可能不固定，因此請參閱creation_date 和update_date_time 中的元素來確定順序。

有關如何採用此傳輸選項的詳細資訊，請參閱API 設定。

處理推送事件

由於行程資料會於取得後立即傳送，您可能會收到同一行程的多個事件——首先是包含核心欄位的初始事件，隨後隨著輔助資料的補充或行程的更新，還會收到後續事件。請參閱中的「可用欄位」，以了解哪些欄位會即時傳送，哪些則會在 2 至 4 小時內傳送，並查看完整明細。

應做的事：

  • 每個行程中預期會有多個活動：請使用itinerary_id 來關聯各項活動，並始終以具備最新update_date_time 的活動為準
  • 選擇更新處理方式：當您收到現有行程的新事件時，您可以選擇以最新資料覆寫先前記錄，或將每個事件追加至末端以保留變更歷史紀錄
  • 妥善處理缺失的欄位：早期事件中可能缺少輔助欄位；在處理前請先檢查欄位是否存在

請勿：

  • 假設第一個事件包含完整的有效載荷：，其輔助欄位將在後續事件中出現
  • 將同一行程中的多個事件視為錯誤處理： 這是預期中的行為
  • 請將 real-time 上的財務數值視為最終數值： 這些數值可能會在 24 小時內進行調整

提取機制

Checkmark

注意

「拉取式交付」服務僅限於「白標旅遊平台」合作夥伴使用。

此拉取服務提供詳細的行程資料，以支援：

  • 資料分析
  • 將預訂記錄與 Expedia Group 資料進行對帳
  • 針對推送傳送失敗的時間區間進行資料擷取
  • 服務台調查

與推送式傳輸相同，拉取式傳輸的行程資料亦分為兩個層級：核心欄位 (itinerary_ID、status、gross_booking_value、checkin_date 及checkout_date) 可在預訂或更新後數分鐘內取得；輔助欄位與增強欄位則會在 2 至 4 小時內跟進提供。請參閱及，以查看各領域的完整細項。

此服務包含兩個HTTP GET 端點，可讓您：

  • 使用creation_date_start、creation_date_end、update_date_time_start 及update_date_time_end 這些變數，建立一份在指定時間範圍內建立或更新的行程清單
  • 根據其...檢索特定行程 itinerary_id

有關驗證流程的詳細資訊，請參閱API 設定。

依時間區間擷取行程資料

若要擷取特定時間區間的行程資料，請透過GET /itineraries 及update_date_time_start 作為查詢區間，向update_date_time_end 端點發送輪詢請求。

建議的做法：

  1. 請在查詢視窗中使用 update_date_time 中的欄位： 請將update_date_time_start 和update_date_time_end 作為查詢視窗，以擷取在指定期間內建立或更新的行程。若僅使用creation_date，將無法收到行程更新。
  2. 將您上次成功擷取的汲取時間戳記儲存下來： 將此值用作下一次的update_date_time_start，並以增量方式推進擷取視窗。
  3. 重複資料刪除： 請在查詢中使用itinerary_id +update_date_time。隨著輔助欄位的資料日益豐富，同一行程可能會出現在多個投票視窗中。請始終以最新版《update_date_time》中的記錄為準。

若您的使用情境需要最完整且即時的行程資料，建議採用推送傳輸方式。

可用欄位

下表列出我們推播和提取交付方法所提供的欄位，包括所有嵌入物件。「可用性」欄位顯示各欄位在預訂事件或更新後，通常何時可被存取：

  • 即時：預訂或更新後數分鐘內即可取得
  • Near-real-time：預訂或更新後 2 至 4 小時內即可取得

以名稱開頭並緊接英文句號的欄位名稱 (例如，<variable>.<nested variable>) 可指出嵌入關係。

白牌旅遊平台

欄位名稱定義範例供應情況
itinerary_id行程編號或銷售點訂單參考編號。72622069245694即時
status行程和當中個別項目的狀態。可能的值：
已確認
已取消		即時
creation_date*預訂的初始日期，以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-05即時
update_date_time*行程的最後更新日期與時間，以 ISO 8601 日期格式表示 (YYYY-MM-dd'T"HH:mm:ss.SSSZ)。2023-10-21T00:00:00.000Z即時
online表示該行程是透過線上預訂 (true) 還是透過旅行社預訂 (false)。以布林值表示。trueNear-real-time
package用以標示該行程是套裝行程的一部分，還是獨立預訂。以布林值表示。falseNear-real-time
payment_type付款時使用的付款方式。可能的值：
信用卡
點數
分期付款		即時
point_of_sale_country_code旅客預訂所用銷售點的國家/地區代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。GBNear-real-time
purchaser預訂者的身分識別。請參閱 purchaser 表格以取得嵌入項目清單。  
property_booking_items做為行程一部分而預訂的住宿項目。請參閱 property_booking_items 表格以取得嵌入項目清單。  
flight_booking_items做為行程一部分而預訂的機票項目。請參閱 flight_booking_items 表格以取得嵌入項目清單。  
car_booking_items做為行程一部分而預訂的租車項目。請參閱 car_booking_items 表格以取得嵌入項目清單。  
activity_booking_items做為行程一部分而預訂的活動項目。請參閱 activity_booking_items 表格以取得嵌入項目清單。  
insurance_booking_items做為行程一部分而預訂的保險項目。請參閱 insurance_booking_items 表格以取得嵌入項目清單。  
rate預訂項目或整體行程的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  
coupon套用至行程的優惠券 (如果適用)。請參閱 coupon 表格以取得嵌入項目清單。  
|

訂購者

這些欄位會識別進行預訂的人員。

欄位名稱定義範例供應情況
purchaser.email**預訂者的電子郵件地址。smith@example.com即時
purchaser.loyalty_id**會員計畫的識別碼。12345678Near-real-time
purchaser.first_name**預訂者的名字。珍即時
purchaser.last_name**預訂者的姓氏。Smith即時

property_booking_items

這些欄位會列出做為行程一部分而預訂的住宿項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882912即時
status特定住宿元素的狀態。可能的值：
已確認
已取消		即時
checkin_date*相應住宿元素的入住日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-01即時
checkout_date*相應住宿元素的退房日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-05即時
property.idExpedia Group's 飯店或度假租屋旅宿的唯一識別碼。1400882912Near-real-time
property.chain_name旅宿隸屬的連鎖體系名稱 (如果適用)。獨立住宿Near-real-time
property.brand_name旅宿隸屬的品牌名稱 (如果適用)。單一連鎖體系可能包含多個品牌。Savoy SignatureNear-real-time
property.name飯店或出租度假屋的名稱。飯店 1即時
property.city旅宿所在城市的名稱。多倫多即時
property.state_province_name旅宿所在州/省的名稱。安大略Near-real-time
property.country_code旅宿所在國家/地區的名稱。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
property.star_rating旅宿星級。3.0Near-real-time
room_name預訂編號客房的類型，由飯店或度假租屋公司所定義。Comfort 雙人房客房 (附獨立衛浴)Near-real-time
adult_count相應預訂所包含的成人人數。2即時
child_count相應預訂所包含的兒童人數。0即時
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。trueNear-real-time
property_confirmation_id由飯店或度假租屋公司提供的確認編號。1516171819Near-real-time
rate住宿預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  

flight_booking_items

這些欄位會列出做為行程一部分而預訂的機票項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882911即時
status特定機票行程的狀態。可能的值：
已確認
已取消		即時
departure_date*相應機票行程元素的開始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-01即時
arrival_date*相應機票行程元素的結束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-02即時
airline.plating_carrier_name開立機票的航空公司名稱。加拿大航空Near-real-time
airline.plating_carrier_code開立機票之航空公司的國際航空運輸協會 (IATA) 代碼。AC即時
carrier_pnr開立機票之航空公司所記錄的乘客姓名。SMITHNear-real-time
trip_type預訂的旅行類型。可能的值：
單程
來回
多個目的地		Near-real-time
fare_class機票艙等。經濟艙Near-real-time
airport_origin_code出發地機場的 IATA 代碼。LHR即時
airport_origin_location出發地機場的所在地。倫敦，英國 (LHR-希斯洛機場)Near-real-time
airport_destination_code目的地機場的代碼。以 IATA 格式表示。YYZ即時
airport_destination_location目的地機場的所在地。多倫多，安大略 (YYZ-列斯特 B. 皮爾森國際機場)Near-real-time
ticket_number航班的機票號碼。123456789Near-real-time
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。trueNear-real-time
segment_count機票的航段數量。1Near-real-time
rate機票預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  

car_booking_items

這些欄位會列出做為行程一部分而預訂的租車項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882910即時
status特定租車行程的狀態。可能的值：
已確認
已取消		即時
pickup_date*租車行程元素的開始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-02即時
return_date*租車行程元素的結束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-05即時
rental_company.name租車公司的名稱。Hertz即時
car_type租車的類型。2/4 門小型車Near-real-time
pickup_location租車的取車地點。鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場)即時
pickup_country_code取車地點的國家/地區代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
return_location租車的還車地點。鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場)即時
return_country_code還車地點的國家/地區代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
trip_type預訂的旅行類型。可能的值：
單程
來回
多個目的地		Near-real-time
rental_company_confirmation_id由租車公司提供的確認編號。ABC1234Near-real-time
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。falseNear-real-time
rate租車預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  

activity_booking_items

這些欄位會列出做為行程一部分而預訂的活動項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882910即時
status特定活動的狀態。可能的值：
已確認
已取消		即時
activity_start_date*活動的開始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-03即時
activity_end_date*活動的結束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-03即時
vendor.name提供活動的廠商名稱。奧莉維亞旅遊即時
vendor.city活動廠商所在的城市。鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場)即時
vendor.country_code活動廠商所在的城市代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
offering_name活動名稱。Passions of Paradise Great Barrier ReefNear-real-time
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。trueNear-real-time
rate活動預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  

insurance_booking_items

這些欄位會列出做為行程一部分而預訂的保險項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882610即時
status所選特定保險的狀態。可能的值：
已確認
已取消		即時
rate所選保險的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  

房價

這些欄位會列出預訂項目或整體行程的房價和價格詳情。這些值包含嵌套的數值，用以描述預訂的金額，並細分為預訂總額、稅金及手續費。

欄位名稱定義範例供應情況
rate_plan_name用來為項目定價的房價計畫名稱。僅適用於旅宿預訂項目。僅訂客房Near-real-time
rate_plan_type預訂使用的房價類型。僅適用於旅宿預訂項目。經銷房價Near-real-time
refundable對應的預訂項目是否可退款 (true) 或不可退款 (false)。trueNear-real-time
pricing用於記錄預訂貨幣價值的項目，細分為預訂總額、稅金及手續費。  
pricing.gross_booking_value用以記錄預訂金額的物件。  
pricing.gross_booking_value.billable_currency代表預訂金額的物件，其貨幣單位為付款所使用的貨幣。  
pricing.gross_booking_value.billable_currency.currency旅客在預訂時使用的支付貨幣。以 ISO 4217 格式表示。GBP即時
pricing.gross_booking_value.billable_currency.value總預訂金額。2520.80即時
pricing.taxes_and_fees預訂所含稅金和費用的價值與貨幣。  
pricing.taxes_and_fees.billable_currency預訂所含稅金和費用的貨幣價值 (以付款所用的貨幣表示)。  
pricing.taxes_and_fees.billable_currency.currency旅客在預訂時使用的支付貨幣。以 ISO 4217 格式表示。GBP即時
pricing.taxes_and_fees.billable.currency.value預訂的總預訂金額。491.10即時

優惠券

欄位名稱定義範例供應情況
code預訂使用的優惠代碼。ABCDNear-real-time
name優惠券名稱。PRIMENear-real-time
description優惠券詳情。BoGo 5%Near-real-time
currency所套用優惠券價值的貨幣。以 ISO 4217 格式表示。GBPNear-real-time
value優惠券的貨幣價值。126.04Near-real-time

所有白標旅遊平台欄位的說明

  • 日期欄位採用協調世界時 (UTC)。
    ** 這屬於個人可識別資訊 (PII) 資料。請務必依照貴公司的指引正確處理此事。僅在絕對必要時才包含。

旅行社聯盟計畫 (TAAP)

欄位名稱定義範例供應情況
itinerary_id行程編號或銷售點訂單參考編號。72622069245694即時
agency_reference_code由旅行社於結帳時提供的客製化行程參考資料。86549B_GB即時
status行程和當中個別項目的狀態。可能的值：
已確認
已取消		Near-real-time
creation_date*預訂的初始日期，以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-05即時
update_date_time*行程的最後更新日期與時間，以 ISO 8601 日期格式表示（YYYY-MM-dd'T"HH:mm:ss.SSSZ).2023-10-21T00:00:00.000Z即時
online表示該行程是透過線上預訂 (true) 還是透過旅行社預訂 (false)。以布林值表示。trueNear-real-time
point_of_sale_country_code客戶進行預訂時所屬國家的代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。GBNear-real-time
purchaser預訂者的身分識別。請參閱 purchaser 表格以取得嵌入項目清單。  
agency請提供 TAAP 負責處理此預訂的機構及人員的相關資訊。請參閱 agency 表格以取得嵌入項目清單。  
payment該行程的付款資訊。請參閱 payment 表格以取得嵌入項目清單。  
property_booking_items做為行程一部分而預訂的住宿項目。請參閱 property_booking_items 表格以取得嵌入項目清單。  
flight_booking_items做為行程一部分而預訂的機票項目。請參閱 flight_booking_items 表格以取得嵌入項目清單。  
car_booking_items做為行程一部分而預訂的租車項目。請參閱 car_booking_items 表格以取得嵌入項目清單。  
activity_booking_items做為行程一部分而預訂的活動項目。請參閱 activity_booking_items 表格以取得嵌入項目清單。  
rate預訂項目或整體行程的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  
earnings某筆預訂項目或整個行程的佣金明細。請參閱 earnings 表格以取得嵌入項目清單。  
|

訂購者

這些欄位是用來識別即將出行的旅客。

欄位名稱定義範例供應情況
purchaser.email**旅客的電子郵件地址。smith@example.com即時
purchaser.first_name**旅客的名字。珍即時
purchaser.last_name**旅客的姓氏。Smith即時

代理機構

這些欄位用以識別負責辦理預訂的 TAAP 旅行社及其業務員。

欄位名稱定義範例供應情況
agency.name負責預訂的「TAAP」代理商名稱。環球旅行Near-real-time
agency.id負責預訂的 TAAP 旅行社之追蹤編號。WS02555即時
agency.agent.first_name**負責預訂的 TAAP 代理人的名字。Bob即時
agency.agent.last_name**負責預訂的「TAAP」代理人的姓氏。Jones即時
agency.agent.email**負責預訂的 TAAP 客服人員的電子郵件地址。bjones@worldtravel.com即時

付款

這些欄位包含該行程的付款詳細資訊。

欄位名稱定義範例供應情況
payment_type付款時使用的付款方式。可能的值：
信用卡
個百分點
分批支付		即時
status表示該行程是否已付款。可能的值：
已付款
未支付		Near-real-time
deferred該行程的款項是否已延期支付 (是) 或已支付 (否)。以布林值表示。trueNear-real-time
payment_due_date付款到期日 (ISO 8601 日期格式)（YYYY-MM-DD). 僅適用於延期付款。2023-02-05Near-real-time
payee標示由誰負責支付行程費用。可能的值：
代理機構
客戶		Near-real-time

property_booking_items

這些欄位會列出做為行程一部分而預訂的住宿項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882912即時
status特定住宿元素的狀態。可能的值：
已確認
已取消		即時
checkin_date*相應住宿元素的入住日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-01即時
checkout_date*相應住宿元素的退房日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-05即時
property.idExpedia Group's 飯店或度假租屋旅宿的唯一識別碼1400882912Near-real-time
property.chain_name旅宿隸屬的連鎖體系名稱 (如果適用)。獨立住宿Near-real-time
property.brand_name旅宿隸屬的品牌名稱 (如果適用)。單一連鎖體系可能包含多個品牌。Savoy SignatureNear-real-time
property.name飯店或出租度假屋的名稱。飯店 1即時
property.city旅宿所在城市的名稱。多倫多即時
property.state_province_name旅宿所在州/省的名稱。安大略Near-real-time
property.country_code旅宿所在國家/地區的名稱。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
property.star_rating旅宿星級。3.0Near-real-time
room_name預訂編號客房的類型，由飯店或度假租屋公司所定義。Comfort 雙人房客房 (附獨立衛浴)Near-real-time
adult_count預訂中包含的成人人數。2即時
child_count預訂中包含的兒童人數。0即時
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。trueNear-real-time
property_confirmation_id由飯店或度假租屋公司提供的確認編號。1516171819Near-real-time
rate住宿預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  
earnings該住宿預訂的佣金明細。請參閱 earnings 表格以取得嵌入項目清單。  

flight_booking_items

這些欄位會列出做為行程一部分而預訂的機票項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882911即時
status特定機票行程的狀態。可能的值：
已確認
已取消		即時
departure_date*相應機票行程元素的開始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-01即時
arrival_date*相應機票行程元素的結束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-02即時
airline.plating_carrier_name開立機票的航空公司名稱。加拿大航空Near-real-time
airline.plating_carrier_code開立機票之航空公司的 IATA 代碼。AC即時
carrier_pnr開立機票之航空公司所登記的乘客姓名。SMITHNear-real-time
trip_type預訂的旅行類型。可能的值：
單程
來回
多個目的地		Near-real-time
fare_class機票艙等。經濟艙Near-real-time
airport_origin_code出發地機場的 IATA 代碼。LHR即時
airport_origin_location出發地機場的所在地。倫敦，英國 (LHR-希斯洛機場)Near-real-time
airport_destination_code目的地機場的代碼。以 IATA 格式表示。YYZ即時
airport_destination_location目的地機場的所在地。多倫多，安大略 (YYZ-列斯特 B. 皮爾森國際機場)Near-real-time
ticket_number航班的機票號碼。123456789101Near-real-time
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。trueNear-real-time
segment_count該機票的航段數。1Near-real-time
rate機票預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  
earnings該航班預訂的佣金明細。請參閱 earnings 表格以取得嵌入項目清單。  

car_booking_items

這些欄位會列出做為行程一部分而預訂的租車項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882910即時
status特定租車行程的狀態。可能的值：
已確認
已取消		即時
pickup_date*租車行程元素的開始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-02即時
return_date*租車行程元素的結束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-05即時
rental_company.name租車公司的名稱。Hertz即時
car_type租車的類型。2/4 門小型車Near-real-time
pickup_location租車的取車地點。鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場)即時
pickup_country_code取車地點的國家/地區代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
return_location租車的還車地點。鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場)即時
return_country_code還車地點的國家/地區代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
trip_type預訂的旅行類型。可能的值：
單程
來回
多個目的地		Near-real-time
rental_company_confirmation_id由租車公司提供的確認編號。ABC1234Near-real-time
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。falseNear-real-time
rate租車預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  
earnings該車預訂的佣金明細。請參閱 earnings 表格以取得嵌入項目清單。  

activity_booking_items

這些欄位會列出做為行程一部分而預訂的活動項目。

欄位名稱定義範例供應情況
booking_item_id做為行程一部分而預訂的特定元素識別碼。1400882910即時
status特定活動的狀態。可能的值：
已確認
已取消		即時
activity_start_date*活動的開始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-03即時
activity_end_date*活動的結束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD).2023-02-03即時
vendor.name提供活動的廠商名稱。奧莉維亞旅遊即時
vendor.city活動廠商所在的城市。鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場)即時
vendor.country_code活動廠商所在的城市代碼。以雙字母 ISO 3166-1 alpha-2 格式表示。CA即時
offering_name活動名稱。漢伯河步道健行Near-real-time
expedia_collect布林值，用來表示預訂是否已在付款頁面支付 (true)，還是必須直接支付給供應商 (false)。trueNear-real-time
rate活動預訂的房價和價格詳情。請參閱 rate 表格以取得嵌入項目清單。  
earnings該活動預訂項目的佣金明細。請參閱 earnings 表格以取得嵌入項目清單。  

房價

這些欄位會列出預訂項目或整體行程的房價和價格詳情。這些值包含嵌套的數值，用以描述預訂的貨幣價值，並細分為預訂總額以及稅金和手續費。

欄位名稱定義範例供應情況
refundable對應的預訂項目是否可退款 (true) 或不可退款 (false)。trueNear-real-time
pricing用於記錄預訂貨幣價值的項目，細分為預訂總額、稅金及手續費。  
pricing.gross_booking_value預訂的貨幣價值，包含稅金和費用。  
pricing.gross_booking_value.billable_currency預訂的貨幣價值 (以付款所用的貨幣表示)。  
pricing.gross_booking_value.billable_currency.currency旅客在預訂時使用的支付貨幣。以 ISO 4217 格式表示。GBP即時
pricing.gross_booking_value.billable_currency.value總預訂金額。2520.80即時
pricing.taxes_and_fees預訂所含稅金和費用的價值與貨幣。  
pricing.taxes_and_fees.billable_currency預訂所含稅金和費用的貨幣價值 (以付款所用的貨幣表示)。  
pricing.taxes_and_fees.billable_currency.currency旅客在預訂時使用的支付貨幣。以 ISO 4217 格式表示。GBP即時
pricing.taxes_and_fees.billable.currency.value預訂的總預訂金額。491.10即時

收益

欄位名稱定義範例供應情況
commission代表預訂或項目佣金金額的物件，已包含在預訂總額中。  
commission.billable_currency代表以付款貨幣計價之佣金金額的物件。  
commission.billable_currency.currency佣金金額的貨幣，以 ISO 4217 格式表示USD即時
commission.billable_currency.value佣金的金額。100.25即時
service_charge代表 TAAP 旅行社對行程所收取的服務費的物件。  
service_charge.amount代表 TAAP 旅行社針對該行程所收取之服務費金額的物件。  
service_charge.amount.billable_currency代表以付款貨幣計價之服務費金額的物件。  
service_charge.amount.billable_currency.currency服務費金額的貨幣，以 ISO 4217 格式表示。USD即時
service_charge.amount.billable_currency.valueTAAP 旅行社針對該行程所收取的服務費金額。若相關稅費由該機構負責，則已包含在內。50.50即時
service_charge.taxes_and_fees代表服務費相關稅費之金額及貨幣的物件。  
service_charge.taxes_and_fees.billable_currency客戶就服務費所支付的稅金及費用金額，以計費貨幣計價。此數值僅在 ExpediaTAAP 負責處理稅金與費用時才會填入。  
service_charge.taxes_and_fees.billable_currency.currency付款貨幣，以 ISO 4217 格式表示。USD即時
service_charge.taxes_and_fees.billable_currency.value旅客已支付的稅金和費用 (以帳單幣別表示)。5.25即時

關於所有「TAAP」欄位的說明

  • 日期欄位採用協調世界時 (UTC)。
    ** 這屬於個人可識別資訊 (PII) 資料。請務必依照貴公司的指引正確處理此事。僅在絕對必要時才包含。

API 詳細資料

我們已根據貴公司使用「行程 API」資料的方式，提供 API 架構與設定的概覽。您可以下載 OpenAPI 規格，並使用 API 測試工具來了解範例與架構定義與實際輸出結果之間的差異。

白牌旅遊平台

我們的「白標旅遊平台」合作夥伴可透過「推送」與「拉取」兩種傳輸方式存取的欄位 (包含任何嵌套物件) 如下：




TAAP

我們的 TAAP 合作夥伴可透過推播傳送方式存取的欄位 (包括任何嵌套物件) 如下：




這個頁面有幫助嗎？
我們能如何改善內容？
感謝您協助我們進行改善！

隱私權聲明Cookie 聲明使用條款

Expedia, Inc. 針對外部網站的內容恕不負責。
© 2026 Expedia, Inc.，Expedia Group 旗下公司。著作權所有，並保留一切權利。Expedia 智遊網和飛機標誌為 Expedia, Inc. 的商標或註冊商標。CST# 2029030-50。