预订资源表示SAP Concur Travel系统中的预订部分。TripLink供应商使用此资源显示完整预订字段的子集。

版本

版本1.1

URI

/旅游/预订/ v1.1 / {query_parameters}

范围

为了在进行行程API调用时获取行程数据,必须将OAuth范围参数的值设置为:也就是说

创建或更新预订

创建新的预订或更新现有预订。新的预订将分配给指定的行程,如果没有指定行程,则分配给跨越预订日期的第一个行程。如果没有指定任何行程,并且没有跨越预订日期的行程,则将创建一个新的行程。

这个端点可用于为非OAuth消费者的用户创建/更新预订。当旅游供应商或旅游管理公司需要代表用户创建/更新预订时,通常会这样做。供应商或TMC必须向SAP Concur注册,并且必须具有以下用户角色之一的帐户:Professional的Web Services Administrator或Standard的Can administrtor。

请求

帖子/ api /旅游/预订/ v1.0吗?tripId = 12345678HTTPS/1.1宿主www.concursolutions.com.授权OAuth{访问令牌}

请求参数

查询参数—可选

  • Tripid = {tripid}旅行的唯一标识符。提供,以便为现有之旅添加预订。
  • userid_type = login_id&userid_value = {loginID}拥有预订的用户的SAP Concur登录ID。仅当预订所有者不是OAuth消费者时提供。只能在OAuth使用者具有所需的用户角色时使用。

例子:

https://www.concursolutions.com/api/travel/booking/v1.1?tripId= {tripId}

https://www.concursolutions.com/api/travel/booking/v1.1?userid_type=login_id&userid_value= {loginID}

内容类型

应用程序/ XML

授权头

有效的SAP Concur用户的带有OAuth令牌的授权头。为了为OAuth消费者以外的任何人创建或更新预订,OAuth消费者必须在SAP Concur中具有以下用户角色之一:公司管理员或专业Web服务管理员,或标准管理员。

创建或更新预订请求模式

该请求包含一个Booking父元素和以下子元素:

必需的元素 描述
BookingSource 供应商的名字。
录制器 记录这个预定的定位器。这通常是六个字母数字字符,但根据预订来源可以有其他格式
可选元素 描述
datebookedlocal. 预订的日期是在预订位置的当地时间创建的日期。格式:YYYY-MM-DDTHH:MM:SS
FormOfPaymentName 预订的付款方式的名称。
formofpaymenttype. 付款方式。
TicketMailingAddress. 如果可用的预订票证的邮寄地址。
TicketPickupLocation 预订票的拾取位置(如果有)。
TicketPickupNumber 如果有的话,确认号码拿起预订的票证。
AirfareQuotes 此预订的存储机票报价清单。
AirlineTickets 这笔预订的机票列表。
收费 订舱费用清单。
MiscChargeOrders 杂项列表航空收费这个预订。
乘客 乘客元素包含A.乘客每个被预订的乘客的儿童元素。可以在后续表中看到每个子元素的描述。
译文 此预订的传递程序列表。
phonenumber 与此预订有关的电话号码列表。
RailPayments 本次预订中与铁路段相关的铁路付款清单。
在此预订的段的清单。这个父元素包含一个或多个空气汽车酒店餐厅铁路停车,或事件预订的父元素。参考预订对象元素有关booking元素中包含的子元素的详细信息。
交付 该预订的方法已交付。
WaitListSegments 旅客在此预订中等待的部分。
警告 与预订相关的警告。
WebAddresses 与此预订相关的网站地址列表,如电子邮件、pickup url等

乘客子元素

必需的元素 描述
NameFirst 乘客的名字。
NameLast 乘客的姓。
可选元素 描述
namemiddle. 乘客的中间名。
NamePrefix 旅客姓名的前缀。
NameRemark 有关乘客姓名的其他详细信息。
名称uffix. 旅客的姓名后缀。
NameTitle 旅客的姓名。
TextName 如果与数据库中的名称不同,则在预订工具中输入的用户的全名。
FrequentTravelerProgram 旅客的忠诚度计划

回应

此函数返回全程详细信息,如在响应中记录获取行程细节函数。

如果最终用户更新了一个现有的预订,结果是一个新的确认号码,那么除了将新的预订发送到SAP Concur之外,旧的预订必须被明确地取消。如果之前的预订没有取消,用户将在他们的SAP Concur旅行列表中看到这两个预订。

例子

示例1:XML示例请求

帖子/ api /旅游/预订/ v1.0吗?tripId = 12345678HTTPS/1.1宿主www.concursolutions.com.授权OAuth{访问令牌}...
<预订xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xmlns: xsd =“http://www.w3.org/2001/xmlschema”><段><汽车><供应商>艾尔阿拉莫< >状态香港< StartDateLocal >2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 23 - t12:00:00< / EndDateLocal >< StartDateUtc >2013-12-21T20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 23 - t20:00:00< / EndDateUtc >< ConfirmationNumber >F16726AIUS< / ConfirmationNumber >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< StartCityCode >< / StartCityCode >< EndCityCode >< / EndCityCode >< / StartLocation >< EndLocation >< / EndLocation >E类> < /身体< >C身体< / >< >传播一个> < /传播<空调装置>R< /空调装置>< NumPersons >1< / NumPersons >< NumCars >1< / NumCars >< DiscountCode >4321< DailyRate >35.0000< / DailyRate >< TotalRate >105.0000< / TotalRate >< RateType >D<货币>美元货币> < /汽车> < /< RecordLocator >PANAMA50< / RecordLocator >< BookingSource >阿拉莫< / BookingSource >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< >的乘客乘客> << PassengerKey >0< NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< /预订>

