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) | 预订的目的地服务活动的名称。 | 乘坐激情天堂号游览大堡礁 |
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) | 购买预订者的姓氏。 | 史密斯 |
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 |