Developer Hub
This is an auto-generated translation

行程安排的 API 交付

通过行程，您可以显示客户的预订信息并帮助他们找到 booking-related 产品或服务，例如旅游或体验。您还可以使用数据来分析预订趋势并为利益相关者创建报告。

送货选项

您的行程数据 API 传送可以使用推送或拉取机制。

Push 机制

推送服务旨在在 near-real 时间内发送行程更新，重点关注核心 transaction-level 细节。此选项允许您：

  • 在您的网站或应用程序上显示客户的预订信息
  • 为您的客户提供旅行所需的额外产品和服务

推送事件将通过 Webhook 以 HTTP POST消息的格式传送到您提供的 URL。这些消息可能无序到达，因此请参考 creation_date和 update_date_time元素来确定顺序。

有关如何采用此传送选项的详细信息，请参阅API 设置。

Pull 机制

拉取服务提供详细的行程数据以支持：

  • 数据分析
  • 推送失败的时间窗口数据检索
  • 服务台调查

此服务由两个 HTTP GET端点组成，可让您：

  • 使用 creation_date_start、creation_date_end、update_date_time_start 和 update_date_time_end变量创建在指定时间范围内创建或更新的行程列表
  • 通过其检索特定行程 itinerary_id

有关身份验证过程的详细信息，请参阅API 设置。

可用字段

下表列出了通过我们的 Push 和 Pull 交付方式提供的字段，包括所有嵌套对象。

字段名称以名称开头，后跟英文句号（例如，<variable>.<nested variable>），表示嵌套关系。

白标模板

字段名称定义示例
itinerary_id行程编号或销售网站订单参考编号。72622069245694
status行程及其各项的状态。可能的值：
已确认
已取消
creation_date*最初预订的日期，以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-05
update_date_time*行程的最后更新日期和时间，以 ISO 8601 日期格式表示（YYYY-MM-dd'T"HH:mm:ss.SSSZ）。2023-10-21T00:00:00.000Z
online指示行程是在线预订（true）还是通过代理预订（false）。用布尔值表示。true
package指示行程是套餐的一部分还是独立预订。用布尔值表示。false
payment_type付款时使用的付款方式。可能的值：
信用卡
积分
分期付款
point_of_sale_country_code客户进行预订的销售网站的国家/地区代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。GB
purchaser预订人的身份证明。请参见 purchaser 表，获取嵌套项列表。 
property_booking_items作为行程的一部分预订的住宿组成部分。请参见 property_booking_items 表，获取嵌套项列表。 
flight_booking_items作为行程的一部分预订的机票组成部分。请参见 flight_booking_items 表，获取嵌套项列表。 
car_booking_items作为行程的一部分预订的租车组成部分。请参见 car_booking_items 表，获取嵌套项列表。 
activity_booking_items作为行程的一部分预订的活动组成部分。请参见 activity_booking_items 表，获取嵌套项列表。 
insurance_booking_items作为行程的一部分预订的保险组成部分。请参见 insurance_booking_items 表，获取嵌套项列表。 
rate预订项目或整个行程的价格和定价详情。请参见 rate 表，获取嵌套项列表。 
coupon适用于行程的优惠券（如适用）。请参见 coupon 表，获取嵌套项列表。 
|

预订人

以下字段可识别预订人。

字段名称定义示例
purchaser.email**预订人的邮箱地址。smith@example.com
purchaser.loyalty_id**会员计划会员身份标识符。12345678
purchaser.first_name**预订人的名字。简
purchaser.last_name**预订人的姓氏。史密斯

property_booking_items