示例2:XML响应成功示例

<行程xmlns =“https://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >KK-CNQ-1M1P6-5HJ< / ClientLocator >TravelSupplier< TripName >西雅图之旅< / TripName ><评论/>< StartDateLocal >2013-12-21T07:25:00< EndDateLocal >2013-12-23T23:59:00< / EndDateLocal >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52EveryGDS< / BookedVia >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012 - 07 - 24 - t19:15:52< / DateBookedLocal ><预订><段><汽车><供应商>艾尔阿拉莫< >状态香港< StartDateLocal >2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 23 - t12:00:00< / EndDateLocal >< StartDateUtc >2013-12-21T20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 23 - t20:00:00< / EndDateUtc >< ConfirmationNumber >F16726AIUS< / ConfirmationNumber >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< StartCityCode >< / StartCityCode >< EndCityCode >< / EndCityCode >< / StartLocation >< EndLocation >< / EndLocation >E类> < /身体< >C身体< / >< >传播一个> < /传播<空调装置>R< /空调装置>< NumPersons >1< / NumPersons >< NumCars >1< / NumCars >< DiscountCode >4321< DailyRate >35.0000< / DailyRate >< TotalRate >105.0000< / TotalRate >< RateType >D<货币>美元货币> < /汽车> < /< RecordLocator >PANAMA50< / RecordLocator >< BookingSource >阿拉莫< / BookingSource >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >TravelSupplier< >的乘客乘客> << PassengerKey >0< NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< /预订>< /行程>

取消预订

取消现有的预订。默认情况下,OAuth消费者应该是预订的所有者。这个端点还可以用来取消OAuth消费者不拥有的预订。当旅行管理公司需要代表用户取消预订时,通常会这样做。TMC必须向SAP Concur注册,并拥有一个SAP Concur帐户,该帐户具有以下用户角色之一:Professional的Web Services Administrator或Standard的Can administrtor。

注意:

  • 预订记录只能由创建它们的预订源更新。SAP Concur在处理请求之前验证源信息。

示例:

https:// {baseUri} / api /旅游/预订/ v1.1 /取消? bookingSource ={供应商}&confirmationNumber = {confnum}

请求

帖子/ api /旅游/预订/ v1.1 /取消吗?bookingSource = {FastTravel} &confirmationNumber = {098765431}HTTPS/1.1宿主www.concursolutions.com.授权OAuth{访问令牌}

请求参数

查询参数-必选

  • 取消吗?bookingSource ={供应商}

取消关键字和供应商的唯一标识符,由SAP Concur在应用程序审查期间配置。预订源必须与与预订相关联的供应商名称相匹配。

  • confirmationNumber = {confnum}

取消预订的确认号码。

示例:https://www.concursolutions.com/api/travel/booking/v1.1/cancel?bookingSource={供应商}&confirmationNumber = {confnum}

查询参数—可选

  • userid_type = login_id&userid_value = {loginID}

拥有预订的用户的SAP Concur登录ID。仅当预订所有者不是OAuth消费者时提供。只能在OAuth使用者具有所需的用户角色时使用。

示例:https://www.concursolutions.com/api/travel/booking/v1.1/cancel ?bookingsource= {supplier} &confirmationnumber= {confnum} &Uture_type =login_id&Userid_value= {loginid}

内容类型

应用程序/ XML

授权头

授权标题必须具有OAUTH令牌的有效SAP Confur用户。OAuth消费者必须使用SAP Confur注册为供应商或TMC,并且必须在SAP Concur中的以下用户角色之一:公司管理员或Web服务管理员专业,或者可以为标准管理。

回应

该函数返回预订对象元素部分中指定的完整预订细节。

如果没有找到预订,函数返回一个HTTP 404错误和以下元素:

状态:此元素包含值:notfound。

例子

示例1:XML示例请求

帖子/ api /旅游/预订/ v1.1 /取消吗?bookingSource = {FastTravel} &confirmationNumber = {098765431}HTTPS/1.1宿主www.concursolutions.com.授权OAuth{访问令牌}

例2:XML成功响应的示例

<汽车><供应商>< >状态香港< StartDateLocal >2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >xsi: nil =“真正的”/>< StartDateUtc >2013-12-21T20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 24 - t20:00:00< / EndDateUtc >< ConfirmationNumber >0987654321< / ConfirmationNumber >1029384756< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >2012 - 07 - 25 - t14:21:35< / DateCancelledUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< UpgradedDateTimexsi: nil =“真正的”/>< IsUpgradeAllowedxsi: nil =“真正的”/>< FrequentTravelerId / >< StartCityCode >< / StartCityCode >< EndCityCode >< / EndCityCode >< / StartLocation >< EndLocation >< / EndLocation >E类> < /身体< >C身体< / >< >传播> < /传播<空调装置>R< /空调装置>< PhoneNumber / >< NumPersonsxsi: nil =“真正的”/>< NumCars >1< / NumCars >< DiscountCode >346660< >指控固定> <<描述>减费<货币>美元货币> < /< >数量0.0000< / >数量xsi: nil =“真正的”/>xsi: nil =“真正的”/>DROPOFFFEE< / SemanticsCode >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><货币>美元货币> < /< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00xsi: nil =“真正的”/>< / SemanticsCode >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >< / RateWithAllowance ><讲话/ >< PerDiemLocation / >汽车> < /

另请参阅

旅行资源