检索现有行程的状态和详情,确认以前请求的预订的状态,或检索指定日期范围内的行程列表。

使用此请求可确认返回状态不是“CF”的预订的状态,并规避重复预订的风险。

请求格式
请求格式
XML/REST URL: GET https://book.api.ean.com/ean-services/rs/hotel/v3/itin?
XML 父元素: <HotelItineraryRequest>

请求参数

基本参数
名称 是否必需 说明
itineraryId 长整型 从以前订单请求返回的值。不能与 affiliateConfirmationId 一起发送。

注意:对于使用 Expedia Partner Central 的酒店,无法使用该值找到行程。使用 EXPEDIA_BOOKING_ITEM_ID confirmationExtras 值返回与 EPC 兼容的值。

affiliateConfirmationId 字符串 如果该元素用于订单请求,则为与订单关联的值。在 itineraryId 不可用时(例如在订单响应超时后)用作替代项。不能与 itineraryId 一起发送。
email 字符串 如果使用 itineraryId 则为 订单上的电子邮件地址。
lastName 字符串 如果使用 creditCardNumber 则为 订单上的姓氏
creditCardNumber 字符串 用于预订的信用卡号码。必须与 lastName 一起发送。
confirmationExtras 数组 指示要在返回的记录中标识的特定跟踪数据元素。除非特别指定,否则默认返回 additionalData1additionalData2
如果请求多个附加数据元素,则为逗号分隔的列表。请参阅跟踪订单页面了解有关在预订请求中发送跟踪数据的更多信息。
ItineraryQuery 对象

使用此对象可根据日期范围请求行程列表。您可以通过行程创建日期或退房日期进行搜索。

注意: 使用此方法可能不会返回同日预订,因为所用的数据表必须与用于单个 itineraryId 请求的数据表不同。用于 ItineraryQuery 的表可能推迟长达一天。

ItineraryQuery.creationDateStart 字符串 通过创建日期进行搜索时的开始日期。搜索最多 30 天以前预订的行程。
ItineraryQuery.creationDateEnd 字符串 如果指定了开始日期,则为 通过创建日期进行搜索时的结束日期。使用一天作为日期范围来返回今天的订单。更长的日期范围将排除今天的订单。
ItineraryQuery.departureDateStart 字符串 通过退房日期进行搜索时的开始日期。搜索住宿结束后最多 30 天内的行程。
ItineraryQuery.departureDateEnd 字符串 如果指定了开始日期,则为 通过退房日期进行搜索时的结束日期。
ItineraryQuery.includeChildAffiliates 布尔型

true 发送可返回属于请求中发送的 cid 的所有子帐户。

行程回复
返回各个行程的所有详情,包括预订的酒店和客房、用于预订客房的客户详细信息以及订单本身的状态。

此回复还可以根据请求中指定的出发日期或创建日期范围返回行程的列表。

使用这些信息可应客户的请求提供其他确认信息,以便在最初返回错误时验证现有订单的状态,或在使用一个日期范围选项时编写内部销售统计信息。

由于此回复会返回客户信息,请通过 HTTPS 提供所有面向用户的数据。
回复内容
父元素: HotelItineraryResponse
数组元素: Itinerary


行程回复在 HotelItineraryResponse 父元素中包含一组 Itinerary。单个行程仅以 Itinerary 单一实例的形式返回。

父元素具有一个 size 属性来指示回复中包含的行程数。

Itinerary 元素