这些字段列出了作为行程的一部分预订的住宿组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882912
status特定住宿元素的状态。可能的值：
已确认
已取消
checkin_date*相应住宿元素的入住日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-01
checkout_date*相应住宿元素的退房日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-05
property.idExpedia Group 的酒店或度假租赁物业的唯一标识符。1400882912
property.chain_name住宿所属连锁酒店的名称（如适用）。独立
property.brand_name住宿所属品牌的名称（如适用）。一个连锁酒店可能有多个品牌。萨沃伊特色酒店
property.name酒店或度假短租屋的名称。酒店 1
property.city住宿所在城市的名称。多伦多
property.state_province_name住宿所在州或省的名称。安大略
property.country_code住宿所在国家/地区的代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
property.star_rating住宿的星级。3.0
room_name预订房间的类型，由酒店或度假租赁公司定义。Comfort 双人间，设有私人浴室
adult_count相应预订中包含的成人人数。2
child_count相应预订中包含的儿童人数。0
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。true
property_confirmation_id***酒店或度假租赁公司提供的确认号码。1516171819
rate住宿预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

flight_booking_items

这些字段列出了作为行程的一部分预订的机票组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882911
status特定机票行程元素的状态。可能的值：
已确认
已取消
departure_date*相应的机票行程元素的开始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-01
arrival_date*相应的机票行程元素的结束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-02
airline.plating_carrier_name签发机票的航空公司名称。加拿大航空
airline.plating_carrier_code签发机票的航空公司的国际航空运输协会 (IATA) 代码。AC
carrier_pnr签发机票的航空公司记录的乘客姓名。SMITH
trip_type预订的行程的类型。可能的值：
单程
往返
多个目的地
fare_class机票的票价等级。经济型
airport_origin_code出发机场的 IATA 代码。LHR
airport_origin_location始发机场的位置。英国伦敦（LHR - 希思罗机场）
airport_destination_code到达机场的代码。以 IATA 格式表示。YYZ
airport_destination_location到达机场的位置。安大略省多伦多（YYZ - 莱斯特-皮尔逊国际机场）
ticket_number航班机票号码。123456789
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。true
segment_count航班机票的航段数。1
rate航班预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

car_booking_items

这些字段列出了作为行程的一部分预订的租车组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882910
status特定租车行程元素的状态。可能的值：
已确认
已取消
pickup_date*租车行程元素的开始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-02
return_date*租车行程元素的结束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-05
rental_company.name***租车公司的名称。Hertz
car_type***租车的类型。2/4 门紧凑型
pickup_location取车地点。荷兰鹿湖（YDF - 鹿湖地区机场）
pickup_country_code***取车地点的国家/地区代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
return_location还车地点。荷兰鹿湖（YDF - 鹿湖地区机场）
return_country_code***还车地点的国家/地区代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
trip_type预订的行程的类型。可能的值：
单程
往返
多个目的地
rental_company_confirmation_id***汽车租赁公司提供的确认号码。ABC1234
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。false
rate租车预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

activity_booking_items

这些字段列出了作为行程的一部分预订的活动组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882910
status特定活动的状态。可能的值：
已确认
已取消
activity_start_date*活动的开始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-03
activity_end_date*活动的结束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-03
vendor.name***提供活动的供应商的名称。奥利维亚之旅
vendor.city***活动供应商所在的城市。荷兰鹿湖（YDF - 鹿湖地区机场）
vendor.country_code***活动供应商所在国家/地区的代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
offering_name***活动的名称乘坐激情天堂号游览大堡礁
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。true
rate活动预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

insurance_booking_items

这些字段列出了作为行程的一部分预订的保险组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882610
status所选特定保险的状态。可能的值：
已确认
已取消
rate所选保险的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

价格

这些字段列出了预订项目或整个行程的价格和定价详情。它们包括描述预订货币价值的嵌套值，按预订总价值和税费细分。

