File-based 行程配送
合作夥伴入口網站中的行程 API 標準報告包括 transaction-level 預訂，無論是僅針對住宿還是針對多個業務線 (LOB)。使用我們的標準報告意味著您可以快速獲取數據，而無需額外的開發時間。
行程 API 的報告是在交易層級製作的，並為住宿提供了 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 | 字元 (3) | 支付預訂的貨幣，以標準國際銀行帳號 (IBAN) 貨幣代碼格式表示。 | USD |
gbv_local | 十進制 (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 | 字元 (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 |
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 | 字元 (3) | 航班出發/出發的機場代碼。 | YYZ |
airport_origin_location | varchar(406) | 航班出發/始發地點。 | 加拿大安大略省多倫多 |
airport_destination_code | 字元 (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 | 十進制 (18,4) | 以當地貨幣計算的航空部分預訂總預訂價值。 | 694.8941 |
air_gbv_usd | 十進制 (18,4) | 航空部分預訂的總預訂價值 (以美元計)。 | 694.8941 |
air_gbv_tpid | 十進制 (18,4) | 以 TPID 貨幣表示的預訂航空部分的總預訂價值。 | 694.8941 |
air_tpid_currency_code | 字元 (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) | 住宿預訂部分的商業模式。 | 旅宿 |
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) | 已預訂房產所在的市場。 | 以色列國防軍—法國巴黎 |
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 | 十進制 (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 | 字元 (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 | 字元 (3) | 預訂車輛的取車地點代碼 (通常是機場代碼)。 | 鹽電集團 |
car_pickup_location | varchar(200) | 預訂車輛的取車地點。 | 鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場) |
car_dropoff_location_code | 字元 (3) | 預訂車輛的下車地點代碼 (通常是機場代碼)。 | 鹽電集團 |
car_dropoff_location | varchar(200) | 預訂車輛的還車地點。 | 鹿湖，紐芬蘭與拉布拉多 (YDF-鹿湖地方機場) |
car_trip_type | varchar(200) | 預訂的汽車是往返還是單程。 | 來回行程 |
car_rental_day_count | smallint | 預訂車輛的天數。 | 7 |
car_count | smallint | 已預訂的車輛數量。 | 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 | 字元 (3) | 以標準國際銀行帳號 (IBAN) 貨幣代碼格式表示的汽車 TPID 預訂貨幣。 | USD |
activity_offering_name | varchar(200) | 預訂的目的地服務活動的名稱。 | Passions of Paradise Great Barrier Reef |
activity_vendor_name | varchar(200) | 預訂的目的地服務供應商的名稱。 | 旅行者 (3P) |
activity_vendor_city | varchar(200) | 供應商分支機構所在的城市。 | 未知 |
activity_vendor_country_code | 字元 (3) | 供應商分支機構所在的國家/地區代碼。 | NZL |
activity_ticket_count | smallint | 活動預訂的門票數量。 | 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 | 字元 (3) | 活動 TPID 預訂貨幣以標準國際銀行帳號 (IBAN) 貨幣代碼格式表示。 | USD |
loyalty_id | varchar(200) | 忠誠度/會員 ID 號碼。 | 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 | 字元 (3) | 指示個人是否已註冊接收促銷郵件。 | 0 |