名称 说明
itineraryId 长整型 与订单关联的 ID。仅在依赖 EAN 支持(您没有自己的代理)时提供给客户。
affiliateId 长整型 属于订单的 cid
creationDate 字符串 预订日期
itineraryStartDate 字符串 入住日期
itineraryEndDate 字符串 退房日期
affiliateCustomerId 字符串 下达订单时使用的值(如果适用)
Customer 对象 包含与订单关联的客户的所有信息。在此情况下,客户是创建订单所使用的支付卡的持卡人。
Customer.email 字符串 客户的电子邮件地址
Customer.firstName 字符串 客户的名字
Customer.lastName 字符串 客户的姓氏
Customer.homePhone 字符串 客户的家庭电话
Customer.workPhone 字符串 客户的工作电话(如果已提供)
Customer.extension 字符串 客户的电话分机(如果已提供)
Customer.faxPhone 字符串 客户的传真号码(如果已提供)
Customer.CustomerAddresses 数组 包含客户的地址信息
CustomerAddresses.address1 字符串 客户的街道地址
CustomerAddresses.address2 字符串 街道地址第二行(如果已提供)
CustomerAddresses.address3 字符串 街道地址第三行(如果已提供)
CustomerAddresses.city 字符串 客户所在的城市
CustomerAddresses.stateProvinceCode 字符串 包含指定城市的州/省的双字符代码。仅对 US、CA 和 AU 国家代码返回结果。

参考:
美国州代码
加拿大省/领地代码
澳大利亚省/领地代码
  • 澳大利亚首都 - AC
  • 新南威尔士州 - NW
  • 澳北区 - NO
  • 昆士兰 - QL
  • 南澳大利亚 - SA
  • 塔斯马尼亚岛 - TS
  • 维多利亚州 - VC
  • 西澳大利亚州 - WT
CustomerAddresses.countryCode 字符串 客户所在国家的双字符 ISO-3166 代码。
CustomerAddresses.postalCode 字符串 客户的邮政编码
CustomerAddresses.isPrimary 布尔型 指示是否为客户的主要已知地址
CustomerAddresses.type 整型 值为 1 表示帐单地址,值为 2 表示发货地址。
HotelConfirmation 数组 包含有关预订的客房和酒店的信息,以及行程的当前状态。
HotelConfirmation.supplierId 长整型 用于预订酒店的供应商。
值:
2:Expedia Collect 酒店
9:Expedia Collect 公寓
13:Expedia.com 酒店
HotelConfirmation.chainCode 字符串 酒店连锁代码
HotelConfirmation.creditCardType 字符串 用于创建订单的信用卡类型
HotelConfirmation.arrivalDate 字符串 入住日期
HotelConfirmation.departureDate 字符串 退房日期
HotelConfirmation.confirmationNumber 字符串 下达订单时在预订回复中返回的确认编号。仅在依赖 EAN 支持(您没有自己的代理)时提供给客户。
HotelConfirmation.cancellationNumber 字符串 取消行程时,在取消回复中返回的取消编号
HotelConfirmation.numberOfAdults 整型 为预订确认的成人数
HotelConfirmation.numberOfChildren 整型 为预订确认的儿童数
HotelConfirmation.affiliateConfirmationId 字符串 为订单发送的值(如果有)
HotelConfirmation.smokingPreference 字符串 吸烟偏好(如果已在原始订单上指明)
HotelConfirmation.supplierPropertyId 字符串 供应商酒店 ID,与可订空房回复中的 propertyId 相同
HotelConfirmation.roomType 字符串 所预订客房的房型代码
HotelConfirmation.rateType 字符串 所预订客房的房价类型
HotelConfirmation.rateDescription 字符串 对客房房价的说明。
HotelConfirmation.roomDescription 字符串 客房简短说明。
HotelConfirmation.status 字符串 指示在预订时,供应商系统中的预订状态。为所有非确认值预测适当的客户消息。
CF 已确认
CX 已取消
UC 未确认。
PS 待定供应商。确认编号可用时,代理将跟进客户。
ER 错误。预订永久失败。
DT 已删除行程(通常为测试订单或失败的订单)
HotelConfirmation.locale 字符串 用于下达订单的区域设置
HotelConfirmation.nights 整型 预订的晚数
HotelConfirmation.GenericRefund 对象 包含货币类型和因客户投诉对请求的行程发放的部分信用或扣款金额(并非完全取消的扣款)。在 minorRev=26 或更高版本中提供。
GenericRefund.refundAmount 整型 对行程发放的信用/扣款金额。在 minorRev=26 或更高版本中提供。
GenericRefund.currencyCode 字符串 提供的信用/扣款金额的货币代码。在 minorRev=26 或更高版本中提供。
HotelConfirmation.RateInfos 对象