字段名称定义示例
rate_plan_name用于项目定价的房价计划的名称。仅适用于物业预订项目。仅含客房
rate_plan_type预订时使用的价格的类型。仅适用于物业预订项目。分销价
refundable相应的预订组件是否可以退款（true）或不可退款（false）。true
pricing对象捕获预订的货币价值，按预订总价值和税费细分。 
pricing.gross_booking_value捕获预订货币价值的对象。 
pricing.gross_booking_value.billable_currency表示用于支付的货币的预订货币价值的对象。 
pricing.gross_booking_value.billable_currency.currency客户为预订付款时使用的货币。以 ISO 4217 格式表示。GBP
pricing.gross_booking_value.billable_currency.value总预订价值。2520.80
pricing.taxes_and_fees预订的税费的价值和币种。 
pricing.taxes_and_fees.billable_currency预订的税费的货币价值，以付款时使用的货币表示。 
pricing.taxes_and_fees.billable_currency.currency客户为预订付款时使用的货币。以 ISO 4217 格式表示。GBP
pricing.taxes_and_fees.billable.currency.value预订的总价值。491.10

优惠券

字段名称定义示例
code***预订时使用的优惠码。ABCD
name***优惠券名称。PRIME
description***优惠券说明。BoGo 5%
currency***应用优惠券价值的货币。以 ISO 4217 格式表示。GBP
value***优惠券的货币价值。126.04

所有白标模板字段的注释

* 日期字段采用协调世界时 (UTC)。
** 这代表个人身份信息 (PII) 数据。请务必按照贵公司的指导原则正确处理此内容。请仅在绝对必要时包括此信息。
*** 这些字段的数据将在预订创建或更新后的第二天下午 6:00 至晚上 8:00 (UTC) 之间提供。目前无法实现近乎实时地提供。

旅行社联盟计划 (TAAP)

字段名称定义示例
itinerary_id行程编号或销售网站订单参考编号。72622069245694
status行程及其各项的状态。可能的值：
已确认
已取消
creation_date*最初预订的日期，以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-05
update_date_time*行程的最后更新日期和时间，以 ISO 8601 日期格式表示（YYYY-MM-dd'T"HH:mm:ss.SSSZ）。2023-10-21T00:00:00.000Z
online指示行程是在线预订（true）还是通过代理预订（false）。用布尔值表示。true
point_of_sale_country_code客户进行预订所在国家/地区的代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。GB
purchaser预订人的身份证明。请参见 purchaser 表，获取嵌套项列表。 
agency识别进行预订的 TAAP 代理机构和代理人。请参见 agency 表，获取嵌套项列表。 
payment行程的付款信息。请参见 payment 表，获取嵌套项列表。 
property_booking_items作为行程的一部分预订的住宿组成部分。请参见 property_booking_items 表，获取嵌套项列表。 
flight_booking_items作为行程的一部分预订的机票组成部分。请参见 flight_booking_items 表，获取嵌套项列表。 
car_booking_items作为行程的一部分预订的租车组成部分。请参见 car_booking_items 表，获取嵌套项列表。 
activity_booking_items作为行程的一部分预订的活动组成部分。请参见 activity_booking_items 表，获取嵌套项列表。 
rate预订项目或整个行程的价格和定价详情。请参见 rate 表，获取嵌套项列表。 
earnings预订项目或整个行程的佣金详情。请参见 earnings 表，获取嵌套项列表。 
|

预订人

这些字段标识了将要旅行的人。

字段名称定义示例
purchaser.email**旅行者的电子邮件地址。smith@example.com
purchaser.first_name**旅行者的名字。简
purchaser.last_name**旅行者的姓氏。史密斯

旅行社

这些字段标识了进行预订的 TAAP 代理商和代理人。

字段名称定义示例
agency.name进行预订的 TAAP 代理商的名称。世界旅行
agency.id进行预订的 TAAP 代理商的跟踪代码。WS02555
agency.agent.first_name**进行预订的 TAAP 代理的名字。Bob
agency.agent.last_name**进行预订的 TAAP 代理的姓氏。Jones
agency.agent.email**进行预订的 TAAP 代理的电子邮件地址。bjones@worldtravel.com

付款

这些字段包含行程的付款详情。

