Developer Hub
This is an auto-generated translation

行程安排的 API 交付

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

送货选项

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

Push 机制

推送服务旨在近乎实时地发送行程更新信息，重点关注核心交易级细节。此选项允许您：

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

推送事件将通过 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预订房间的类型，由酒店或度假租赁公司定义。舒适双人间，设有私人浴室
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预订房间的类型，由酒店或度假租赁公司定义。舒适双人间，设有私人浴室
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航班机票号码。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。