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

行程的 API 傳輸

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

配送選項

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

推播機制

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

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

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

>> 查看有關 API 設定的更多詳細資訊

處理推送事件

由於行程資料是隨取得而傳送，您可能會收到同一行程的多個事件——首先是包含核心欄位的初始事件，隨後隨著輔助資料的豐富或行程的更新，還會收到後續的事件。

>> 請參閱「可用欄位」一節，以了解各欄位的時機詳情

應做的事：

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

請勿：

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

提取機制

Checkmark

注意

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

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

  • 資料分析
  • 將預訂記錄與 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提供活動的廠商名稱。奧莉維亞旅遊即時
activity_city活動舉辦的城市。聖猶達即時
activity_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提供活動的廠商名稱。奧莉維亞旅遊即時
activity_city活動舉辦的城市。聖裘德即時
activity_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。