File-based 行程安排交付
合作伙伴门户网站中的行程 API 标准报告包含 transaction-level 预订，无论是仅限住宿还是多个业务线 (LOB)。 使用我们的标准报告意味着您可以快速获取数据，无需额外的开发时间。
行程 API 的报告是在交易级别生成的，并为住宿提供了 60 多个字段的精选列表，以及 100 多个字段的 multi-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) | 住宿预订业务模式。 | 商家 |
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 | 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) | 以当地货币计算的预订房产的平均每日价格（GBV / 入住天数）。 | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | 预订房产的平均每日价格（GBV / 入住天数），以美元计。 | 205.9863 |
lodging_tpid_currency_code | char(3) | 住宿预订货币以标准国际银行账户号码 (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) | 取车地点代码（通常是机场代码）。 | 青年发展基金 |
car_pickup_location | varchar(200) | 取车地点（需预订车辆的地点）。 | 荷兰鹿湖（YDF - 鹿湖地区机场） |
car_dropoff_location_code | char(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 | 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) | 预订的目的地服务活动名称。 | 乘坐激情天堂号游览大堡礁 |
activity_vendor_name | varchar(200) | 已预订的目的地服务供应商名称。 | Viator（3P） |
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) | 会员卡/会员 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 | char(3) | 指示个人是否已注册接收促销邮件。 | 0 |