File-based 行程表的送達
Itineraries API 的標準報告在 合作夥伴入口網站 包含 transaction-level 的預訂，無論是僅限住宿，還是涵蓋多個業務類別 (LOBs)。使用我們的標準報表，您便能迅速取得所需資料，無需額外的開發時間。
Itineraries API 的報表是以交易為單位生成的，其中針對住宿 (Lodging) 提供了超過 60 個精選欄位供選擇，而針對行程 (multi-LOB) 的報表則提供了超過 100 個欄位。可選項目包括：
- 基本預訂資訊，例如旅行日期、行程安排及旅行費用
- 旅客及付款人 (若非同一人) 的客戶資訊
- 產品資訊，例如確認編號、供應商與地點、使用的 LOB 數量，以及相關費用
標準報表的預設欄位
在自訂報表時，有許多欄位可供選擇。這些項目預設已包含在標準報表中。
| 欄位名稱 | 資料類型 | 說明 | 範例 |
|---|---|---|---|
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 | decimal(18,4) | 總預訂金額 (GBV)，即包含稅金及手續費在內的總預訂金額，以實際付款貨幣計算。 | 694.89 |
order_count | smallint | 包裹訂單中的訂單數量 (非商品數量)。 | 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 | decimal(18,4) | 優惠券金額 (美元)。 | -58.6877 |
gbv_usd | decimal(18,4) | 預訂的總預訂金額 (以美元計)。 | 694.8941 |
gbv_tpid | decimal(18,4) | 提供以 TPID 貨幣計價的總 GBV。 | 694.8941 |
taxes_and_fees_local | decimal(18,4) | 以當地貨幣計價的稅金及費用總額。 | 144.77 |
taxes_and_fees_usd | decimal(18,4) | 稅金及費用總額 (以美元計)。 | 144.77 |
taxes_and_fees_tpid | decimal(18,4) | 以 TPID 貨幣計價的總稅費。 | 144.77 |
insurance_gbv_local | decimal(18,4) | 以當地貨幣計價的保險金額。 | 80.4 |
insurance_gbv_usd | decimal(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 | smallint | 預訂中的機票數量 (附詳細檔案，其中預訂項目 ID 通常為 0 或 1)。 | 1 |
air_segment_count | smallint | 航班行程的航段數 (若在預訂項目 ID 層級之上進行彙總，則此數值將為該預訂中所有乘客所有航段的總和)。 | 2 |
air_gbv_local | decimal(18,4) | 預訂中航空部分的總預訂金額 (以當地貨幣計)。 | 694.8941 |
air_gbv_usd | decimal(18,4) | 預訂中航空部分的總預訂金額 (以美元計)。 | 694.8941 |
air_gbv_tpid | decimal(18,4) | 預訂中航空部分的總預訂金額 (以 TPID 貨幣計)。 | 694.8941 |
air_tpid_currency_code | char(3) | TPID 預訂貨幣以標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
total_person_count | 整數 | 預訂中包含的總人數 (僅限住宿部分)。 | 3 |
adult_count | smallint | 預訂中包含的成人人數 (僅限住宿部分)。 | 2 |
child_count | smallint | 預訂中包含的兒童人數 (僅限住宿部分)。 | 1 |
lodging_supplier_confirmation_code | varchar(100) | 由旅宿於預訂時提供的確認碼。 | 1516171819 |
lodging_business_model | varchar(200) | Booking.com 住宿業務的商業模式。 | 旅宿 |
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 | smallint | 在旅宿預訂的房間數。 | 1 |
lodging_room_night_count | smallint | 預訂中的客房住宿晚數 (住宿天數 × 客房計數)。 | 5 |
lodging_gbv_local | decimal(18,4) | 以當地貨幣計價的預訂中，住宿部分的總預訂金額。 | 1379.8 |
lodging_gbv_usd | decimal(18,4) | 預訂中住宿部分的總預訂金額 (以美元計)。 | 1029.9317 |
lodging_gbv_tpid | decimal(18,4) | 以 TPID 貨幣計價的預訂中，住宿部分的總預訂金額。 | 1029.9317 |
lodging_average_daily_rate_local | decimal(18,4) | 以當地貨幣計價的旅宿 (每晚房價／住宿天數) 平均每日價格。 | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | 旅宿的平均每日預訂價格 (按住宿天數計算)，單位為美元。 | 205.9863 |
lodging_tpid_currency_code | char(3) | 住宿 TPID 預訂貨幣，以標準國際銀行帳號 (IBAN) 貨幣代碼格式呈現。 | USD |
car_supplier_confirmation_code | varchar(100) | 租車公司於預訂時提供的確認碼。 | ABC1234 |
car_business_model | varchar(200) | 預訂汽車零件的商業模式。 | 無 |
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 | smallint | 預訂車輛的天數。 | 7 |
car_count | smallint | 已預訂的車輛數量。 | 1 |
car_gbv_local | decimal(18,4) | 預訂中汽車部分的總預訂金額 (以當地貨幣計)。 | 310.8 |
car_gbv_usd | decimal(18,4) | 預訂中汽車部分的總預訂金額 (以美元計)。 | 231.9919 |
car_gbv_tpid | decimal(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) | 已預訂的目的地服務供應商名稱。 | Viator (第三方) |
activity_vendor_city | varchar(200) | 供應商分支機構所在的城市。 | 未知 |
activity_vendor_country_code | char(3) | 供應商分支機構所在地的國家代碼。 | NZL |
activity_ticket_count | smallint | 該活動的預訂票數。 | 1 |
activity_gbv_local | decimal(18,4) | 預訂中「目的地服務」部分的總預訂金額 (以當地貨幣計)。 | 204.02 |
activity_gbv_usd | decimal(18,4) | 預訂中「目的地服務」部分的總預訂金額 (以美元計)。 | 152.2878 |
activity_gbv_tpid | decimal(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 |