包含原始预订请求中使用的 RateInfo 对象,另外,还包含原始 nonRefundablecancellationPolicy 值。

HotelConfirmation.ReservationGuest 对象/数组 包含订单上的住客姓名。

对于 statusDTCXPSER 的多间客房订单,JSON 回复将以数组而不是对象的形式返回住客姓名对。
HotelConfirmation.specialCheckInInstructions 字符串 包含有关入住的重要信息,例如需要向酒店通知预期到达时间。将该信息显示在与主要入住说明相同的区域。
ReservationGuest.firstName 字符串 住客名字
ReservationGuest.lastName 字符串 住客的姓氏
HotelConfirmation.Hotel 对象 所预订酒店的信息
Hotel.hotelId 长整型 在预订时与酒店关联的 ID
Hotel.statusCode 字符串 发出行程请求时,EAN 数据库中酒店的当前状态。除 A 之外的任何状态都不可重新预订。
值:
A:活动
I:非活动
D:已删除
R:已移除
C:已确认
Hotel.name 字符串 酒店名称
Hotel.address1 字符串 酒店的街道地址
Hotel.address2 字符串 街道地址第二行(如果已提供)
Hotel.address3 字符串 街道地址第三行(如果已提供)
Hotel.city 字符串 酒店所在的城市
Hotel.stateProvinceCode 字符串 包含指定城市的州/省的双字符代码。仅对 US、CA 和 AU 国家代码返回结果。

参考:
美国州代码
加拿大省/领地代码
澳大利亚省/领地代码
Hotel.countryCode 字符串 客户所在国家的双字符 ISO-3166 代码。
Hotel.postalCode 字符串 酒店的邮政编码
Hotel.phone 浮点型/字符串 酒店电话号码。
避免直接提供给客户,以免酒店不通过 EAN 或您自己的客户服务部门,直接处理由变更或取消引起的客户服务问题。
鼓励客户回复他们的确认电子邮件和/或致电客户服务部门咨询有关其预订的任何问题。
注意:该值可能以浮点型值或字符串的形式返回,具体取决于酒店所采用的格式。
Hotel.fax 字符串 酒店的传真号码
Hotel.latitude 浮点型 酒店的纬度坐标
Hotel.longitude 浮点型 酒店的经度坐标
Hotel.coordinateAccuracyCode 字符串 所提供坐标精确度的代码
Hotel.lowRate 浮点型 酒店的统计低房价
Hotel.highRate 浮点型 酒店的统计高房价
Hotel.hotelRating 浮点型 酒店的星级评定
Hotel.market 字符串 订单应用到的市场,例如洛杉矶。
Hotel.region 字符串 订单应用到的地区,例如加利福尼亚。
Hotel.superRegion 字符串 返回订单应用到的超级地区,例如 AMER。
Hotel.theme 字符串 所预订酒店的主题,例如海滩酒店、SPA 酒店等。
HotelConfirmation.ConfirmationExtras ConfirmationExtra 数组容器 返回通过订单提交的任何请求的跟踪信息。具有 size 属性来指示与订单关联的值数。必须在请求中指定任何自定义值以便返回它们。
ConfirmationExtras.name 字符串 additionalData 项目的名称
ConfirmationExtras.value 字符串 提交的跟踪数据的值
HotelConfirmation.ValueAdds ValueAdd 的容器 包含预订附带的所有增值项目。具有 size 属性,用于指示各个增值项目数。

minorRev=28 或更高版本中提供。
ValueAdds.ValueAdd 数组

包含 description 元素,说明为指定客房和房价提供的各项免费服务,例如免费早餐或无线上网。

minorRev=28 或更高版本中提供。