File-based 行程交付
合作夥伴入口網站 () 中，行程規劃 API 的標準報告包含 transaction-level 預訂資料，適用於僅住宿或多業務線 (LOBs) 的預訂。採用我們的標準報告，意味著您能快速取得數據，無需額外開發時間。
行程 API 的報告以交易層級編製，提供精選清單供選擇：住宿類別可選逾 60 項欄位，而「multi-LOB」報告則提供超過 100 項欄位。選項包括：
- 基本預訂資訊，例如旅行日期、行程安排及旅行費用
- 旅客與購買者 (若不同) 之客戶資訊
- 產品資訊，例如確認編號、供應商與地點、使用的業務線數量及成本
標準報告預設欄位
自訂報表時，您可從眾多欄位中進行選擇。這些項目預設已包含在標準報告中。
| 欄位名稱 | 資料類型 | 說明 | 範例 |
|---|---|---|---|
book_date | 日期 | 預訂最初完成的日期，以 ISO 8601 日期格式呈現（YYYY-MM-DD). | 2023-02-05 |
transaction_date | 日期 | 預訂最後修改日期。若預訂從未更新，此情況等同於book_date。日期採用 ISO 8601 日期格式表示（YYYY-MM-DD). | 2023-02-05 |
begin_use_date | 日期 | 旅程開始日期：出發日期、check-in 日期、pick-up 日期等，均以 ISO 8601 日期格式表示（YYYY-MM-DD). | 2023-04-05 |
end_use_date | 日期 | 旅程結束日期：抵達日期、check-out 日期、drop-off 日期等，以 ISO 8601 日期格式表示（YYYY-MM-DD). | 2023-04-06 |
transaction_type | varchar(200) | 已記錄交易的類型。 | 可能值：購買、獎勵、修改、取消。 |
product_line_name | varchar(200) | 該預訂項目所屬的業務類型。 | 可能值：航空、汽車、郵輪、目的地服務、保險、住宿、套裝行程、未知 |
package_indicator | varchar(100) | 該預訂項目是否屬於套裝行程的一部分 (例如航班 + 飯店)。 | 可能值：套件的一部分、獨立運作、未知 |
product_component | varchar(200) | 套裝購買所包含的產品。若購買的並非套裝組合，則僅會顯示單一產品線名稱。 | 空氣、汽車 |
itinerary_number | varchar(50) | 行程編號或銷售點訂單參考編號。 | 12345678910111 |
booking_item_id | varchar(50) | 做為行程一部分而預訂的特定元素識別碼。該欄位的數值可以是正數，也可以是負數。 | 1400882912 |
currency_code | char(3) | 預訂所支付的貨幣，以標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
gbv_local | 十進位(18,4) | 總預訂價值 (GBV)，即包含稅金與費用的總預訂金額，以實際支付貨幣計價。 | 694.89 |
order_count | 小整數 | 套裝購買中的訂單數量 (非商品數量)。 | 1 |
其他可選欄位
註： 下表並非報表中欄位顯示的順序。欄位的順序取決於在建立/編輯過程中啟用欄位的順序。
| 欄位名稱 | 資料類型 | 說明 | 範例 |
|---|---|---|---|
transaction_datetime | 時間戳記 | 最後更新 (修改) 預訂的日期/時間；若預訂從未變更，則與預訂日期相同。 | 2023-02-05 06:05:00 |
booking_window | 整數 | 預訂日期與 check-in 日期之間的天數。 | 32 |
booking_status | varchar(50) | 開放中、進行中、已完成、已授予或已取消。 | 處理中 |
online_offline_indicator | varchar(100) | 預訂是否透過線上或線下代理商進行的標示。 | 線上 |
point_of_sale_country | char(3) | 顧客進行預訂的銷售點。 | USD |
payment_type | varchar(50) | 使用的付款方式 (信用卡、點數、分攤付款)。 | 分攤支付 |
coupon_code | varchar(100) | 已使用的優惠券代碼。 | ABCD |
coupon_name | varchar(200) | 優惠券名稱。 | PRIME |
coupon_description | varchar(510) | 使用之優惠券說明。 | BoGo 5% |
coupon_price_amount_usd | 十進位(18,4) | 優惠券金額 (美元)。 | -58.6877 |
gbv_usd | 十進位(18,4) | 以美元計價的預訂總金額。 | 694.8941 |
gbv_tpid | 十進位(18,4) | 提供以 TPID 貨幣計價的總性別暴力數據。 | 694.8941 |
taxes_and_fees_local | 十進位(18,4) | 以當地貨幣計算的總稅費。 | 144.77 |
taxes_and_fees_usd | 十進位(18,4) | 總稅費 (美元計價)。 | 144.77 |
taxes_and_fees_tpid | 十進位(18,4) | 總稅費 (以 TPID 貨幣計價)。 | 144.77 |
insurance_gbv_local | 十進位(18,4) | 保險金額 (以當地貨幣計)。 | 80.4 |
insurance_gbv_usd | 十進位(18,4) | 保險金額 (以美元計)。 | 80.4 |
air_supplier_pnr | varchar(100) | 供應商航空旅客姓名記錄。 | ABCDEF |
air_carrier_pnr | varchar(100) | 航空公司旅客姓名記錄。 | BCDEFG |
air_business_model | varchar(200) | 訂票服務中航空部分的商業模式。 | 旅行社 |
air_trip_type | varchar(200) | 航空旅程類型。 | 單程 |
air_fare_class | varchar(200) | 所購機票的艙等。 | 商務艙 |
air_plating_carrier | varchar(200) | 航空公司名稱。 | 加拿大航空 |
airport_origin_code | char(3) | 航班出發地/起始地的機場代碼。 | YYZ |
airport_origin_location | varchar(406) | 航班出發地/起始地點。 | 安大略省多倫多市加拿大 |
airport_destination_code | char(3) | 航班抵達的機場代碼／目的地。 | FLL |
airport_destination_location | varchar(406) | 航班抵達地點／目的地。 | 美國佛羅里達州勞德代爾堡 |
air_ticket_number | varchar(100) | 航空公司機票號碼。 | 123456789101 |
air_ticket_count | 小整數 | 預訂中的機票數量 (附詳細檔案，包含預訂項目 ID，通常為 0 或 1)。 | 1 |
air_segment_count | 小整數 | 航空旅程的航段數 (若在預訂項目 ID 層級以上進行彙總，則為該預訂中所有乘客所有航段的總和)。 | 2 |
air_gbv_local | 十進位(18,4) | 以當地貨幣計價的預訂中航空部分的總預訂價值。 | 694.8941 |
air_gbv_usd | 十進位(18,4) | 預訂中航空部分的總預訂價值 (以美元計)。 | 694.8941 |
air_gbv_tpid | 十進位(18,4) | 以 TPID 貨幣計價的預訂中航空部分的總預訂價值。 | 694.8941 |
air_tpid_currency_code | char(3) | TPID 預訂貨幣採用標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
total_person_count | 整數 | 預訂中登記的人數總計 (僅限住宿部分)。 | 3 |
adult_count | 小整數 | 預訂中包含的成人人數 (僅限住宿部分)。 | 2 |
child_count | 小整數 | 預訂中包含的兒童人數 (僅限住宿部分)。 | 1 |
lodging_supplier_confirmation_code | varchar(100) | 預訂時由旅宿提供的確認碼。 | 1516171819 |
lodging_business_model | varchar(200) | 預訂系統中住宿模組的商業模式。 | 旅宿 |
lodging_chain_independent | varchar(200) | 旅宿是否為獨立項目或屬於鏈結的一部分之指示器。 | 獨立住宿 |
lodging_chain_name | varchar(200) | 已預訂的連鎖店 (品牌) 名稱：旅宿 | 獨立住宿 |
lodging_property_name | varchar(200) | 預訂的旅宿名稱 | 飯店科迪莉亞 |
lodging_star_rating | 浮點數 | 旅宿預訂的星級評分。 | 3 |
lodging_property_city | varchar(40) | 預訂地點所在城市旅宿 | 巴黎 |
lodging_property_market_name | varchar(80) | 旅宿所屬的市場。 | IDF - 法國巴黎 |
lodging_property_state_province | varchar(40) | 預訂地點所在的州/省份旅宿 | 巴黎 |
lodging_property_country | varchar(80) | 預訂編號旅宿所屬國家代碼。 | 法國 |
lodging_refundable_rate_indicator | varchar(100) | 預訂的費率是否可退費或不可退費的標示。 | 可退還的取消罰金費率。 |
lodging_rate_plan_name | varchar(200) | 已預訂的費率方案名稱。 | 套裝行程 |
lodging_rate_type_name | varchar(200) | 已預訂的費率類型名稱。 | 套裝行程 |
lodging_room_type_name | varchar(200) | 已預訂的客房類型名稱。 | Comfort 雙床房客房，私人浴室 |
lodging_length_of_stay | 整數 | 預訂旅宿的住宿天數 (以晚數計)。 | 5 |
lodging_room_count | 小整數 | 旅宿的預訂房間數量。 | 1 |
lodging_room_night_count | 小整數 | 預訂中的客房住宿天數 (住宿天數 × 客房數量)。 | 5 |
lodging_gbv_local | 十進位(18,4) | 住宿部分的總預訂價值 (以當地貨幣計價)。 | 1379.8 |
lodging_gbv_usd | 十進位(18,4) | 住宿部分的預訂總金額 (以美元計)。 | 1029.9317 |
lodging_gbv_tpid | 十進位(18,4) | 以 TPID 貨幣計價的住宿預訂部分總預訂價值。 | 1029.9317 |
lodging_average_daily_rate_local | 十進位(18,4) | 旅宿 (GBV／住宿天數) 以當地貨幣計算之平均每日房價。 | 275.96 |
lodging_average_daily_rate_usd | 十進位(18,4) | 預訂旅宿的平均每日費率 (GBV / 住宿天數)，單位為美元。 | 205.9863 |
lodging_tpid_currency_code | char(3) | 住宿 TPID 預訂貨幣採用標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
car_supplier_confirmation_code | varchar(100) | 租車公司於預訂時提供的確認碼。 | ABC1234 |
car_business_model | varchar(200) | Booking 汽車零件業務模式 | 無 |
car_vendor_name | varchar(200) | 已預訂的租車公司名稱。 | Hertz |
car_type | varchar(200) | 預訂的車輛類型。 | 2/4 門小型車 |
car_pickup_location_code | char(3) | 取車地點代碼 (通常為機場代碼)，即預訂車輛的取車地點。 | YDF |
car_pickup_location | varchar(200) | 預訂車輛的取車地點。 | 鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場) |
car_dropoff_location_code | char(3) | 預訂車輛的還車地點代碼 (通常為機場代碼)。 | YDF |
car_dropoff_location | varchar(200) | 預訂車輛的還車地點。 | 鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場) |
car_trip_type | varchar(200) | 無論汽車是預訂來回行程或單程行程。 | 來回行程 |
car_rental_day_count | 小整數 | 車輛預訂的天數。 | 7 |
car_count | 小整數 | 已預訂車輛數量。 | 1 |
car_gbv_local | 十進位(18,4) | 以當地貨幣計價的汽車預訂部分總預訂價值。 | 310.8 |
car_gbv_usd | 十進位(18,4) | 汽車預訂部分的總預訂金額 (以美元計)。 | 231.9919 |
car_gbv_tpid | 十進位(18,4) | 以 TPID 貨幣計算的汽車預訂部分總預訂價值。 | 1029.9317 |
car_tpid_currency_code | char(3) | 汽車 TPID 預約貨幣，以標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
activity_offering_name | varchar(200) | 已預訂的目的地服務項目名稱。 | Passions of Paradise Great Barrier Reef |
activity_vendor_name | varchar(200) | 已預訂的目的地服務供應商名稱。 | 維亞托 (第三方) |
activity_vendor_city | varchar(200) | 供應商分支機構所在城市。 | 未知 |
activity_vendor_country_code | char(3) | 供應商分支機構所在國家代碼。 | NZL |
activity_ticket_count | 小整數 | 活動預訂的票數。 | 1 |
activity_gbv_local | 十進位(18,4) | 目的地服務部分的預訂總金額 (以當地貨幣計價)。 | 204.02 |
activity_gbv_usd | 十進位(18,4) | 目的地服務部分的預訂總金額 (以美元計)。 | 152.2878 |
activity_gbv_tpid | 十進位(18,4) | 以 TPID 貨幣計價的預訂中活動部分的總預訂價值。 | 1029.9317 |
activity_tpid_currency_code | char(3) | 活動 TPID 預訂貨幣，以標準國際銀行帳戶號碼 (IBAN) 貨幣代碼格式呈現。 | USD |
loyalty_id | varchar(200) | 忠誠度／會員編號。 | 12345678 |
program_id | varchar(200) | 代表層級資訊 | 6549 |
passenger_name | varchar(200) | 與預訂相關人員姓名 (通常與購買者姓名相同，惟航空公司預訂除外，該類預訂需列出所有持票乘客姓名)。 | 詹姆斯·史密斯 |
purchaser_first_name | varchar(200) | 預訂購買者的名字。 | 詹姆斯 |
purchaser_last_name | varchar(200) | 預訂購買者的姓氏。 | Smith |
purchaser_email_address | varchar(200) | 預訂購買者的電子郵件地址。 | james.smith@email.com |
billing_address | varchar(200) | 訂購者地址 (包括街道、城市、省/州、國家、郵遞區號)。 | 紐約州紐約市第一街 123 號 |
billing_phone_number | varchar(200) | 預訂購買者的電話號碼。 | 10111213141 |
promotional_mail_indicator | char(3) | 個人是否已註冊接收促銷郵件的標示。 | 0 |