字段名称定义示例
payment_type付款时使用的付款方式。可能的值：
信用卡
个点
分担工资
status表示行程是否已付款。可能的值：
有薪酬的
未付
deferred行程付款是否延期（真）或已付款（假）。用布尔值表示。true
payment_due_date付款到期日 ISO 8601 日期格式 (YYYY-MM-DD)。仅适用于延期付款。2023-02-05
payee指示谁负责支付行程费用。可能的值：
旅行社
顾客

property_booking_items

这些字段列出了作为行程的一部分预订的住宿组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882912
status特定住宿元素的状态。可能的值：
已确认
取消
checkin_date*相应住宿元素的入住日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-01
checkout_date*相应住宿元素的退房日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-05
property.idExpedia Group 为酒店或度假短租住宿提供的唯一标识符1400882912
property.chain_name住宿所属连锁酒店的名称（如适用）。独立
property.brand_name住宿所属品牌的名称（如适用）。一个连锁酒店可能有多个品牌。萨沃伊特色酒店
property.name酒店或度假短租屋的名称。酒店 1
property.city住宿所在城市的名称。多伦多
property.state_province_name住宿所在州或省的名称。安大略
property.country_code住宿所在国家/地区的代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
property.star_rating住宿的星级。3.0
room_name预订房间的类型，由酒店或度假租赁公司定义。Comfort 双人间，设有私人浴室
adult_count预订中包含的成人人数。2
child_count预订中包含的儿童人数。0
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。true
property_confirmation_id***酒店或度假租赁公司提供的确认号码。1516171819
rate住宿预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

flight_booking_items

这些字段列出了作为行程的一部分预订的机票组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882911
status特定机票行程元素的状态。可能的值：
已确认
已取消
departure_date*相应的机票行程元素的开始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-01
arrival_date*相应的机票行程元素的结束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-02
airline.plating_carrier_name签发机票的航空公司名称。加拿大航空
airline.plating_carrier_codeIATA 签发机票的航空公司代码。AC
carrier_pnr签发机票的航空公司记录的乘客姓名。SMITH
trip_type预订的行程的类型。可能的值：
单程
往返
多个目的地
fare_class机票的票价等级。经济型
airport_origin_code出发机场的 IATA 代码。LHR
airport_origin_location始发机场的位置。英国伦敦（LHR - 希思罗机场）
airport_destination_code到达机场的代码。以 IATA 格式表示。YYZ
airport_destination_location到达机场的位置。安大略省多伦多（YYZ - 莱斯特-皮尔逊国际机场）
ticket_number航班机票号码。123456789101
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。true
segment_count机票的航段数。1
rate航班预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

car_booking_items

这些字段列出了作为行程的一部分预订的租车组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882910
status特定租车行程元素的状态。可能的值：
已确认
已取消
pickup_date*租车行程元素的开始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-02
return_date*租车行程元素的结束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-05
rental_company.name***租车公司的名称。Hertz
car_type***租车的类型。2/4 门紧凑型
pickup_location取车地点。荷兰鹿湖（YDF - 鹿湖地区机场）
pickup_country_code***取车地点的国家/地区代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
return_location还车地点。荷兰鹿湖（YDF - 鹿湖地区机场）
return_country_code***还车地点的国家/地区代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
trip_type预订的行程的类型。可能的值：
单程
往返
多个目的地
rental_company_confirmation_id***汽车租赁公司提供的确认号码。ABC1234
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。false
rate租车预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 

activity_booking_items

这些字段列出了作为行程的一部分预订的活动组成部分。

字段名称定义示例
booking_item_id作为行程一部分预订的特定元素的标识符。1400882910
status特定活动的状态。可能的值：
已确认
已取消
activity_start_date*活动的开始日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-03
activity_end_date*活动的结束日期。以 ISO 8601 日期格式表示（YYYY-MM-DD）。2023-02-03
vendor.name***提供活动的供应商的名称。奥利维亚之旅
vendor.city***活动供应商所在的城市。荷兰鹿湖（YDF - 鹿湖地区机场）
vendor.country_code***活动供应商所在国家/地区的代码。采用包含两个字母的 ISO 3166-1 alpha-2 格式。CA
offering_name***活动的名称亨伯河步道徒步旅行
expedia_collect布尔值，表示预订是否已在付款页面支付 (true) 还是必须直接向提供商支付 (false)。true
rate活动预订的价格和定价详情。请参见 rate 表，获取嵌套项列表。 
earnings活动预订项目的佣金详情。请参见 earnings 表，获取嵌套项列表。 

价格

这些字段列出了预订项目或整个行程的价格和定价详情。它们包括描述预订货币价值的嵌套值，按预订总价值和税费细分。

字段名称定义示例
refundable相应的预订组件是否可以退款（true）或不可退款（false）。true
pricing对象捕获预订的货币价值，按预订总价值和税费细分。 
pricing.gross_booking_value包括税费在内的预订的货币价值。 
pricing.gross_booking_value.billable_currency预订的货币价值，以付款时使用的货币表示。 
pricing.gross_booking_value.billable_currency.currency客户为预订付款时使用的货币。以 ISO 4217 格式表示。GBP
pricing.gross_booking_value.billable_currency.value总预订价值。2520.80
pricing.taxes_and_fees预订的税费的价值和币种。 
pricing.taxes_and_fees.billable_currency预订的税费的货币价值，以付款时使用的货币表示。 
pricing.taxes_and_fees.billable_currency.currency客户为预订付款时使用的货币。以 ISO 4217 格式表示。GBP
pricing.taxes_and_fees.billable.currency.value预订的总价值。491.10

收益

字段名称定义示例
commission表示预订或项目的佣金金额的对象，包含在总预订价值中。 
commission.billable_currency表示支付货币中的佣金金额的对象。 
commission.billable_currency.currency佣金价值的货币，以 ISO 4217 格式表示USD
commission.billable_currency.value佣金的货币价值。100.25
service_charge表示 TAAP 代理机构对行程应用的服务费的对象。 
service_charge.amount表示 TAAP 代理机构对行程应用的服务费的货币价值的对象。 
service_charge.amount.billable_currency表示以支付货币表示的服务费价值金额的对象。 
service_charge.amount.billable_currency.currency服务费用的货币，以 ISO 4217 格式表示。USD
service_charge.amount.billable_currency.valueTAAP 代理机构对行程收取的服务费的货币价值。50.50
service_charge.taxes_and_fees表示服务费的税费价值和货币的对象。 
service_charge.taxes_and_fees.billable_currency以支付货币表示服务费的税费的货币价值的对象。 
service_charge.taxes_and_fees.billable_currency.currency付款货币，以 ISO 4217 格式表示。USD
service_charge.taxes_and_fees.billable_currency.value客户支付的税费的金额（以记账货币表示）。5.25

所有 TAAP 字段的注释

* 日期字段采用协调世界时 (UTC)。
** 这代表个人身份信息 (PII) 数据。请务必按照贵公司的指导原则正确处理此内容。请仅在绝对必要时包括此信息。
*** 这些字段的数据将在预订创建或更新后的第二天下午 6:00 至晚上 8:00 (UTC) 之间提供。目前无法实现近乎实时地提供。

API 详情

根据您的业务使用行程 API 数据的方式，我们提供了 API 模式和配置的快照。您可以下载 OpenAPI 规范并使用 API 测试软件来了解示例和模式定义与实际输出的比较情况。

白标模板

通过我们的推拉式交付方法，我们的白标模板合作伙伴可以使用的字段（包括任何嵌套对象）包括：




TAAP

我们的 TAAP 合作伙伴可以通过推拉式交付方法使用的字段（包括任何嵌套对象）如下：




您觉得这个页面有用吗？
我们该如何改进这些内容？
感谢您帮助我们改进！

隐私声明 Cookie 声明 使用条款

Expedia, Inc. 不对外部网站上的内容负责。
© 2024 Expedia, Inc.，Expedia Group 旗下公司。保留所有权利。Expedia 和飞机徽标是 Expedia, Inc. 的商标或注册商标。CST# 2029030-50。